Romain Rigaux 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
..
docs 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
src 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
tests 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
AUTHORS.rst 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
CHANGELOG.rst 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
CONTRIBUTING.rst 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
LICENSE 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
LICENSE.APACHE 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
LICENSE.BSD 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
LICENSE.PSF 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
MANIFEST.in 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
PKG-INFO 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
README.rst 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
pyproject.toml 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
setup.cfg 2739f19540 [libs] Add cryptography-3.3.2 4 years ago
setup.py 2739f19540 [libs] Add cryptography-3.3.2 4 years ago

README.rst

pyca/cryptography
=================

.. image:: https://img.shields.io/pypi/v/cryptography.svg
:target: https://pypi.org/project/cryptography/
:alt: Latest Version

.. image:: https://readthedocs.org/projects/cryptography/badge/?version=latest
:target: https://cryptography.io
:alt: Latest Docs

.. image:: https://github.com/pyca/cryptography/workflows/CI/badge.svg?branch=master
:target: https://github.com/pyca/cryptography/actions?query=workflow%3ACI+branch%3Amaster

.. image:: https://codecov.io/github/pyca/cryptography/coverage.svg?branch=master
:target: https://codecov.io/github/pyca/cryptography?branch=master


``cryptography`` is a package which provides cryptographic recipes and
primitives to Python developers. Our goal is for it to be your "cryptographic
standard library". It supports Python 2.7, Python 3.6+, and PyPy 5.4+.

``cryptography`` includes both high level recipes and low level interfaces to
common cryptographic algorithms such as symmetric ciphers, message digests, and
key derivation functions. For example, to encrypt something with
``cryptography``'s high level symmetric encryption recipe:

.. code-block:: pycon

>>> from cryptography.fernet import Fernet
>>> # Put this somewhere safe!
>>> key = Fernet.generate_key()
>>> f = Fernet(key)
>>> token = f.encrypt(b"A really secret message. Not for prying eyes.")
>>> token
'...'
>>> f.decrypt(token)
'A really secret message. Not for prying eyes.'

You can find more information in the `documentation`_.

You can install ``cryptography`` with:

.. code-block:: console

$ pip install cryptography

For full details see `the installation documentation`_.

Discussion
~~~~~~~~~~

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

We maintain a `cryptography-dev`_ mailing list for development discussion.

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

Security
~~~~~~~~

Need to report a security issue? Please consult our `security reporting`_
documentation.


.. _`documentation`: https://cryptography.io/
.. _`the installation documentation`: https://cryptography.io/en/latest/installation.html
.. _`issue tracker`: https://github.com/pyca/cryptography/issues
.. _`cryptography-dev`: https://mail.python.org/mailman/listinfo/cryptography-dev
.. _`security reporting`: https://cryptography.io/en/latest/security.html