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

{purepython_aes-0.1.0 → purepython_aes-0.3.0}/.github/workflows/release.yml

@@ -50,28 +50,10 @@ jobs:
         run: python -m pip install --editable ".[dev, test]"
       - name: Run pre-commit hooks
         run: pre-commit run --all-files --show-diff-on-failure
-  slow-tests:
-    name: Run release-only tests
-    needs:
-      - validate
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check out tagged commit
-        uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-          cache: pip
-      - name: Install dependencies
-        run: python -m pip install --editable ".[dev, test]"
-      - name: Run slow tests
-        run: python -m pytest -n 8 -m "slow and not quick"
   build:
     name: Build distributions
     needs:
       - pre-commit
-      - slow-tests
     runs-on: ubuntu-latest
     steps:
       - name: Check out tagged commit

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: purepython-aes
-Version: 0.1.0
+Version: 0.3.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.3.0}/src/purepython_aes/__init__.py

@@ -7,10 +7,12 @@ from purepython_aes.aes import (
     AnsiX923Padding,
     BasePadding,
     BlockCipherMode,
+    CbcMode,
     EcbMode,
     Iso7816Padding,
     Iso10126Padding,
     NoPadding,
+    PcbcMode,
     Pkcs7Padding,
     ZeroPadding,
 )
@@ -24,10 +26,12 @@ __all__: list[str] = [
     'AnsiX923Padding',
     'BasePadding',
     'BlockCipherMode',
+    'CbcMode',
     'EcbMode',
     'Iso7816Padding',
     'Iso10126Padding',
     'NoPadding',
+    'PcbcMode',
     'Pkcs7Padding',
     'ZeroPadding',
 ]

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

@@ -1,6 +1,12 @@
 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,
+    PcbcMode,
+)
 from purepython_aes.aes.padding import (
     AnsiX923Padding,
     BasePadding,
@@ -18,7 +24,9 @@ __all__: list[str] = [
     'Aes',
     'AesMode',
     'BlockCipherMode',
+    'CbcMode',
     'EcbMode',
+    'PcbcMode',
     'AnsiX923Padding',
     'BasePadding',
     'Iso7816Padding',

purepython_aes-0.3.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, PcbcMode
+
+__all__: list[str] = ['AesMode', 'BlockCipherMode', 'CbcMode', 'EcbMode', 'PcbcMode']

purepython_aes-0.3.0/src/purepython_aes/aes/modes/block/__init__.py

@@ -0,0 +1,6 @@
+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
+from purepython_aes.aes.modes.block.pcbc import PcbcMode
+
+__all__: list[str] = ['BlockCipherMode', 'CbcMode', 'EcbMode', 'PcbcMode']

{purepython_aes-0.1.0 → purepython_aes-0.3.0}/src/purepython_aes/aes/modes/block/_base.py

@@ -11,13 +11,13 @@ class BlockCipherMode(AesMode, ABC):
     padding: BasePadding
 
     @abstractmethod
-    def encrypt_blocks(self, padded_plaintext: bytes) -> bytes:
+    def __encrypt_blocks__(self, padded_plaintext: bytes) -> bytes:
         """Encrypt plaintext containing complete blocks."""
 
         raise NotImplementedError
 
     @abstractmethod
-    def decrypt_blocks(self, ciphertext: bytes) -> bytes:
+    def __decrypt_blocks__(self, ciphertext: bytes) -> bytes:
         """Decrypt ciphertext containing complete blocks."""
 
         raise NotImplementedError
@@ -25,11 +25,11 @@ class BlockCipherMode(AesMode, ABC):
     def encrypt(self, plaintext: bytes) -> bytes:
         """Pad and encrypt a byte string."""
 
-        return self.encrypt_blocks(self.padding.pad(plaintext))
+        return self.__encrypt_blocks__(self.padding.pad(plaintext))
 
     def decrypt(self, ciphertext: bytes) -> bytes:
         """Decrypt and unpad a byte string."""
 
         if len(ciphertext) % AES_BLOCK_SIZE != 0:
             raise ValueError(f'len(ciphertext) % {AES_BLOCK_SIZE} must be 0')
-        return self.padding.unpad(self.decrypt_blocks(ciphertext))
+        return self.padding.unpad(self.__decrypt_blocks__(ciphertext))

purepython_aes-0.3.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.3.0}/src/purepython_aes/aes/modes/block/ecb.py

@@ -10,12 +10,12 @@ from purepython_aes.aes.modes.operations import split_into_blocks
 class EcbMode(BlockCipherMode):
     """Electronic Codebook mode of operation."""
 
-    def encrypt_blocks(self, padded_plaintext: bytes) -> bytes:
+    def __encrypt_blocks__(self, padded_plaintext: bytes) -> bytes:
         return bytes(0).join(
             map(self.algorithm.encrypt_block, split_into_blocks(padded_plaintext))
         )
 
-    def decrypt_blocks(self, ciphertext: bytes) -> bytes:
+    def __decrypt_blocks__(self, ciphertext: bytes) -> bytes:
         return bytes(0).join(
             map(self.algorithm.decrypt_block, split_into_blocks(ciphertext))
         )

purepython_aes-0.3.0/src/purepython_aes/aes/modes/block/pcbc.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 PcbcMode(BlockCipherMode):
+    """Propagating 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 = xor(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 = xor(block, plaintext_block)
+        return bytes(0).join(plaintext_blocks)

{purepython_aes-0.1.0 → purepython_aes-0.3.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.3.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.3.0}/src/purepython_aes.egg-info/SOURCES.txt

@@ -31,7 +31,9 @@ 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/modes/block/pcbc.py
 src/purepython_aes/aes/padding/__init__.py
 src/purepython_aes/aes/padding/_base.py
 src/purepython_aes/aes/padding/ansix923.py
@@ -65,7 +67,9 @@ 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/modes/block/test_pcbc.py
 tests/unit/aes/padding/__init__.py
 tests/unit/aes/padding/conftest.py
 tests/unit/aes/padding/strategies.py

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

@@ -34,6 +34,8 @@
     "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/pcbc.py",
     "src/purepython_aes/aes/modes/block/ecb.py",
     "src/purepython_aes/aes/algorithms/aes128.py",
     "src/purepython_aes/aes/algorithms/__init__.py",
@@ -64,7 +66,9 @@
     "tests/unit/aes/modes/test_operations.py",
     "tests/unit/aes/modes/__init__.py",
     "tests/unit/aes/modes/block/__init__.py",
+    "tests/unit/aes/modes/block/test_pcbc.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.3.0}/src/purepython_aes.egg-info/scm_version.json

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

purepython_aes-0.3.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.3.0/tests/unit/aes/modes/block/test_pcbc.py

@@ -0,0 +1,70 @@
+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,
+    Iso7816Padding,
+    Iso10126Padding,
+    NoPadding,
+    PcbcMode,
+    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: PcbcMode = PcbcMode(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: PcbcMode = PcbcMode(
+            algorithm=aes(key[:aes.__key_size__]),  # fmt: skip
+            padding=ZeroPadding(),
+        )
+        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: PcbcMode = PcbcMode(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']

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

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