| Port variant | v12 |
| Summary | URL manipulation made simple (3.12) |
| Package version | 2.1.4 |
| Homepage | https://github.com/gruns/furl |
| Keywords | python |
| Maintainer | Python Automaton |
| License | Not yet specified |
| Other variants | v13 |
| Ravenports | Buildsheet | History |
| Ravensource | Port Directory | History |
| Last modified | 22 MAR 2025, 15:13:13 UTC |
| Port created | 02 FEB 2018, 15:29:04 UTC |
| single | [image][image] [image] [image] [image] ## furl is a small Python library that makes parsing andmanipulating URLs easy. Python's standard [urllib] and [urlparse] modules provide a number of URL related functions, but using these functions to perform common URL operations proves tedious. Furl makes parsing and manipulating URLs easy. Furl is well tested, [Unlicensed] in the public domain, and supports Python 3 and PyPy3. 👥 Furl is looking for a lead contributor and maintainer. Would you love to lead furl, and making working with URLs a joy for everyone in Python? Please [reach out] and let me know! 🙌 Code time: Paths and query arguments are easy. Really easy. ```python >>> from furl import furl >>> f = furl('http://www.google.com/?one=1&two=2') >>> f /= 'path' >>> del f.args['one'] >>> f.args['three'] = '3' >>> f.url 'http://www.google.com/path?two=2&three=3' ``` Or use furl's inline modification methods. ```python >>> furl('http://www.google.com/?one=1').add({'two':'2'}).url 'http://www.google.com/?one=1&two=2' >>> furl('http://www.google.com/?one=1&two=2').set({'three':'3'}).url 'http://www.google.com/?three=3' >>> furl('http://www.google.com/?one=1&two=2').remove(['one']).url 'http://www.google.com/?two=2' ``` Encoding is handled for you. Unicode, too. ```python >>> f = furl('http://www.google.com/') >>> f.path = 'some encoding here' >>> f.args['and some encoding'] = 'here, too' >>> f.url 'http://www.google.com/some%20encoding%20here?and+some+encoding=here,+too' >>> f.set(host=u'ドメイン.テスト', path=u'джк', query=u'☃=☺') >>> f.url 'http://xn--eckwd4c7c.xn--zckzah/%D0%B4%D0%B6%D0%BA?%E2%98%83=%E2%98%BA' ``` Fragments also have a path and a query. ```python >>> f = furl('http://www.google.com/') >>> f.fragment.path.segments = ['two', 'directories'] >>> f.fragment.args = {'one': 'argument'} >>> f.url 'http://www.google.com/#two/directories?one=argument' ``` ## Installation Installing furl with pip is easy. ``` $ pip install furl ``` ## API * [Basics] * [Scheme, Username, Password, Host, Port, Network Location, and Origin] * [Path] * [Manipulation] * [Query] * [Manipulation] * [Parameters] * [Fragment] * [Encoding] * [Inline manipulation] * [Miscellaneous] ### Basics |
| Build (only) |
python312:dev:std python-pip:single:v12 autoselect-python:single:std |
| Build and Runtime | python312:primary:std |
| Runtime (only) |
python-six:single:v12 python-orderedmultidict:single:v12 |
| main | mirror://PYPIWHL/61/8c/dce3b1b7593858eba995b2dfdb833f872c7f863e3da92aab7128a6b11af4 |
| No other ports depend on this one. |