diff options
| -rw-r--r-- | CONTRIBUTING.rst | 21 | ||||
| -rw-r--r-- | README.rst | 13 |
2 files changed, 31 insertions, 3 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 539da50f..ff1a619c 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -1,10 +1,21 @@ +Process +======= + This repository has a mandatory code review policy. Contributions should happen through pull requests. Never commit to ``master`` directly. -When in doubt, refer to PEP 8 for Python code. +Code +==== + +When in doubt, refer to `PEP 8`_ for Python code. + +Docs +==== -Write docstrings like this:: +Write docstrings like this: + +.. code-block:: python def some_function(some_arg): """ @@ -18,4 +29,8 @@ So, specifically: - Always use three double quotes. - Put the three double quotes on their own line. - No blank line at the end. -- Use Sphinx parameter/attribute documentation syntax. +- Use Sphinx parameter/attribute documentation `syntax`_. + + +.. _`PEP 8`: http://www.peps.io/8/ +.. _`syntax`: http://sphinx-doc.org/domains.html#info-field-lists @@ -1,5 +1,18 @@ Cryptography ============ +.. image:: https://travis-ci.org/alex/cryptography.png?branch=master + :target: https://travis-ci.org/alex/cryptography + ``cryptography`` is a package designed to expose cryptographic primitives and recipes to Python developers. + +It is currently in early development and isn't recommended for general usage +yet. It targets Python 2.6-2.7, Python 3.2+, as well as PyPy. + +Why a new crypto library for Python? +------------------------------------ + +None of the existing ones work on PyPy, and many of them are unmaintained or +are based around very poor implementations of algorithms (i.e ones with known +side-channel attacks). |