urlpath
Object-oriented URL from urllib.parse and pathlib
Decision gist · record as of 2026-08-14
Yes, if you work with URLs programmatically and prefer object-oriented manipulation over string parsing. The low install friction, permissive MIT license, and stable API make it a safe dependency. The aging maintenance status (last release 305 days ago) is not a blocker for a mature library with no known vulnerabilities, but monitor the repository for critical fixes. Not necessary if you only build URLs occasionally or are already comfortable with urllib.parse.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Low install friction: pure Python wheel with only two runtime dependencies (requests and charset-normalizer).
- Maintenance signal is aging—last release was 305 days ago, though the repository remains active and the package has been stable since its 2015 initial release.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute URLPath freely in commercial and private projects with minimal restrictions.
last release 2025-10-13 (305 days) · last repo commit 2025-10-13 · 23 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 133,666 downloads/mo, #11,499 on PyPI
Alternatives
Verify before relying
pip install urlpath
from urlpath import URL
url = URL('https://example.com/path?field=value#fragment')
print(url.scheme) # 'https'
print(url.hostname) # 'example.com'
print(url.path) # '/path'
response = url.get() # Make HTTP GET request- Whether optional dependencies (JMESPath, WebOb) are actually used by the package or are legacy references.
- Performance characteristics when manipulating very large or complex URLs.
- Whether the jailed mode fully prevents directory traversal attacks or is a convenience feature only.
What it is and what it does
URLPath is a Python library that wraps URL strings in an object-oriented interface modeled after pathlib.PurePath, treating URLs as hierarchical paths. It lets you decompose URLs into components (scheme, netloc, username, password, hostname, port, path, query, fragment), navigate and manipulate them using familiar path operators (/ for joining, .parent for going up), and rebuild URLs with modified parts using methods like with_scheme(), with_query(), and with_fragment().
Beyond path operations, URLPath integrates requests to let you call HTTP verbs (get, post, put, patch, delete) directly on URL objects, and provides a "jailed" mode to restrict path traversal outside a root URL. It handles query strings as both raw strings and as form field tuples, and preserves trailing slashes. The package targets developers who want to work with URLs programmatically without manually parsing and reconstructing URL strings.
Use it for
- Build URLs dynamically by composing path segments and query parameters using pathlib-like operators instead of string concatenation.
- Extract and modify individual URL components (hostname, port, credentials, query fields) without regex or manual parsing.
- Make HTTP requests directly from URL objects using get(), post(), put(), patch(), delete() methods.
- Restrict URL navigation to a root domain using jailed mode to prevent accidental traversal to external hosts.
- Normalize and compare URLs by treating them as structured objects with predictable component access.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you work with URLs programmatically and prefer object-oriented manipulation over string parsing.
The low install friction, permissive MIT license, and stable API make it a safe dependency. The aging maintenance status (last release 305 days ago) is not a blocker for a mature library with no known vulnerabilities, but monitor the repository for critical fixes. Not necessary if you only build URLs occasionally or are already comfortable with urllib.parse.
Install
urlpath on PyPI
Before you install
Low install friction: pure Python wheel with only two runtime dependencies (requests and charset-normalizer). Maintenance signal is aging—last release was 305 days ago, though the repository remains active and the package has been stable since its 2015 initial release.
Requires Python 3.9 or later.
License in practice
MIT license is permissive; you can use, modify, and distribute URLPath freely in commercial and private projects with minimal restrictions.
Quickstart
pip install urlpath
from urlpath import URL
url = URL('https://example.com/path?field=value#fragment')
print(url.scheme) # 'https'
print(url.hostname) # 'example.com'
print(url.path) # '/path'
response = url.get() # Make HTTP GET requestVerify before relying
- Whether optional dependencies (JMESPath, WebOb) are actually used by the package or are legacy references.
- Performance characteristics when manipulating very large or complex URLs.
- Whether the jailed mode fully prevents directory traversal attacks or is a convenience feature only.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagescharset-normalizerrequests |
| Maintenance | Aging 305 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 133,666 / month, #11,499 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Topic :: Internet :: WWW/HTTPTopic :: Software Development :: Libraries :: Python Modules |
Evidence: urlpath-2.0.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “url manipulation pathlib”
- urlpathURLPath extends pathlib.PurePath to treat URLs as filesystem-like…
- pathlib2Backport of Python's standard pathlib module for older Python…
- pathlib3xBackport of Python 3.11 pathlib to Python 3.8+ with extensions like…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also furl · pyuri · dsnparse · urlpy · pathlib2 · purl · pathlib · hyperlink · url-normalize · s3pathlib