You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Change-Id: If3e3c4e01b19443714d880ae669aaa8b39edfff7 |
4 years ago | |
|---|---|---|
| .. | ||
| .jenkins | 4 years ago | |
| .travis | 4 years ago | |
| docs | 4 years ago | |
| src | 4 years ago | |
| tests | 4 years ago | |
| vectors | 4 years ago | |
| .coveragerc | 4 years ago | |
| .travis.yml | 4 years ago | |
| AUTHORS.rst | 4 years ago | |
| CHANGELOG.rst | 4 years ago | |
| CONTRIBUTING.rst | 4 years ago | |
| Jenkinsfile | 4 years ago | |
| LICENSE | 4 years ago | |
| LICENSE.APACHE | 4 years ago | |
| LICENSE.BSD | 4 years ago | |
| LICENSE.PSF | 4 years ago | |
| MANIFEST.in | 4 years ago | |
| METADATA | 4 years ago | |
| MODULE_LICENSE_BSD | 4 years ago | |
| NOTICE | 4 years ago | |
| README.rst | 4 years ago | |
| TEST_MAPPING | 4 years ago | |
| codecov.yml | 4 years ago | |
| dev-requirements.txt | 4 years ago | |
| pyproject.toml | 4 years ago | |
| release.py | 4 years ago | |
| rtd-requirements.txt | 4 years ago | |
| setup.py | 4 years ago | |
| tox.ini | 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://travis-ci.org/pyca/cryptography.svg?branch=master
:target: https://travis-ci.org/pyca/cryptography
.. 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.4+, and PyPy 5.3+.
``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/
.. _`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/