purepython-aes 0.1.0__tar.gz → 0.2.0__tar.gz

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: purepython-aes
-Version: 0.1.0
+Version: 0.2.0
 Summary: Pure-Python implementation of AES encryption algorithm.
 Author-email: Emelianov Artem <penguin5726@proton.me>
 License-Expression: MIT

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes/__init__.py

@@ -7,6 +7,7 @@ from purepython_aes.aes import (
     AnsiX923Padding,
     BasePadding,
     BlockCipherMode,
+    CbcMode,
     EcbMode,
     Iso7816Padding,
     Iso10126Padding,
@@ -24,6 +25,7 @@ __all__: list[str] = [
     'AnsiX923Padding',
     'BasePadding',
     'BlockCipherMode',
+    'CbcMode',
     'EcbMode',
     'Iso7816Padding',
     'Iso10126Padding',

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes/aes/__init__.py

@@ -1,6 +1,6 @@
 from purepython_aes.aes.algorithms import Aes128, Aes192, Aes256
 from purepython_aes.aes.interface import Aes
-from purepython_aes.aes.modes import AesMode, BlockCipherMode, EcbMode
+from purepython_aes.aes.modes import AesMode, BlockCipherMode, CbcMode, EcbMode
 from purepython_aes.aes.padding import (
     AnsiX923Padding,
     BasePadding,
@@ -18,6 +18,7 @@ __all__: list[str] = [
     'Aes',
     'AesMode',
     'BlockCipherMode',
+    'CbcMode',
     'EcbMode',
     'AnsiX923Padding',
     'BasePadding',

purepython_aes-0.2.0/src/purepython_aes/aes/modes/__init__.py

@@ -0,0 +1,4 @@
+from purepython_aes.aes.modes._base import AesMode
+from purepython_aes.aes.modes.block import BlockCipherMode, CbcMode, EcbMode
+
+__all__: list[str] = ['AesMode', 'BlockCipherMode', 'CbcMode', 'EcbMode']

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes/aes/modes/block/__init__.py

@@ -1,4 +1,5 @@
 from purepython_aes.aes.modes.block._base import BlockCipherMode
+from purepython_aes.aes.modes.block.cbc import CbcMode
 from purepython_aes.aes.modes.block.ecb import EcbMode
 
-__all__: list[str] = ['BlockCipherMode', 'EcbMode']
+__all__: list[str] = ['BlockCipherMode', 'CbcMode', 'EcbMode']

purepython_aes-0.2.0/src/purepython_aes/aes/modes/block/cbc.py

@@ -0,0 +1,35 @@
+from dataclasses import dataclass
+from secrets import token_bytes
+from typing import final
+
+from purepython_aes.aes.modes.block._base import BlockCipherMode
+from purepython_aes.aes.modes.operations import split_into_blocks, xor
+from purepython_aes.const import AES_BLOCK_SIZE
+
+
+@final
+@dataclass(slots=True)
+class CbcMode(BlockCipherMode):
+    """Cipher Block Chaining mode of operation."""
+
+    def encrypt_blocks(self, padded_plaintext: bytes) -> bytes:
+        initialization_vector: bytes = token_bytes(AES_BLOCK_SIZE)
+        previous_ciphertext_block: bytes = initialization_vector
+        ciphertext_blocks: list[bytes] = [initialization_vector]
+        for block in split_into_blocks(padded_plaintext):
+            chained_block: bytes = xor(block, previous_ciphertext_block)
+            ciphertext_block: bytes = self.algorithm.encrypt_block(chained_block)
+            ciphertext_blocks.append(ciphertext_block)
+            previous_ciphertext_block = ciphertext_block
+        return bytes(0).join(ciphertext_blocks)
+
+    def decrypt_blocks(self, ciphertext: bytes) -> bytes:
+        initialization_vector, *ciphertext_blocks = split_into_blocks(ciphertext)
+        previous_ciphertext_block: bytes = initialization_vector
+        plaintext_blocks: list[bytes] = []
+        for block in ciphertext_blocks:
+            decrypted_block: bytes = self.algorithm.decrypt_block(block)
+            plaintext_block: bytes = xor(decrypted_block, previous_ciphertext_block)
+            plaintext_blocks.append(plaintext_block)
+            previous_ciphertext_block = block
+        return bytes(0).join(plaintext_blocks)

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: purepython-aes
-Version: 0.1.0
+Version: 0.2.0
 Summary: Pure-Python implementation of AES encryption algorithm.
 Author-email: Emelianov Artem <penguin5726@proton.me>
 License-Expression: MIT

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes.egg-info/SOURCES.txt

@@ -31,6 +31,7 @@ src/purepython_aes/aes/modes/_base.py
 src/purepython_aes/aes/modes/operations.py
 src/purepython_aes/aes/modes/block/__init__.py
 src/purepython_aes/aes/modes/block/_base.py
+src/purepython_aes/aes/modes/block/cbc.py
 src/purepython_aes/aes/modes/block/ecb.py
 src/purepython_aes/aes/padding/__init__.py
 src/purepython_aes/aes/padding/_base.py
@@ -65,6 +66,7 @@ tests/unit/aes/core/test_state.py
 tests/unit/aes/modes/__init__.py
 tests/unit/aes/modes/test_operations.py
 tests/unit/aes/modes/block/__init__.py
+tests/unit/aes/modes/block/test_cbc.py
 tests/unit/aes/modes/block/test_ecb.py
 tests/unit/aes/padding/__init__.py
 tests/unit/aes/padding/conftest.py

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes.egg-info/scm_file_list.json

@@ -34,6 +34,7 @@
     "src/purepython_aes/aes/modes/operations.py",
     "src/purepython_aes/aes/modes/block/_base.py",
     "src/purepython_aes/aes/modes/block/__init__.py",
+    "src/purepython_aes/aes/modes/block/cbc.py",
     "src/purepython_aes/aes/modes/block/ecb.py",
     "src/purepython_aes/aes/algorithms/aes128.py",
     "src/purepython_aes/aes/algorithms/__init__.py",
@@ -65,6 +66,7 @@
     "tests/unit/aes/modes/__init__.py",
     "tests/unit/aes/modes/block/__init__.py",
     "tests/unit/aes/modes/block/test_ecb.py",
+    "tests/unit/aes/modes/block/test_cbc.py",
     "tests/unit/aes/algorithms/test_aes256.py",
     "tests/unit/aes/algorithms/__init__.py",
     "tests/unit/aes/algorithms/test_aes128.py",

{purepython_aes-0.1.0 → purepython_aes-0.2.0}/src/purepython_aes.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.1.0",
+  "tag": "0.2.0",
   "distance": 0,
-  "node": "g18cff6ba62f4743b0f5af672a133edba13f2b244",
+  "node": "g6499740a96c2f3a034500f56fa2b3813839c4ba5",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-07-13"

purepython_aes-0.2.0/tests/unit/aes/modes/block/test_cbc.py

@@ -0,0 +1,67 @@
+from itertools import product
+
+from hypothesis import assume, given
+from hypothesis.strategies import binary
+from pytest import mark
+
+from purepython_aes import (
+    Aes,
+    Aes128,
+    Aes192,
+    Aes256,
+    AnsiX923Padding,
+    BasePadding,
+    CbcMode,
+    Iso7816Padding,
+    Iso10126Padding,
+    NoPadding,
+    Pkcs7Padding,
+    ZeroPadding,
+)
+from tests.unit.aes.strategies import aes256key, aes_blocks
+
+
+@mark.quick
+class TestCbcMode:
+    @staticmethod
+    @mark.parametrize(
+        ['aes', 'padding'],
+        tuple(
+            product(
+                [Aes128, Aes192, Aes256],
+                [AnsiX923Padding, Iso10126Padding, Iso7816Padding, Pkcs7Padding],
+            ),
+        ),
+    )
+    @given(key=aes256key, data=binary())
+    def test_decrypt_inverts_encrypt(
+        aes: type[Aes],
+        padding: type[BasePadding],
+        key: bytes,
+        data: bytes,
+    ) -> None:
+        ecb: CbcMode = CbcMode(aes(key[:aes.__key_size__]), padding())  # fmt: skip
+        assert ecb.decrypt(ecb.encrypt(data)) == data
+
+    @staticmethod
+    @mark.parametrize(['aes'], [[Aes128], [Aes192], [Aes256]])
+    @given(key=aes256key, data=binary())
+    def test_decrypt_inverts_encrypt_zero_padding(
+        aes: type[Aes],
+        key: bytes,
+        data: bytes,
+    ) -> None:
+        assume(not data.endswith(bytes(1)))
+        ecb: CbcMode = CbcMode(aes(key[:aes.__key_size__]), ZeroPadding())  # fmt: skip
+        assert ecb.decrypt(ecb.encrypt(data)) == data
+
+    @staticmethod
+    @mark.parametrize(['aes'], [[Aes128], [Aes192], [Aes256]])
+    @given(key=aes256key, data=aes_blocks)
+    def test_decrypt_inverts_encrypt_no_padding(
+        aes: type[Aes],
+        key: bytes,
+        data: bytes,
+    ) -> None:
+        ecb: CbcMode = CbcMode(aes(key[:aes.__key_size__]), NoPadding())  # fmt: skip
+        assert ecb.decrypt(ecb.encrypt(data)) == data

purepython_aes-0.1.0/src/purepython_aes/aes/modes/__init__.py

@@ -1,4 +0,0 @@
-from purepython_aes.aes.modes._base import AesMode
-from purepython_aes.aes.modes.block import BlockCipherMode, EcbMode
-
-__all__: list[str] = ['AesMode', 'BlockCipherMode', 'EcbMode']