Interface to RFC3986 Universal Resource Indicator.
class URI( [path], [decode] )
| init | Interface to RFC3986 Universal Resource Indicator. |
| 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. |
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.
Interface to RFC3986 Universal Resource Indicator.
init 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). | ||
| Raises: |
|
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: |
|