1b1e12a62e
* master: (24 commits) Remove W504 Add Glyph's text for #112. Note changes since 19.0.0 Apply black to setup.py also Run black-reformat Couple more cleanup bits Ignore /htmldocs [requires.io] dependency update [requires.io] dependency update Spiff up the tox config a bit more There is no requirements-test.txt file in the source tree. Archor a few paths to the root of the source tree. Minor re-ordering. per CR: rephrase gibberish test docstring per CR: add https:/, enumerate the cases per CR: match __init__ match __init__ doc per CR: explain in much more detail <79 per CR: make the test a little more thorough, improve docstring fix up inconsistencies in parsing & textual representation of 'rooted' and 'uses_netloc' ... # Conflicts: # .gitignore # MANIFEST.in # tox.ini |
||
|---|---|---|
| docs | ||
| src/hyperlink | ||
| .appveyor.yml | ||
| .coveragerc | ||
| .gitignore | ||
| .travis.yml | ||
| CHANGELOG.md | ||
| LICENSE | ||
| MANIFEST.in | ||
| README.md | ||
| TODO.md | ||
| pyproject.toml | ||
| pytest.ini | ||
| setup.cfg | ||
| setup.py | ||
| tox.ini | ||
README.md
Hyperlink
Cool URLs that don't change.
Hyperlink provides a pure-Python implementation of immutable URLs. Based on RFC 3986 and 3987, the Hyperlink URL makes working with both URIs and IRIs easy.
Hyperlink is tested against Python 2.7, 3.4, 3.5, 3.6, 3.7, 3.8, and PyPy.
Full documentation is available on Read the Docs.
Installation
Hyperlink is a pure-Python package and requires nothing but Python. The easiest way to install is with pip:
pip install hyperlink
Then, hyperlink away!
from hyperlink import URL
url = URL.from_text(u'http://github.com/python-hyper/hyperlink?utm_source=README')
utm_source = url.get(u'utm_source')
better_url = url.replace(scheme=u'https', port=443)
org_url = better_url.click(u'.')
See the full API docs on Read the Docs.
More information
Hyperlink would not have been possible without the help of Glyph Lefkowitz and many other community members, especially considering that it started as an extract from the Twisted networking library. Thanks to them, Hyperlink's URL has been production-grade for well over a decade.
Still, should you encounter any issues, do file an issue, or submit a pull request.