Metadata-Version: 1.1
Name: aioquic
Version: 0.8.5
Summary: An implementation of QUIC and HTTP/3
Home-page: https://github.com/aiortc/aioquic
Author: Jeremy Lainé
Author-email: jeremy.laine@m4x.org
License: BSD
Description: aioquic
        =======
        
        |rtd| |pypi-v| |pypi-pyversions| |pypi-l| |travis| |codecov| |black|
        
        .. |rtd| image:: https://readthedocs.org/projects/aioquic/badge/?version=latest
            :target: https://aioquic.readthedocs.io/
        
        .. |pypi-v| image:: https://img.shields.io/pypi/v/aioquic.svg
            :target: https://pypi.python.org/pypi/aioquic
        
        .. |pypi-pyversions| image:: https://img.shields.io/pypi/pyversions/aioquic.svg
            :target: https://pypi.python.org/pypi/aioquic
        
        .. |pypi-l| image:: https://img.shields.io/pypi/l/aioquic.svg
            :target: https://pypi.python.org/pypi/aioquic
        
        .. |travis| image:: https://img.shields.io/travis/com/aiortc/aioquic.svg
            :target: https://travis-ci.com/aiortc/aioquic
        
        .. |codecov| image:: https://img.shields.io/codecov/c/github/aiortc/aioquic.svg
            :target: https://codecov.io/gh/aiortc/aioquic
        
        .. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/python/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-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.
        
        .. code-block:: console
        
           $ sudo apt install libssl-dev python3-dev
        
        After checking out the code using git you can run:
        
        .. code-block:: console
        
           $ 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:
        
        .. code-block:: console
        
           $ 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:
        
        .. code-block:: console
        
          $ python examples/http3_client.py --ca-certs tests/pycacert.pem https://localhost:4433/
        
        Alternatively you can perform an HTTP/0.9 request:
        
        .. code-block:: console
        
          $ python examples/http3_client.py --ca-certs tests/pycacert.pem --legacy-http https://localhost:4433/
        
        You can also open a WebSocket over HTTP/3:
        
        .. code-block:: console
        
          $ python examples/http3_client.py --ca-certs tests/pycacert.pem wss://localhost:4433/ws
        
        License
        -------
        
        ``aioquic`` is released under the `BSD license`_.
        
        .. _read the documentation: https://aioquic.readthedocs.io/en/latest/
        .. _QUIC implementations: https://github.com/quicwg/base-drafts/wiki/Implementations
        .. _cryptography: https://cryptography.io/
        .. _BSD license: https://aioquic.readthedocs.io/en/latest/license.html
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
