The next generation HTTP client.

Navigation

Verified details

These details have been verified by PyPI
Project links
Owner
GitHub Statistics
Maintainers
Avatar for Kludex from gravatar.com Kludex

Unverified details

These details have not been verified by PyPI
Meta
Classifiers
Report project as malware

Project description

HTTPX2

A next-generation HTTP client for Python.

Test Suite Package version

HTTPX2 is a fully featured HTTP client library for Python 3. It includes an integrated command line client, has support for both HTTP/1.1 and HTTP/2, and provides both sync and async APIs.

[!NOTE] HTTPX2 is a continuation of the wonderful work started by @lovelydinosaur and the broader HTTPX community. We're enormously grateful for everything that has gone into HTTPX over the years - it has been a foundational piece of the modern Python ecosystem, and this project would not exist without it.

With HTTPX itself seeing limited activity recently, Pydantic is picking up stewardship under the HTTPX2 name so that users have a reliably maintained path forward - including timely security updates for a library that sits in the critical path of so many production systems. Our aim is to honour the original project's design, keep it stable for everyone relying on it, and continue evolving it carefully. Thank you to @lovelydinosaur and every past contributor for laying such a strong foundation. 💙

Install HTTPX2 using pip:

pip install httpx2

Now, let's get started:

>>> import httpx2
>>> r = httpx2.get('https://www.example.org/')
>>> r
<Response [200 OK]>
>>> r.status_code
200
>>> r.headers['content-type']
'text/html; charset=UTF-8'
>>> r.text
'<!doctype html>\n<html>\n<head>\n<title>Example Domain</title>...'

Or, using the command-line client.

pip install 'httpx2[cli]'  # The command line client is an optional dependency.

Which now allows us to use HTTPX2 directly from the command-line...

httpx2 --help

Sending a request...

httpx2 http://httpbin.org/json

Features

HTTPX2 builds on the well-established usability of requests, and gives you:

Plus all the standard features of requests...

  • International Domains and URLs
  • Keep-Alive & Connection Pooling
  • Sessions with Cookie Persistence
  • Browser-style SSL Verification
  • Basic/Digest Authentication
  • Elegant Key/Value Cookies
  • Automatic Decompression
  • Automatic Content Decoding
  • Unicode Response Bodies
  • Multipart File Uploads
  • HTTP(S) Proxy Support
  • Connection Timeouts
  • Streaming Downloads
  • .netrc Support
  • Chunked Requests

Installation

Install with pip:

pip install httpx2

Or, to include the optional HTTP/2 support, use:

pip install httpx2[http2]

HTTPX2 requires Python 3.9+.

Documentation

Project documentation is available at https://httpx2.pydantic.dev/.

For a run-through of all the basics, head over to the QuickStart.

For more advanced topics, see the Advanced Usage section, the async support section, or the HTTP/2 section.

The Developer Interface provides a comprehensive API reference.

To find out about tools that integrate with HTTPX, see Third Party Packages.

Contribute

If you want to contribute with HTTPX2 check out the Contributing Guide to learn how to start.

Dependencies

The HTTPX2 project relies on these excellent libraries:

  • httpcore2 - The underlying transport implementation for httpx2.
    • h11 - HTTP/1.1 support.
  • anyio - Structured concurrency primitives, used to support both asyncio and trio.
  • certifi - SSL certificates.
  • idna - Internationalized domain name support.

As well as these optional installs:

  • h2 - HTTP/2 support. (Optional, with httpx2[http2])
  • socksio - SOCKS proxy support. (Optional, with httpx2[socks])
  • rich - Rich terminal support. (Optional, with httpx2[cli])
  • click - Command line client support. (Optional, with httpx2[cli])
  • brotli or brotlicffi - Decoding for "brotli" compressed responses. (Optional, with httpx2[brotli])
  • zstandard - Decoding for "zstd" compressed responses. (Optional, with httpx2[zstd])

A huge amount of credit is due to requests for the API layout that much of this work follows, as well as to urllib3 for plenty of design inspiration around the lower-level networking details.

HTTPX2 is BSD licensed code.
Designed & crafted with care.
— 🦋 —

Release Information

Breaking changes

  • Renamed package: httpx -> httpx2. import httpx becomes import httpx2. The CLI is now httpx2, the User-Agent header is python-httpx2/<version>, and the logger is httpx2. No other public API changed.
  • Renamed transitive dependency: httpcore -> httpcore2, vendored into the same repository as a uv workspace member. Code that imports httpcore directly should switch to httpcore2. httpx2 always depends on a specific httpcore2 version, pinned exactly.

Added

  • Expose FunctionAuth from the public API. (Inherited from upstream PR encode/httpx#3699.)

Fixed

  • Eliminate PytestUnraisableExceptionWarning from async generator finalization during stream teardown under trio. (#137, backporting encode/httpcore#1019 by @agronholm.)

Historical entries below are from upstream encode/httpx.

Full changelog

Project details

Verified details

These details have been verified by PyPI
Project links
Owner
GitHub Statistics
Maintainers
Avatar for Kludex from gravatar.com Kludex

Unverified details

These details have not been verified by PyPI
Meta
Classifiers

Release history Release notifications | RSS feed

This version

2.0.0

2.0.0b1 pre-release

0.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

httpx2-2.0.0.tar.gz (79.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

httpx2-2.0.0-py3-none-any.whl (73.4 kB view details)

Uploaded Python 3

File details

Details for the file httpx2-2.0.0.tar.gz.

File metadata

  • Download URL: httpx2-2.0.0.tar.gz
  • Upload date:
  • Size: 79.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for httpx2-2.0.0.tar.gz
Algorithm Hash digest
SHA256 f354249d2a9edce26e08fd2ad2276e98317b5763f673bb0d90f3ce9382cc2aed
MD5 7117ccd81b4b41f5465331f9ece82dc9
BLAKE2b-256 7095868b3df4aa6f9cecb42aaf82a55a5a2c8ef40df76d709b812e1553d6a928

See more details on using hashes here.

Provenance

The following attestation bundles were made for httpx2-2.0.0.tar.gz:

Publisher: publish.yml on pydantic/httpx2

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file httpx2-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: httpx2-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 73.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for httpx2-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dfb5ae245f3985681296a000453f1e5fffee322eb531feabcdaf1557ad978b6a
MD5 1d2e1ab853a14977d1e48dfaad384565
BLAKE2b-256 e92566215a750faeb79b698286c0d0b94894482cfae10371ae4968ef6e165a28

See more details on using hashes here.

Provenance

The following attestation bundles were made for httpx2-2.0.0-py3-none-any.whl:

Publisher: publish.yml on pydantic/httpx2

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page