URLObject 0.2

URLObject is an utility class for manipulating URLs.<br /><br />Example Usage:<br /><br />Here is how you use the library:<br /><br />>>> from urlobject import URLObject<br />>>> url = URLObject(host='example.com')<br />>>> print url<br />http://example.com/<br />>>> print url / 'some' / 'path'<br />http://example.com/some/path<br />>>> print url & ('key', 'value')<br />http://example.com/?key=value<br />>>> print url & ('key', 'value') & ('key2', 'value2')<br />http://example.com/?key=value&key2=value2<br />>>> print url * 'fragment'<br />http://example.com/#fragment<br />>>> print url / u'N{LATIN SMALL LETTER N WITH TILDE}'<br />http://example.com/?*A*<br />>>> url<br /><br />>>> new_url = url / 'place'<br />>>> new_url<br /><br />>>> new_url &= 'key', 'value'<br />>>> new_url<br /><br />>>> new_url &= 'key2', 'value2'<br />>>> new_url<br /><br />>>> new_url |= 'key', 'newvalue'<br />>>> new_url<br /><br /><br />Important points to note<br /><br /> * URLObjects are completely unicode-aware (they subclass unicode). This also means that international hostnames will be encoded to IDNA format, and international characters in pathnames will be automatically escaped. You should continue using unicode values for everything; the various components will be en/decoded on-the-fly.<br /> * url & (key, value) adds key=value to URL, even if key is already present as a query parameter. This allows you to have multiple appearances of key in the query.<br /> * url | (key, value) adds key=value to URL, removing any previous appearance of key in the query parameters.<br /> * url & dictionary and url | dictionary work similarly to their (key, value) counterparts, only they add every key, value pair in the dictionary to the query string. You can also pass in a list of key, value pairs.<br /> * url / 'path' adds 'path' to the current path, quoting special characters if necessary.<br /> * url // 'path' sets the path to 'path', removing the current path if present.<br /> * url * 'fragment' sets the fragment to 'fragment'.<br /> * url ^ 123 sets the port number to 123.<br /> * url.with_*(value) can be done with scheme, host, port, path, query and fragment, returning a new URL object with the value in that place.<br /> * url.without_port(), url.without_path(), url.without_query() and url.without_fragment() all exist and do something obvious.<br /> * Operations return a new URL object (URL objects are immutable).<br /><br />Hints and tips<br /><br /> * If a URL's scheme is 'http' and you try to set the port to 80, it is equivalent to not specifying the port (same goes for 'https', 'ftp' and 'ftps' for their appropriate ports).<br /> * If you need to end the path with '/', you can do either url / '' or url / 'last_component/'.<br /> * The query parameters are available as a list through the query_list() method and as a dictionary via query_dict(). By default, the latter method will return a dictionary with lists as the values, corresponding to potential multiple occurrences of the same key. You can just take the last value by passing the seq=False keyword argument to the method.<br /> * Since URLObject subclasses directly from Python's built-in unicode, you can pass URL objects straight into urllib2.urlopen(), JSON serializers, templating systems, etc. If you need a plain-old string or Unicode object, you can just call str or unicode on it.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Characters,  Current,  Dictionary,  Gtgtgtgt,  International,  Method,  Object,  Parameters,  Present,  Print,  Query,  Unicode,  Url,  Urllt,  Values
Users rating:	0/10