feat(typed_state): add change listener suppression context manager

Add suppress_change_listeners context manager to the TypedState to suppress
any bound callback to any of the typed state field from being triggered in
its context.

Author: Thibault-Pelletier

src/trame_server/utils/typed_state.py

@@ -1,5 +1,6 @@
 import inspect
 from abc import ABC, abstractmethod
+from contextlib import contextmanager
 from dataclasses import MISSING, Field, fields, is_dataclass
 from datetime import date, datetime, time, timezone
 from decimal import Decimal
@@ -650,3 +651,15 @@ def get_sub_state(self, sub_name: V) -> "TypedState[V]":
             data=sub_data,
             name=sub_name,
         )
+
+    @contextmanager
+    def suppress_change_listeners(self):
+        """
+        Suppresses bind_changes callbacks bound to any typed state name from triggering in the current context.
+        Suppression only impacts the server and any state changed will be properly sent to the client.
+        """
+
+        with self.state.suppress_change_listeners(
+            *list(self.get_field_proxy_dict(self.name).keys())
+        ):
+            yield

tests/test_typed_state.py

@@ -545,3 +545,16 @@ def test_encode_decode_supports_collections_of_nested_dataclass(state):
             }
         },
     }
+
+
+def test_can_supress_change_listeners(state):
+    mock = MagicMock()
+
+    typed_state = TypedState(state, MyBiggerData)
+    typed_state.bind_changes({typed_state.name.my_other_data: mock})
+
+    with typed_state.suppress_change_listeners():
+        typed_state.data.my_other_data.a = 53
+
+    state.flush()
+    mock.assert_not_called()