imurl 0.0.3

imurl is an immutable URL library, written in modern Python.

imurl is inspired by both purl and Python's pathlib and datetime modules. It aims to provide a simple, immutable data structure to represent URL structures, with support for a wide range of URL/URI schemes.

Examples

Here are some quick examples for imurl. There are more in the documentation..

URLs can be created from URL strings, and have the attributes you'd expect:

>>> from imurl import URL
>>> u = URL("https://example.com")
>>> u
imurl.URL('https://example.com')
>>> u.host
'example.com'
>>> u.scheme
'https'

URLs are immutable, but components can be replaced similarly to datetime/pathlib objects:

>>> u.replace(path="/some/path")
imurl.URL('https://example.com/some/path')
>>> u.path  # This is still `None` - we haven't modified `u`.
>>> u.replace(path="/some/path").path_as_posix
PurePosixPath('/some/path')

URLs can also be built from components, and query/path parameters can be set/get/deleted:

>>> u = URL(scheme="https", host="google.com", path="/search")
imurl.URL('https://google.com/search')
>>> u2 = u.set_query("q", "a+search+term")
>>> u2
imurl.URL('https://google.com/search?q=a+search+term')
>>> u2.delete_query("q")
imurl.URL('https://google.com/search')

Installation

imurl can be installed with pip, and has been tested on Python 3.7. imurl is still alpha software, and should be considered unstable:

pip install imurl