without-http
A sans-IO-backed ASGI server and HTTP client for without. Where
without-asgi is the app side of the ASGI boundary (it turns
a server's receive/send into typed streams), without-http is the server
side: it owns the socket and the HTTP wire protocol, and drives any ASGI app via
app(scope, receive, send).
The wire-protocol state machines are themselves sans-IO libraries:
h11 for HTTP/1.1,
h2 for HTTP/2, and
wsproto for WebSockets.
without-http reads and writes socket bytes with asyncio, feeds them through
those state machines, and uses without-asgi's server-direction codecs to
translate between typed events and the ASGI dicts an app expects.
from without import sleep_forever
from without_asgi import make_asgi_app
from without_http import ConnectionPool, request, serving
app = make_asgi_app(lifespan, http=router.dispatch, websocket=sockets.dispatch)
async with serving(app, host="127.0.0.1", port=8000):
await sleep_forever() # run until cancelled
async with ConnectionPool() as pool:
async with request(pool, "GET", "http://127.0.0.1:8000/items") as (head, body):
assert head.status == 200
data = await body.read()
Because without-http speaks plain ASGI to the app, any ASGI app runs over it,
interchangeably with uvicorn. The server handles TLS, HTTP/2 (by ALPN or prior
knowledge), keep-alive, WebSockets over the HTTP/1.1 upgrade, per-handler
isolation, and flow control. A client is a function from a request to a response, and
a ConnectionPool is the one that answers over the network: a (head, body) response
split, buffered and streaming bodies in both directions, opt-in trailers, HTTP/2
multiplexing, per-host connection bounds, per-phase request timeouts, consumer-driven
duplex (with bidirectional streaming over HTTP/2), and stack-composed middleware.
without_http.testing carries the same interface into a test: a mock client that answers
from a function, an ASGI client that drives an app in memory, and a loopback client that
runs the real wire protocols over no socket at all, plus the raw in-memory endpoints
those are built from, for a test that writes frames rather than requests.
See the
without-http guide
(with the API reference)
for the full surface, including the deferred work (WebSockets over HTTP/2, HTTP/3).
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file without_http-0.0.3.tar.gz.
File metadata
- Download URL: without_http-0.0.3.tar.gz
- Upload date:
- Size: 53.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
274795696242ace98974800507d97fe7d64074ea9d86fee90e4f8869b1da9bcc
|
|
| MD5 |
1dddfcd4fb6c821ed152bb18197816d5
|
|
| BLAKE2b-256 |
bec21129ce55ca5559af94e68f1df5e5123caa7b7fc53b0b2dd04ad596cd5de0
|
File details
Details for the file without_http-0.0.3-py3-none-any.whl.
File metadata
- Download URL: without_http-0.0.3-py3-none-any.whl
- Upload date:
- Size: 59.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a5022a5577f517d2af7ae8e12de0cdedb4e2eba225b2c4d5242dfe369a65338
|
|
| MD5 |
ece68026e08117f529c0879322972f50
|
|
| BLAKE2b-256 |
79223f28b696b12420307705d92732c746074753efa180d61e7c432494e9ade4
|