Skip to main content

An implementation of QUIC and HTTP/3

Project description

rtd pypi-v pypi-pyversions pypi-l tests codecov black

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-28
  • HTTP/3 stack conforming with draft-28
  • 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

Requirements

aioquic requires Python 3.6 or better, and the OpenSSL development headers.

Linux

On Debian/Ubuntu run:

$ sudo apt install libssl-dev python3-dev

On Alpine Linux you will also need the following:

$ sudo apt install bsd-compat-headers libffi-dev

OS X

On OS X run:

$ brew install openssl

You will need to set some environment variables to link against OpenSSL:

$ export CFLAGS=-I/usr/local/opt/openssl/include
$ export LDFLAGS=-L/usr/local/opt/openssl/lib

Windows

On Windows the easiest way to install OpenSSL is to use Chocolatey.

> choco install openssl

You will need to set some environment variables to link against OpenSSL:

> $Env:INCLUDE = "C:\Progra~1\OpenSSL-Win64\include"
> $Env:LIB = "C:\Progra~1\OpenSSL-Win64\lib"

Running the examples

aioquic comes with a number of examples illustrating various QUIC usecases.

You can browse these examples here: https://github.com/aiortc/aioquic/tree/main/examples

License

aioquic is released under the BSD license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aioquic, version 0.9.11
Filename, size File type Python version Upload date Hashes
Filename, size aioquic-0.9.11-cp36-cp36m-macosx_10_9_x86_64.whl (1.2 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size aioquic-0.9.11-cp36-cp36m-manylinux2010_i686.whl (1.5 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size aioquic-0.9.11-cp36-cp36m-manylinux2010_x86_64.whl (1.5 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size aioquic-0.9.11-cp36-cp36m-manylinux2014_aarch64.whl (1.4 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size aioquic-0.9.11-cp36-cp36m-win32.whl (870.8 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size aioquic-0.9.11-cp36-cp36m-win_amd64.whl (1.0 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size aioquic-0.9.11-cp37-cp37m-macosx_10_9_x86_64.whl (1.2 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size aioquic-0.9.11-cp37-cp37m-manylinux2010_i686.whl (1.5 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size aioquic-0.9.11-cp37-cp37m-manylinux2010_x86_64.whl (1.5 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size aioquic-0.9.11-cp37-cp37m-manylinux2014_aarch64.whl (1.4 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size aioquic-0.9.11-cp37-cp37m-win32.whl (870.8 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size aioquic-0.9.11-cp37-cp37m-win_amd64.whl (1.0 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size aioquic-0.9.11-cp38-cp38-macosx_10_9_x86_64.whl (1.2 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size aioquic-0.9.11-cp38-cp38-manylinux2010_i686.whl (1.5 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size aioquic-0.9.11-cp38-cp38-manylinux2010_x86_64.whl (1.5 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size aioquic-0.9.11-cp38-cp38-manylinux2014_aarch64.whl (1.4 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size aioquic-0.9.11-cp38-cp38-win32.whl (870.8 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size aioquic-0.9.11-cp38-cp38-win_amd64.whl (1.0 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size aioquic-0.9.11-cp39-cp39-macosx_10_9_x86_64.whl (1.2 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size aioquic-0.9.11-cp39-cp39-manylinux2010_i686.whl (1.5 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size aioquic-0.9.11-cp39-cp39-manylinux2010_x86_64.whl (1.5 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size aioquic-0.9.11-cp39-cp39-manylinux2014_aarch64.whl (1.4 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size aioquic-0.9.11-cp39-cp39-win32.whl (870.8 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size aioquic-0.9.11-cp39-cp39-win_amd64.whl (1.0 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size aioquic-0.9.11-pp36-pypy36_pp73-macosx_10_9_x86_64.whl (1.2 MB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size aioquic-0.9.11-pp36-pypy36_pp73-manylinux2010_x86_64.whl (1.5 MB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size aioquic-0.9.11-pp36-pypy36_pp73-win32.whl (870.9 kB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size aioquic-0.9.11-pp37-pypy37_pp73-macosx_10_9_x86_64.whl (1.2 MB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size aioquic-0.9.11-pp37-pypy37_pp73-manylinux2010_x86_64.whl (1.5 MB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size aioquic-0.9.11-pp37-pypy37_pp73-win32.whl (870.9 kB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size aioquic-0.9.11.tar.gz (146.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page