---
id: urlpath
version: "2.0.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# urlpath — Object-oriented URL from urllib.parse and pathlib

License: permissive · Maintenance: aging · Downloads: 133.7K/mo

## 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 above — verify before relying.

URLPath extends pathlib.PurePath to treat URLs as filesystem-like objects, letting you manipulate URL components (scheme, netloc, path, query, fragment) using familiar path operations and make HTTP requests directly from URL objects.

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

pip install urlpath
uv add urlpath
poetry add urlpath

## Installing urlpath

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.

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 request

Requires Python 3.9 or later.

Verify 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_current
- Install friction: low
- Maintenance: aging
- Downloads: 133.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

url manipulation pathlib, object-oriented url parsing, url path operations, http requests from url objects, url component editing, urllib alternative, url query string builder, url-manipulation, pathlib-style, http-requests

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