aboutsummaryrefslogtreecommitdiffstats
path: root/docs/architecture.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/architecture.rst')
-rw-r--r--docs/architecture.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/architecture.rst b/docs/architecture.rst
new file mode 100644
index 00000000..80e2c28a
--- /dev/null
+++ b/docs/architecture.rst
@@ -0,0 +1,16 @@
+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``.
+* ``cryptography``: This package contains higher level recipes, for example
+ "encrypt and then MAC".