diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/index.rst | 19 | ||||
| -rw-r--r-- | docs/primitives/symmetric-encryption.rst | 2 |
2 files changed, 19 insertions, 2 deletions
diff --git a/docs/index.rst b/docs/index.rst index 1d8ffda6..29f0b545 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -8,7 +8,24 @@ Welcome to ``cryptography`` ``cryptography`` is a Python library which exposes cryptographic primitives and recipes. -Contents: +Why a new crypto library for Python? +------------------------------------ + +We wanted to address a few issues with existing cryptography libraries in +Python: + +* Lack of PyPy support. +* Lack of maintenance. +* Use of poor implementations of algorithms (i.e. ones with known side-channel + attacks). +* Lack of high level, "Cryptography for humans", APIs. +* Absence of algorithms such as AES-GCM. +* Poor introspectability, and thus poor testability. +* Extremely error prone APIs, and bad defaults. + + +Contents +-------- .. toctree:: :maxdepth: 2 diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst index 0812f6b9..9986d89d 100644 --- a/docs/primitives/symmetric-encryption.rst +++ b/docs/primitives/symmetric-encryption.rst @@ -14,7 +14,7 @@ where the encrypter and decrypter both use the same key. >>> from cryptography.primitives.block import BlockCipher, ciphers, modes >>> cipher = BlockCipher(ciphers.AES(key), modes.CBC(iv)) - >>> cipher.encrypt("my secret message") + cipher.finalize() + >>> cipher.encrypt(b"a secret message") + cipher.finalize() # The ciphertext [...] |