An implementation of QUIC and HTTP/3
Project description
What is aioquic?
aioquic is a library for the QUIC network protocol in Python. It features a minimal TLS 1.3 implementation, a QUIC stack and an HTTP/3 stack.
QUIC standardisation is not finalised yet, but aioquic closely tracks the specification drafts and is regularly tested for interoperability against other QUIC implementations.
To learn more about aioquic please read the documentation.
Why should I use aioquic?
aioquic has been designed to be embedded into Python client and server libraries wishing to support QUIC and / or HTTP/3. The goal is to provide a common codebase for Python libraries in the hope of avoiding duplicated effort.
Both the QUIC and the HTTP/3 APIs follow the “bring your own I/O” pattern, leaving actual I/O operations to the API user. This approach has a number of advantages including making the code testable and allowing integration with different concurrency models.
Features
QUIC stack conforming with draft-23
HTTP/3 stack conforming with draft-23
minimal TLS 1.3 implementation
IPv4 and IPv6 support
connection migration and NAT rebinding
logging TLS traffic secrets
logging QUIC events in QLOG format
HTTP/3 server push support
Running the examples
aioquic requires Python 3.6 or better, and the OpenSSL development headers.
$ sudo apt install libssl-dev python3-dev
After checking out the code using git you can run:
$ pip install -e .
$ pip install aiofiles asgiref httpbin starlette wsproto
HTTP/3 server
You can run the example server, which handles both HTTP/0.9 and HTTP/3:
$ python examples/http3_server.py --certificate tests/ssl_cert.pem --private-key tests/ssl_key.pem
HTTP/3 client
You can run the example client to perform an HTTP/3 request:
$ python examples/http3_client.py https://localhost:4433/
Alternatively you can perform an HTTP/0.9 request:
$ python examples/http3_client.py --legacy-http https://localhost:4433/
You can also open a WebSocket over HTTP/3:
$ python examples/http3_client.py wss://localhost:4433/ws
License
aioquic is released under the BSD license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file aioquic-0.8.0.tar.gz
.
File metadata
- Download URL: aioquic-0.8.0.tar.gz
- Upload date:
- Size: 118.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5a1e8577c31bbf07befbd93624c172cd0f858e0e0a091fc4908c54ec2eca8eb8 |
|
MD5 | 61ad7f422a3b8126a21c2e9b77bbb863 |
|
BLAKE2b-256 | 19afc2ea95877b16ad71b52f218c62a0a8e6a84ff2bcc6098d833ec2ddab067a |