imurl 0.2.0

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

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.8. imurl is still alpha software, and should be considered unstable:

pip install imurl