---
id: pyuri
version: "0.3.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pyuri — Better URI Handling

License: permissive · Maintenance: abandoned · Downloads: 74.9K/mo

## What it is and what it does

PyURI is a lightweight library for working with URIs as structured objects rather than strings. It lets you parse a URI into its components (scheme, host, port, path, query, fragment), construct URIs from individual parts, modify them, and compare them for equality. It also provides a helper to extract query parameters into a dictionary, handling repeated keys and URL decoding.

The package has no runtime dependencies and installs as a pure-Python wheel, making it quick to add to any project. However, it has been unmaintained since its single release in March 2017, with no updates for Python 3.7 and later versions. It was tested only with Python 2.7 and 3.6, so compatibility with modern Python is unknown.

Use it for:

- Parse a URI string into its component parts for inspection or validation in a web application.
- Construct a URI programmatically from individual components (scheme, host, port, path, query) without string concatenation.
- Extract and parse query parameters from a URI into a dictionary for easier access to key-value pairs.
- Modify an existing URI by changing its port, path, or query and then serialize it back to a string.
- Compare two URIs for equality after normalizing their components.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

PyURI parses, constructs, and manipulates URIs by component—scheme, host, port, path, query, and fragment—with utilities for extracting query parameters.

No. While the package is simple and has no dependencies, it has been abandoned since 2017 with no maintenance for nearly a decade. Python version support is unspecified and untested beyond 3.6. For URI handling, use the standard library's `urllib.parse` module, which is maintained, well-documented, and covers the same use cases.

## Install

pip install pyuri
uv add pyuri
poetry add pyuri

## Installing pyuri

Before you install: Installation is frictionless—a pure-Python wheel with no runtime dependencies. However, the package has been abandoned since its only release on 2017-03-27; no maintenance or updates have occurred in years, and Python version support is unspecified.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it legally safe to adopt in most projects.

Quickstart:

from pyuri import URI

uri = URI('http://localhost:80/path?query=value#fragment')
print(uri.scheme, uri.host, uri.port, uri.path)
print(uri.query_dict())

Verify before relying:

- Whether the package works reliably with Python versions beyond 2.7 and 3.6 (support is unspecified in the fact sheet).
- Whether URI parsing handles edge cases and RFC compliance correctly (no test coverage details provided).

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 74.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

URI parsing and manipulation, parse URL components, construct URI from parts, query string parsing, URI comparison and modification, extract query parameters, URI builder library, uri-parsing, abandoned

[View on SkillFed](https://skillfed.io/packages/pyuri) · [View on PyPI](https://pypi.org/project/pyuri/)