feat: add memoization option to autorun, default is True, compatible with old behavior, if set to False, calling the function explicitly will always run it regardless of the selector's value

Author: sassanh

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## Upcoming
+
+- feat: add `memoization` option to `autorun`, default is `True`, compatible with old behavior, if set to `False`, calling the function explicitly will always run it regardless of the selector's value
+
 ## Version 0.19.1
 
 - refactor: provide correct signature for the autorun instance based on the function it decorates

redux/autorun.py

@@ -266,7 +266,8 @@ def __call__(
         **kwargs: AutorunArgs.kwargs,
     ) -> AutorunOriginalReturnType:
         state = self._store._state  # noqa: SLF001
-        if self._check(state) or self._should_be_called or args or kwargs:
+        self._check(state)
+        if self._should_be_called or args or kwargs or not self._options.memoization:
             self._call(*args, **kwargs)
         return cast(AutorunOriginalReturnType, self._latest_value)
 

redux/basic_types.py

@@ -134,6 +134,7 @@ class AutorunOptions(Immutable, Generic[AutorunOriginalReturnType]):
     auto_await: bool = True
     initial_call: bool = True
     reactive: bool = True
+    memoization: bool = True
     keep_ref: bool = True
     subscribers_initial_run: bool = True
     subscribers_keep_ref: bool = True
@@ -207,6 +208,7 @@ def __call__(
 
 class ViewOptions(Immutable, Generic[ViewOriginalReturnType]):
     default_value: ViewOriginalReturnType | None = None
+    memoization: bool = True
     keep_ref: bool = True
     subscribers_initial_run: bool = True
     subscribers_keep_ref: bool = True

redux/main.py

@@ -408,6 +408,7 @@ def decorator(
                     auto_await=True,
                     initial_call=False,
                     reactive=False,
+                    memoization=_options.memoization,
                     keep_ref=_options.keep_ref,
                     subscribers_initial_run=_options.subscribers_initial_run,
                     subscribers_keep_ref=_options.subscribers_keep_ref,

tests/test_autorun.py

@@ -282,6 +282,29 @@ def render(_: int) -> None: ...
     ]
 
 
+def test_task_mode_without_arguments(
+    store: StoreType,
+) -> None:
+    @store.autorun(
+        lambda state: state.value,
+        options=AutorunOptions(
+            reactive=False,
+            initial_call=False,
+            memoization=False,
+        ),
+    )
+    def act(value: int) -> int:
+        assert value == 4, (
+            'This is expected to be called only after the last action is dispatched'
+        )
+        return value
+
+    def check() -> None:
+        assert act() == 4
+
+    store.subscribe_event(FinishEvent, check)
+
+
 def test_view_mode_with_arguments_autorun(
     store: StoreType,
 ) -> None:
@@ -290,6 +313,7 @@ def test_view_mode_with_arguments_autorun(
         options=AutorunOptions(
             reactive=False,
             initial_call=False,
+            memoization=True,
             default_value=0,
         ),
     )