imurl 0.0.2

`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. It aims to maximise simplicity and ease of use, with support for a wide range of URL schemes.

Examples

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 can be considered unstable:

pip install imurl