Cool URLs that don’t change.
Hyperlink provides a pure-Python implementation of immutable URLs. Based on RFC 3986 and RFC 3987, the Hyperlink URL balances simplicity and correctness for both URIs and IRIs.
Hyperlink is tested against Python 2.7, 3.4, 3.5, 3.6, 3.7, 3.8, and PyPy.
For an introduction to the hyperlink library, its background, and URLs in general, see this talk from PyConWeb 2017 (and the accompanying slides).
Installation and Integration¶
Hyperlink is a pure-Python package and only depends on the standard library. The easiest way to install is with pip:
pip install hyperlink
Then, URLs are just an import away:
import hyperlink url = hyperlink.parse(u'http://github.com/python-hyper/hyperlink?utm_source=readthedocs') better_url = url.replace(scheme=u'https', port=443) org_url = better_url.click(u'.') print(org_url.to_text()) # prints: https://github.com/python-hyper/ print(better_url.get(u'utm_source')) # prints: readthedocs
See the API docs for more usage examples.
Found something missing in hyperlink? Pull Requests and Issues are welcome!
Table of Contents¶
- Hyperlink Design
- Hyperlink API