Python in a Nutshell

Name

urljoin

Synopsis

urljoin(base_url_string,relative_url_string)

Returns a URL string u, obtained by joining relative_url_string, which may be relative, with base_url_string. The joining procedure that urljoin performs to obtain its result u may be summarized as follows:

• When either of the argument strings is empty, u is the other argument.

• When relative_url_string explicitly specifies a scheme different from that of base_url_string, u is relative_url_string. Otherwise, u’s scheme is that of base_url_string.

• When the scheme does not allow relative URLs (e.g., mailto), or relative_url_string explicitly specifies a location (even when it is the same as the location of base_url_string), all other components of u are those of relative_url_string. Otherwise, u’s location is that of base_url_string.

• u’s path is obtained by joining the paths of base_url_string and relative_url_string according to standard syntax for absolute and relative URL paths. For example:

  import urlparse
  urlparse.urljoin(
      'http://somehost.com/some/path/here',
      '../other/path')
  # Result is: 'http://somehost.com/some/other/path'