Hyperlink API¶
Creation¶
Before you can work with URLs, you must create URLs.
Parsing Text¶
If you already have a textual URL, the easiest way to get URL objects
is with the parse()
function:
By default, parse()
returns an instance of
DecodedURL
, a URL type that handles all encoding for you, by
wrapping the lower-level URL
.
The Encoded URL¶
The lower-level URL
looks very similar to the
DecodedURL
, but does not handle all encoding cases for
you. Use with caution.
Note
URL
is also available as an alias,
hyperlink.EncodedURL
for more explicit usage.
Transformation¶
Once a URL is created, some of the most common tasks are to transform it into other URLs and text.
Query Parameters¶
CRUD operations on the query string multimap.
Attributes¶
URLs have many parts, and URL objects have many attributes to represent them.
Low-level functions¶
A couple of notable helpers used by the URL
type.