2017-03-25 03:22:10 +02:00
|
|
|
# Hyperlink
|
|
|
|
|
|
|
|
*Cool URLs that don't change.*
|
|
|
|
|
2017-04-22 11:12:58 +03:00
|
|
|
<a href="https://hyperlink.readthedocs.io/en/latest/"><img src="https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat"></a>
|
|
|
|
<a href="https://pypi.python.org/pypi/hyperlink"><img src="https://img.shields.io/pypi/v/boltons.svg"></a>
|
|
|
|
<a href="http://calver.org"><img src="https://img.shields.io/badge/calver-YY.MINOR.MICRO-22bfda.svg"></a>
|
|
|
|
|
2017-03-25 03:22:10 +02:00
|
|
|
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, and PyPy.
|
|
|
|
|
2017-04-22 11:12:58 +03:00
|
|
|
Full documentation is available on [Read the Docs](http://hyperlink.readthedocs.io/en/latest/).
|
2017-03-25 03:22:10 +02:00
|
|
|
|
|
|
|
## 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!
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
|
|
|
from hyperlink import URL
|
|
|
|
|
|
|
|
url = URL.from_text('http://github.com/mahmoud/hyperlink?utm_souce=README')
|
|
|
|
utm_source = url.get('utm_source')
|
|
|
|
better_url = url.replace(scheme='https')
|
|
|
|
user_url = better_url.click('..')
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
See the full API docs [here](#).
|
|
|
|
|
|
|
|
## 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.
|