ada-url

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

Parse, validate, and manipulate URLs according to the WHATWG URL standard, with support for internationalized domain names and path normalization.

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

pip install ada-url

uv add ada-url

poetry add ada-url

Installing ada-url

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.

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'

Requires Python 3.10 or later.

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

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

More WWW/HTTP packages