lowhaio 
A lightweight Python asyncio HTTP/1.1 client. No additional tasks are created; all code is in a single module; and other than the standard library only a single dependency is required, aiodnsresolver
Lowhaio has a deliberately limited scope: it includes just enough code to be a useful HTTP client and allow more complex behaviour to be added on top if required.
Connections are DNS-aware, in that they are only re-used if they match a current A record for the domain.
Installation
pip install lowhaio
Usage
The API is streaming-first: for both request and response bodies, asynchronous iterators are used.
import asyncio
from lowhaio import Pool
async def main():
request, close = Pool()
async def request_body():
yield b'a'
yield b'bc'
code, headers, response_body = await request(
b'POST', 'https://postman-echo.com/post',
headers=((b'content-length', b'3'), (b'content-type', b'text/plain'),),
body=request_body,
)
async for chunk in response_body:
print(chunk)
await close()
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
However, there are helper functions streamed and buffered when this isn't required or possible.
import asyncio
from lowhaio import Pool, streamed, buffered
async def main():
request, close = Pool()
request_body = streamed(b'abc')
code, headers, response_body = await request(
b'POST', 'https://postman-echo.com/post',
headers=((b'content-length', b'3'), (b'content-type', b'text/plain'),),
body=request_body,
)
print(await buffered(response_body))
await close()
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
Headers
The only header automatically added to requests is the host header, which is the idna/punycode-encoded domain name from the requested URL.
Exceptions
Exceptions are usually subclasses of HttpError. If a lower-level exception caused this, it is set in the __cause__ attribute of the HttpError. Specifically, before any data is sent HttpConnectionError is raised, and after data is sent, HttpDataError is raised. This difference is to make it possible to know if non-idempotent requests can be retried.
However, asyncio.CancelledError and exceptions that do not directive from Exception, such as SystemExit, are allowed to bubble up.
Custom SSL context
Lowhaio can be used with an custom SSL context through through the get_ssl_context parameter to Pool. For example, to use the certifi CA bundle, you can install it by
pip install certifi
and use it as below.
import asyncio
import ssl
import certifi
from lowhaio import Pool, buffered, streamed
async def main():
request, close = Pool(
get_ssl_context=lambda: ssl.create_default_context(cafile=certifi.where()),
)
request_body = streamed(b'abc')
code, headers, response_body = await request(
b'POST', 'https://postman-echo.com/post',
headers=((b'content-length', b'3'), (b'content-type', b'text/plain'),),
body=request_body,
)
print(await buffered(response_body))
await close()
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
Scope
The scope of the core functions is restricted to:
- (TLS) connection opening, closing and pooling;
- passing and receiving HTTP headers and streaming bodies;
- decoding chunked responses;
- raising exceptions on timeouts.
This is to make the core behaviour useful to a reasonable range of uses, but to not include what can be added by layer(s) on top. Specifically not included:
- following redirects, implemented by lowhaio-redirect;
- retrying failed requests, implemented by lowhaio-retry;
- encoding chunked requests, implemented by lowhaio-chunked;
- authentication, such as AWS Signature Version 4 implemented by lowhaio-aws-sigv4, or AWS Signature Version 4 with unsigned payload implemented by lowhaio-aws-sigv4-unsigned-payload;
- compressing/decompressing requests/responses;
- cookies.
1 maintainer
Release files for lowhaio 0.0.89
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lowhaio-0.0.89.tar.gz | 8.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lowhaio-0.0.89-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.5 kB
Release files / lowhaio-0.0.89.tar.gz
| Download URL | lowhaio-0.0.89.tar.gz |
|---|---|
| Size | 8.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1dfa96daf5275dc8477708672e40f48d607e1bc8ce8f73458b54f591c933bc1d
|
|
BLAKE2b-256 checksum How to use checksums |
3ebb6394eada30dcf4947bd2f6bda8e21437ba546038fc14544c817e5de152b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.0
|
Release files / lowhaio-0.0.89-py3-none-any.whl
| Download URL | lowhaio-0.0.89-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
07b92d90b627f4b734341e5b23d49c0c9db2d827a92354b4b263f8ecb70a1df8
|
|
BLAKE2b-256 checksum How to use checksums |
62c2253b35ee77a040e6255aafc468846a6cf7450246bd2c124d422f7713b3db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.0
|
