Metadata-Version: 2.5
Name: httpx
Version: 1.0.dev5
Summary: HTTP, for Python.
Author-email: Kim Christie <noreply@lovelydinosaur.com>
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Requires-Dist: truststore
Description-Content-Type: text/markdown

<p align="center">
  <img width="350" height="208" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/butterfly.png" alt='httpx'>
</p>

# [httpx](README.md)

<p style="text-align: center">An HTTP toolkit for folks who give a damn.</p>

<br/>

Engineered for simplicity, `httpx` provides a complete Python web suite&hellip;

* Supports both client and server functionality.
* Presents a clear, simple, and tightly constrained API.
* A miminal, easily readable implementation.

## Installation

Install the package from PyPI&hellip;

```bash
$ uv add httpx --pre
```

## Client

Sending HTTP requests&hellip;

```python
>>> import httpx

>>> cli = httpx.Client()
>>> r = cli.get('https://www.example.com/')
>>> r
<Response [200 OK]>
```

## Server

Creating web apps&hellip;

```python
>>> import httpx

>>> def app(request):
...     content = httpx.HTML('<html><body>¡Hola, mundo!</body></html>')
...     return httpx.Response(200, content=content)

>>> s = httpx.Server(app)
>>> s.serve()
```

---

## Motivation

A clean modern design, with [a focused API](API.md) and an exceptionally light installation footprint.

For comparison, see `httpx` <small>vs</small> `requests`&hellip;

```bash
$ uv add httpx
$ uv tree --show-sizes --package httpx
httpx v1.0.dev5 (33.5KiB)
└── truststore v0.10.0 (17.8KiB)
```

<p></p>

```bash
$ uv add requests
$ uv tree --show-sizes --package requests
requests v2.33.1 (63.4KiB)
├── certifi v2026.2.25 (150.1KiB)
├── charset-normalizer v3.4.7 (302.4KiB)
├── idna v3.11 (69.3KiB)
└── urllib3 v2.6.3 (128.5KiB)
```

## Contribution

The `httpx` redesign is currently in early development and not yet public.

---

<p align="center">
<a href="license/">MIT Licensed</a>.<br/>Designed & Built with Love.
</p>

<p align="center">&mdash; 💖 &mdash;</p>
