Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

(DONT USE) parse resource indicators (URL) into basic components

Project Description


DON’T USE THIS. It has been rolled into internet:

The version in py-internet has better support for non-iauthority IRIs, ie “” URLs, and relative IRIs, “//”.


riparse is a small project to parse resource indicators. It differs from the built-in urlparse module by breaking the resource indicator down even further(parsing netloc, path, and query), and by guaranteeing consistency when a parsed indicator is then serialized again(Split RIs make the distinction as to whether any part of the indicator is missing or present). For example:

>>> import urlparse
>>> urlparse.urlunsplit(urlparse.urlsplit(''))

Note that the ‘?’ is now missing. While it is likely that this is allowed as the query part was empty, it is not always desirable to just forget. And that’s why this module is called “riparse”, “Resource Indicator”, as it isn’t about standard compliance; it’s about flexibility and consistency.

It’s primarily geared toward http type indicators as opposed to true URL/URI/IRI in general as the format used by http is likely to be the most prolific, but it is not strict.



>>> import riparse as ri
>>> ri.parse('http://[::1]:8080/path?param=val&param=val2')
{'path': ['path'], 'host': '[::1]', 'scheme': 'http', 'port': '8080', 'query': [('param', 'val'), ('param', 'val2')]}
>>> ri.parse('http://host/path?param=val#frag')
{'fragment': 'frag', 'path': ['path'], 'host': 'host', 'scheme': 'http', 'query': [('param', 'val')]}
>>> ri.parse('http://host/path?param=val#')
{'fragment': '', 'path': ['path'], 'host': 'host', 'scheme': 'http', 'query': [('param', 'val')]}
>>> ri.parse('http://host/path?param=val&param=val2')
{'path': ['path'], 'host': 'host', 'scheme': 'http', 'query': [('param', 'val'), ('param', 'val2')]}
>>> ri.parse('http://host:8080/path?param=val&param=val2')
{'path': ['path'], 'host': 'host', 'scheme': 'http', 'port': '8080', 'query': [('param', 'val'), ('param', 'val2')]}


>>> import riparse as ri
>>> ri.serialize({'user': 'jwp', 'host': 'localhost', 'path' : ['home','jwp']})
>>> ri.serialize({'user': 'jwp', 'host': 'localhost', 'path' : ['home','jwp']})
>>> ri.serialize({'scheme': 'file', 'user': 'jwp', 'host': 'localhost', 'path': ['home','jwp']})

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(4.7 kB) Copy SHA256 Hash SHA256
Source Mar 15, 2009
(203.4 kB) Copy SHA256 Hash SHA256
any Windows Installer Mar 15, 2009

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting