docs/architecture.rst

Architecture
============

.. warning::

    Because ``cryptography`` is so young, much of this document is
    aspirational, rather than documentation.

``cryptography`` has three different layers:

* ``cryptography.c``: This package contains bindings to low level cryptographic
  libraries. Our initial target will be OpenSSL.
* ``cryptography.primitives``: This packages contains low level algorithms,
  things like ``AES`` or ``SHA1``. This is implemented on top of
  ``cryptography.c``.
* ``cryptography``: This package contains higher level recipes, for example
  "encrypt and then MAC". This is implemented on top of
  ``cryptography.primitives``.