Interface to RFC3986 Universal Resource Indicator.
class URI( [path], [decode] )
fragment | Fragment string in the uri (following path and query after a '#'). |
host | Host specificator. |
path | Path specificator. |
port | Optional port specificator (following the host after a ':'). |
query | Query string in the URI. |
scheme | URI scheme. |
uri | Complete URI. |
userInfo | User, password or account specification preceding '\@' host. |
decode() | Decode a string to from URL encoding (static). |
encode() | Encode a string to URL encoding (static). |
getFields() | Returns fields contained in the query element into a dictionary. |
setFields() | Sets query fields for this uri. |
toString() | Returns a string representing this URI. |
class URI( [path], [decode] )
path | The URI that will be used as initial data. |
decode | True if the path is URI encoded, and must be decoded (default). |
Interface to RFC3986 Universal Resource Indicator.
This class offers an object oriented interface to access URI elements.
Setting the properties in this class immediately reflects on the related fields; for example setting the value of the uri property causes a complete re-parse of the item; setting a field as the query string will cause the uri to change.
Each update is subject to RFC3986 compliance checks, and will raise a ParseError if conformance of the URI object is broken.
Fragment string in the uri (following path and query after a '#').
Host specificator.
Path specificator.
Optional port specificator (following the host after a ':').
Query string in the URI.
URI scheme.
Complete URI.
User, password or account specification preceding '\@' host.
Decode a string to from URL encoding (static).
URI.decode( enc_string )
enc_string | The URI/URL encoded string. | ||
Returns: | The decoded string. | ||
Raises: |
|
Encode a string to URL encoding (static).
URI.encode( string )
string | The string to be encoded. |
Returns: | the URL/URI encoded string. |
Returns fields contained in the query element into a dictionary.
URI.getFields( )
Returns: | The fields as a dictionary of nil if the query part contains no element. | ||
Raises: |
|
Sets query fields for this uri.
URI.setFields( fields )
fields | A dictionary of fields or nil to clear the query. | ||
Raises: |
|
Returns a string representing this URI.
URI.toString( )
Returns: | An URI encoded string containing a valid URI. |
Renders the URI into a valid string representation.