ada-url
URL parser and manipulator based on the WHAT WG URL standard
Decision gist · record as of 2026-08-14
Yes, if you need WHATWG-compliant URL parsing. The library is actively maintained, has no known vulnerabilities, and offers standards compliance and performance benefits over urllib.parse. Install friction is moderate due to compiled wheels, but prebuilt binaries cover current Python versions and common platforms. The Apache-2.0 license is permissive. Suitable for production use in web applications, API clients, and data processing pipelines.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Medium install friction due to compiled wheels; prebuilt binaries are available for current Python versions (3.10+) and common platforms, but installation requires a C compiler if building from source.
- Actively maintained with recent releases.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions—suitable for most projects.
last release 2026-07-28 (17 days) · last repo commit 2026-08-03 · 68 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 464,947 downloads/mo, #6,513 on PyPI
Alternatives
Verify before relying
pip install ada_url
from ada_url import URL, parse_url
url = URL('https://example.org/path/../file.txt')
print(url.href) # 'https://example.org/path/file.txt'
result = parse_url('https://user:pass@example.org:80/api?q=1#2')
print(result['hostname']) # 'example.org'- Actual performance comparison with urllib.parse under typical workloads remains unquantified in the fact sheet.
- Whether CFFI dependency introduces runtime overhead or platform-specific compatibility issues beyond the prebuilt wheels.
What it is and what it does
ada-url is a Python binding to the Ada URL parser, a C library that implements the WHATWG URL standard. It provides three main interfaces: the URL class for object-oriented URL manipulation, parse_url for extracting all URL components into a dictionary, and URLSearchParams for handling query strings. The library also includes idna encoding/decoding for internationalized domain names.
Unlike Python's standard urllib.parse, which follows the older RFC 3978 standard, ada-url correctly normalizes paths (resolving . and ..), properly encodes international characters in domain names, and handles edge cases defined by the WHATWG spec. It uses CFFI to call the underlying C library, making it faster than pure-Python alternatives for most URL parsing tasks. The package depends only on cffi and supports Python 3.10 and later across macOS, Linux, and Windows.
Use it for
- Validate and normalize user-supplied URLs in web applications before storing or processing them.
- Extract and manipulate URL components (hostname, path, query parameters) in web scrapers or API clients.
- Parse and handle internationalized domain names (IDNs) in multilingual applications.
- Resolve relative URLs and normalize paths in document processing or link crawling.
- Build query strings and search parameters programmatically with URLSearchParams.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need WHATWG-compliant URL parsing.
The library is actively maintained, has no known vulnerabilities, and offers standards compliance and performance benefits over urllib.parse. Install friction is moderate due to compiled wheels, but prebuilt binaries cover current Python versions and common platforms. The Apache-2.0 license is permissive. Suitable for production use in web applications, API clients, and data processing pipelines.
Install
ada-url on PyPI
Before you install
Medium install friction due to compiled wheels; prebuilt binaries are available for current Python versions (3.10+) and common platforms, but installation requires a C compiler if building from source. Actively maintained with recent releases.
Requires Python 3.10 or later.
License in practice
Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions—suitable for most projects.
Quickstart
pip install ada_url
from ada_url import URL, parse_url
url = URL('https://example.org/path/../file.txt')
print(url.href) # 'https://example.org/path/file.txt'
result = parse_url('https://user:pass@example.org:80/api?q=1#2')
print(result['hostname']) # 'example.org'Verify before relying
- Actual performance comparison with urllib.parse under typical workloads remains unquantified in the fact sheet.
- Whether CFFI dependency introduces runtime overhead or platform-specific compatibility issues beyond the prebuilt wheels.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 1 packagecffi |
| Maintenance | Actively maintained 17 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 464,947 / month, #6,513 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Programming Language :: Python :: 3 :: Only |
Evidence: ada_url-4.0.0-cp310-cp310-macosx_10_15_universal2.whl; ada_url-4.0.0-cp310-cp310-macosx_10_15_x86_64.whl; ada_url-4.0.0-cp310-cp310-macosx_11_0_arm64.whl; ada_url-4.0.0-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl; ada_url-4.0.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl; ada_url-4.0.0-cp310-cp310-musllinux_1_2_aarch64.whl; ada_url-4.0.0-cp310-cp310-musllinux_1_2_x86_64.whl; ada_url-4.0.0-cp310-cp310-win_amd64.whl; ada_url-4.0.0-cp311-cp311-macosx_10_15_universal2.whl; ada_url-4.0.0-cp311-cp311-macosx_10_15_x86_64.whl; ada_url-4.0.0-cp311-cp311-macosx_11_0_arm64.whl; ada_url-4.0.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl; ada_url-4.0.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl; ada_url-4.0.0-cp311-cp311-musllinux_1_2_aarch64.whl; ada_url-4.0.0-cp311-cp311-musllinux_1_2_x86_64.whl; ada_url-4.0.0-cp311-cp311-win_amd64.whl; ada_url-4.0.0-cp312-cp312-macosx_10_15_universal2.whl; ada_url-4.0.0-cp312-cp312-macosx_10_15_x86_64.whl; ada_url-4.0.0-cp312-cp312-macosx_11_0_arm64.whl; ada_url-4.0.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.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 parsing whatwg standard”
- ada-urlParse, validate, and manipulate URLs according to the WHATWG URL…
- can-adaParses and manipulates URLs according to the WHATWG specification,…
- urlcanonParses and normalizes URLs according to WHATWG browser standards,…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also can-ada · urlcanon · url-normalize · courlan · pyuri · uritools · idna · s3urls · wikitextparser · query-string