Metadata-Version: 2.5
Name: hip
Version: 0.2
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="img/butterfly.png" alt='hip'>
</p>

# [hip](README.md)

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

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

...we're currently in early stages design, and would love for you to get involved.

## Installation

Install the package from PyPI&hellip;

```shell
$ uv add hip --dev
```

## Client

Sending HTTP requests&hellip;

```python
>>> import hip

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

## Server

Creating web apps&hellip;

```python
>>> import hip

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

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

---

## Motivation

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

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

```shell
$ uv add hip
$ uv tree --show-sizes --package hip
hip v0.2 (33.5KiB)
└── truststore v0.10.0 (17.8KiB)
```

<p></p>

```shell
$ 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 `hip` redesign is currently in early development.

We are currently [seeking sponsorship](https://github.com/sponsors/encode), and looking to expand our team.

If you'd like to discuss getting involved, please [book in some time](https://calendly.com/encode-oss).

---

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

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