refactor: Update module imports for improved type checking and Cython/Python fallback, and add __all__ declarations.

Author: zytegalaxy

redux/_combine_reducers.c

@@ -27,6 +27,7 @@ from .basic_types import (
 from immutable import make_immutable
 
 cdef class CombinedReducer:
+    """Cython implementation of combined reducer."""
     cdef object state_type
     cdef object state_class
     cdef dict reducers
@@ -176,6 +177,11 @@ def combine_reducers(
     event_type=BaseEvent,
     **reducers,
 ):
+    """
+    Combine multiple reducers into a single reducer.
+
+    Optimized Cython implementation.
+    """
     id_ = uuid.uuid4().hex
     # Copy reducers dict
     reducers_copy = reducers.copy()

redux/_combine_reducers.pyx

@@ -22,9 +22,6 @@ from redux.basic_types import (
     StoreOptions,
     AutorunOptions,
     ViewOptions,
-    StoreOptions,
-    AutorunOptions,
-    ViewOptions,
     CompleteReducerResult,
     is_state_reducer_result,
     NOT_SET,
@@ -60,7 +57,12 @@ cdef class AwaitableWrapper:
     def awaited(self):
         return self.value[0]
 
-class SubscribeEventCleanup:
+cdef class SubscribeEventCleanup:
+    """Helper class to handle subscription cleanup."""
+    
+    cdef object unsubscribe
+    cdef object handler
+
     def __init__(self, unsubscribe, handler):
         self.unsubscribe = unsubscribe
         self.handler = handler
@@ -69,7 +71,7 @@ class SubscribeEventCleanup:
         return self.unsubscribe()
 
     def __repr__(self):
-        return f'AwaitableWrapper({self.coro}, awaited={self.awaited})'
+        return f'SubscribeEventCleanup(handler={self.handler})'
 from libc.stdlib cimport malloc, free
 
 cdef class Store:
@@ -439,6 +441,7 @@ cdef class Store:
 
 
 cdef class Autorun:
+    """Cython implementation of Autorun."""
     cdef object _store
     cdef object _selector
     cdef object _comparator

redux/_store_core.c

@@ -1,12 +1,18 @@
 """Redux autorun module."""
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from .main import _USE_CYTHON
 
-if _USE_CYTHON:
+if TYPE_CHECKING:
+    from ._autorun_py import Autorun
+elif _USE_CYTHON:
     try:
         from ._store_core import Autorun
     except ImportError:
         from ._autorun_py import Autorun
 else:
     from ._autorun_py import Autorun
+
+__all__ = ('Autorun',)

redux/_store_core.pyx

@@ -1,24 +1,18 @@
+"""Redux combine_reducers module."""
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, TypeVar
+from typing import TYPE_CHECKING
 
-from .basic_types import (
-    BaseCombineReducerState,
-)
+from .main import _USE_CYTHON
 
 if TYPE_CHECKING:
-    from ._combine_reducers_py import combine_reducers as combine_reducers_py
-
-
-CombineReducerState = TypeVar(
-    'CombineReducerState',
-    bound=BaseCombineReducerState,
-)
-
-
-try:
-    from ._combine_reducers import combine_reducers as combine_reducers_cy
-    
-    combine_reducers = combine_reducers_cy
-except ImportError:
     from ._combine_reducers_py import combine_reducers
+elif _USE_CYTHON:
+    try:
+        from ._combine_reducers import combine_reducers
+    except ImportError:
+        from ._combine_reducers_py import combine_reducers
+else:
+    from ._combine_reducers_py import combine_reducers
+
+__all__ = ('combine_reducers',)

redux/autorun.py

@@ -3,12 +3,15 @@
 from __future__ import annotations
 
 import os
+from typing import TYPE_CHECKING
 
 # Re-export basic types for compatibility with legacy imports
-from redux.basic_types import *
+from redux.basic_types import *  # noqa: F403
 _FORCE_PYTHON = os.environ.get('REDUX_FORCE_PYTHON', '0') == '1'
 
-if not _FORCE_PYTHON:
+if TYPE_CHECKING:
+    from redux._store_py import Store
+elif not _FORCE_PYTHON:
     try:
         from redux._store_core import Store
         _USE_CYTHON = True