========================================================

pyOpenSSL -- A Python wrapper around the OpenSSL library

========================================================

.. image:: https://readthedocs.org/projects/pyopenssl/badge/?version=stable

:target: https://pyopenssl.org/en/stable/

:alt: Stable Docs

.. image:: https://github.com/pyca/pyopenssl/workflows/CI/badge.svg?branch=main

:target: https://github.com/pyca/pyopenssl/actions?query=workflow%3ACI+branch%3Amain

.. image:: https://codecov.io/github/pyca/pyopenssl/branch/main/graph/badge.svg

:target: https://codecov.io/github/pyca/pyopenssl

:alt: Test coverage

**Note:** The Python Cryptographic Authority **strongly suggests** the use of `pyca/cryptography`_

where possible. If you are using pyOpenSSL for anything other than making a TLS connection

**you should move to cryptography and drop your pyOpenSSL dependency**.

High-level wrapper around a subset of the OpenSSL library. Includes

* ``SSL.Connection`` objects, wrapping the methods of Python's portable sockets

* Callbacks written in Python

* Extensive error-handling mechanism, mirroring OpenSSL's error codes

... and much more.

You can find more information in the documentation_.

Development takes place on GitHub_.

Discussion

==========

If you run into bugs, you can file them in our `issue tracker`_.

We maintain a cryptography-dev_ mailing list for both user and development discussions.

You can also join ``#cryptography-dev`` on Freenode to ask questions or get involved.

.. _documentation: https://pyopenssl.org/

.. _`issue tracker`: https://github.com/pyca/pyopenssl/issues

.. _cryptography-dev: https://mail.python.org/mailman/listinfo/cryptography-dev

.. _GitHub: https://github.com/pyca/pyopenssl

.. _`pyca/cryptography`: https://github.com/pyca/cryptography