refactor: improve creating new state classes in combine_reducers upon registering/unregistering sub-reducers

feat: add test fixture for snapshot testing the store
chore(test): add test infrastructure for snapshot testing the store
test: move demo files to test files and update the to use snapshot fixture

Author: sassanh

.github/workflows/integration_delivery.yml

@@ -93,6 +93,70 @@ jobs:
       - name: Lint
         run: poetry run poe lint
 
+  test:
+    name: Test
+    needs:
+      - dependencies
+    runs-on: ubuntu-latest
+    environment:
+      name: test
+      url: https://app.codecov.io/gh/${{ github.repository }}/
+    steps:
+      - uses: actions/checkout@v4
+        name: Checkout
+
+      - uses: actions/setup-python@v5
+        name: Setup Python
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+          architecture: x64
+
+      - name: Load Cached Poetry
+        id: cached-poetry
+        uses: actions/cache/restore@v4
+        with:
+          path: |
+            ~/.cache
+            ~/.local
+          key: poetry-${{ hashFiles('poetry.lock') }}
+
+      - name: Test
+        run: poetry run poe test --cov-report=xml --cov-report=html
+
+      - name: Prepare list of JSON files with mismatching pairs
+        if: failure()
+        run: |
+          mkdir -p artifacts
+          for file in $(find tests/ -name "*.mismatch.json"); do
+            base=${file%.mismatch.json}.json
+            if [[ -f "$base" ]]; then
+              echo "$file" >> artifacts/files_to_upload.txt
+              echo "$base" >> artifacts/files_to_upload.txt
+            fi
+          done
+
+      - name: Collect Mismatching Store Snapshots
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: mismatching-snapshots
+          path: |
+            @artifacts/files_to_upload.txt
+
+      - name: Collect HTML Coverage Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: htmlcov
+
+      - name: Upload Coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          flags: integration
+          fail_ci_if_error: true
+          token: ${{ secrets.CODECOV_TOKEN }}
+
   build:
     name: Build
     needs:
@@ -150,6 +214,7 @@ jobs:
     needs:
       - type-check
       - lint
+      - test
       - build
     runs-on: ubuntu-latest
     environment:
@@ -179,11 +244,11 @@ jobs:
     needs:
       - type-check
       - lint
+      - test
       - build
       - pypi-publish
     environment:
       name: release
-      url: https://pypi.org/p/${{ needs.build.outputs.name }}
     runs-on: ubuntu-latest
     permissions:
       contents: write

.gitignore

@@ -45,6 +45,7 @@ nosetests.xml
 coverage.xml
 *.cover
 .hypothesis/
+tests/**/results/*mismatch.json
 
 # Translations
 *.mo

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## Version 0.12.0
+
+- refactor: improve creating new state classes in `combine_reducers` upon registering/unregistering
+  sub-reducers
+- feat: add test fixture for snapshot testing the store
+- chore(test): add test infrastructure for snapshot testing the store
+- test: move demo files to test files and update the to use snapshot fixture
+
 ## Version 0.11.0
 
 - feat: add `keep_ref` parameter to subscriptions and autoruns, defaulting to `True`,

README.md

@@ -1,5 +1,7 @@
 # 🚀 Python Redux
 
+[![codecov](https://codecov.io/gh/sassanh/python-redux/graph/badge.svg?token=4F3EWZRLCL)](https://codecov.io/gh/sassanh/python-redux)
+
 ## 🌟 Overview
 
 Python Redux is a Redux implementation for Python, bringing Redux's state management

poetry.lock

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-redux"
-version = "0.11.0"
+version = "0.12.0"
 description = "Redux implementation for Python"
 authors = ["Sassan Haradji <[email protected]>"]
 license = "Apache-2.0"
@@ -9,7 +9,7 @@ packages = [{ include = "redux" }]
 
 [tool.poetry.dependencies]
 python = "^3.11"
-python-immutable = "^1.0.2"
+python-immutable = "^1.0.5"
 typing-extensions = "^4.9.0"
 
 [tool.poetry.group.dev]
@@ -18,7 +18,9 @@ optional = true
 [tool.poetry.group.dev.dependencies]
 poethepoet = "^0.24.4"
 pyright = "^1.1.354"
-ruff = "^0.3.2"
+ruff = "^0.3.3"
+pytest = "^8.1.1"
+pytest-cov = "^4.1.0"
 
 [build-system]
 requires = ["poetry-core"]
@@ -31,7 +33,8 @@ todo_demo = "todo_demo:main"
 [tool.poe.tasks]
 lint = "ruff check . --unsafe-fixes"
 typecheck = "pyright -p pyproject.toml ."
-sanity = ["typecheck", "lint"]
+test = "pytest --cov=redux --cov-report=term-missing"
+sanity = ["typecheck", "lint", "test"]
 
 [tool.ruff]
 lint.select = ['ALL']
@@ -44,6 +47,9 @@ docstring-quotes = "double"
 inline-quotes = "single"
 multiline-quotes = "double"
 
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["S101"]
+
 [tool.ruff.format]
 quote-style = 'single'
 

pyproject.toml

@@ -5,7 +5,12 @@
     AutorunReturnType,
     AutorunType,
     BaseAction,
+    BaseCombineReducerState,
     BaseEvent,
+    CombineReducerAction,
+    CombineReducerInitAction,
+    CombineReducerRegisterAction,
+    CombineReducerUnregisterAction,
     CompleteReducerResult,
     CreateStoreOptions,
     Dispatch,
@@ -22,14 +27,7 @@
     is_complete_reducer_result,
     is_state_reducer_result,
 )
-from .combine_reducers import (
-    BaseCombineReducerState,
-    CombineReducerAction,
-    CombineReducerInitAction,
-    CombineReducerRegisterAction,
-    CombineReducerUnregisterAction,
-    combine_reducers,
-)
+from .combine_reducers import combine_reducers
 from .main import Store
 
 __all__ = (

redux/__init__.py

@@ -170,3 +170,24 @@ def __call__(
         | None = None,
     ) -> None:
         ...
+
+
+class BaseCombineReducerState(Immutable):
+    _id: str
+
+
+class CombineReducerAction(BaseAction):
+    _id: str
+
+
+class CombineReducerInitAction(CombineReducerAction, InitAction):
+    key: str
+
+
+class CombineReducerRegisterAction(CombineReducerAction):
+    key: str
+    reducer: ReducerType
+
+
+class CombineReducerUnregisterAction(CombineReducerAction):
+    key: str

redux/basic_types.py

@@ -5,16 +5,20 @@
 import functools
 import operator
 import uuid
-from dataclasses import asdict, make_dataclass
+from dataclasses import asdict, fields, make_dataclass
 from typing import TYPE_CHECKING, Any, TypeVar, cast
 
 from .basic_types import (
     Action,
     BaseAction,
+    BaseCombineReducerState,
     BaseEvent,
+    CombineReducerAction,
+    CombineReducerInitAction,
+    CombineReducerRegisterAction,
+    CombineReducerUnregisterAction,
     CompleteReducerResult,
     Event,
-    Immutable,
     InitAction,
     is_complete_reducer_result,
 )
@@ -23,27 +27,6 @@
     from redux import ReducerType
 
 
-class BaseCombineReducerState(Immutable):
-    _id: str
-
-
-class CombineReducerAction(BaseAction):
-    _id: str
-
-
-class CombineReducerInitAction(CombineReducerAction, InitAction):
-    key: str
-
-
-class CombineReducerRegisterAction(CombineReducerAction):
-    key: str
-    reducer: ReducerType
-
-
-class CombineReducerUnregisterAction(CombineReducerAction):
-    key: str
-
-
 CombineReducerState = TypeVar(
     'CombineReducerState',
     bound=BaseCombineReducerState,
@@ -64,7 +47,7 @@ def combine_reducers(
     state_class = cast(
         type[state_type],
         make_dataclass(
-            'combined_reducer',
+            state_type.__name__,
             ('_id', *reducers.keys()),
             frozen=True,
             kw_only=True,
@@ -84,9 +67,10 @@ def combined_reducer(
                 reducer = action.reducer
                 reducers[key] = reducer
                 state_class = make_dataclass(
-                    'combined_reducer',
+                    state_type.__name__,
                     ('_id', *reducers.keys()),
                     frozen=True,
+                    kw_only=True,
                 )
                 reducer_result = reducer(
                     None,
@@ -123,11 +107,16 @@ def combined_reducer(
                 key = action.key
 
                 del reducers[key]
-                fields_copy = copy.copy(cast(Any, state_class).__dataclass_fields__)
+                fields_copy = {field.name: field for field in fields(state_class)}
                 annotations_copy = copy.deepcopy(state_class.__annotations__)
                 del fields_copy[key]
                 del annotations_copy[key]
-                state_class = make_dataclass('combined_reducer', annotations_copy)
+                state_class = make_dataclass(
+                    state_type.__name__,
+                    annotations_copy,
+                    frozen=True,
+                    kw_only=True,
+                )
                 cast(Any, state_class).__dataclass_fields__ = fields_copy
 
                 state = state_class(