From cd376717159f26e15b1a76ffba19e8e525b93554 Mon Sep 17 00:00:00 2001 From: Benedikt Bartscher Date: Sat, 3 Oct 2026 02:04:19 +0200 Subject: [PATCH 1/4] fix(event): declare LambdaEventCallback.__code__ read-only so bound methods match the protocol --- .../reflex-base/src/reflex_base/event/__init__.py | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/packages/reflex-base/src/reflex_base/event/__init__.py b/packages/reflex-base/src/reflex_base/event/__init__.py index 7874b7b2ff5..e07381e3a69 100644 --- a/packages/reflex-base/src/reflex_base/event/__init__.py +++ b/packages/reflex-base/src/reflex_base/event/__init__.py @@ -2853,7 +2853,17 @@ def __get__(self, instance: Any, owner: Any) -> Callable: class LambdaEventCallback(Protocol[Unpack[P]]): """A protocol for a lambda event callback.""" - __code__: types.CodeType + @property + def __code__(self) -> types.CodeType: + """The code object of the callback. + + Read-only, so a bound method, whose ``__code__`` is a read-only view of + its function's, satisfies the protocol as well as a function or lambda. + + Returns: + The code object. + """ + ... @overload def __call__(self: "LambdaEventCallback[()]") -> Any: ... From 6c6d486b8358c7f08d86e7c8ee8c8fe0baec3077 Mon Sep 17 00:00:00 2001 From: Benedikt Bartscher Date: Sat, 3 Oct 2026 02:33:23 +0200 Subject: [PATCH 2/4] add a news fragment for the read-only LambdaEventCallback.__code__ --- packages/reflex-base/news/7397.bugfix.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 packages/reflex-base/news/7397.bugfix.md diff --git a/packages/reflex-base/news/7397.bugfix.md b/packages/reflex-base/news/7397.bugfix.md new file mode 100644 index 00000000000..75eff655ab1 --- /dev/null +++ b/packages/reflex-base/news/7397.bugfix.md @@ -0,0 +1 @@ +`LambdaEventCallback.__code__` is now read-only, so bound methods such as `ClientStateVar.set_value` match the event handler type in type checkers that require protocol attributes to be writable. From 5ef7f710c0ed776264556930b1f6da4a8b56446a Mon Sep 17 00:00:00 2001 From: Benedikt Bartscher Date: Sat, 3 Oct 2026 11:54:03 +0200 Subject: [PATCH 3/4] test(event): cover the read-only LambdaEventCallback.__code__ --- tests/units/test_event.py | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/tests/units/test_event.py b/tests/units/test_event.py index 63824873e0a..571168cc6e8 100644 --- a/tests/units/test_event.py +++ b/tests/units/test_event.py @@ -1,3 +1,4 @@ +import inspect import json import shutil import subprocess @@ -1206,6 +1207,19 @@ def return_plain_callable_var(_v: Var[Any]) -> Any: ) +def test_lambda_event_callback_only_requires_a_readable_code_object(): + """Bound methods expose a read-only ``__code__``, so the protocol must not need a settable one.""" + + class Handlers: + def on_value(self, value: str) -> None: ... + + assert Handlers().on_value.__code__ is Handlers.on_value.__code__ + + code = inspect.getattr_static(LambdaEventCallback, "__code__") + assert isinstance(code, property) + assert code.fset is None + + def test_event_chain_create_wraps_plain_function_var_kwargs(): """FunctionVars should compose with chain-level kwargs instead of bypassing wrapping.""" frontend_handler = rx.vars.FunctionStringVar.create( From 5264dc4fbdecc784966462ff068bf9472ece4c5b Mon Sep 17 00:00:00 2001 From: Benedikt Bartscher Date: Sat, 17 Oct 2026 18:46:28 +0200 Subject: [PATCH 4/4] Narrow the LambdaEventCallback news fragment to what changes today No released type checker shows bound methods newly matching the event handler type yet: ty still rejects them through astral-sh/ty#4098 and astral-sh/ty#4746. File the fragment as misc and state only that __code__ is now declared read-only. --- packages/reflex-base/news/7397.bugfix.md | 1 - packages/reflex-base/news/7397.misc.md | 1 + 2 files changed, 1 insertion(+), 1 deletion(-) delete mode 100644 packages/reflex-base/news/7397.bugfix.md create mode 100644 packages/reflex-base/news/7397.misc.md diff --git a/packages/reflex-base/news/7397.bugfix.md b/packages/reflex-base/news/7397.bugfix.md deleted file mode 100644 index 75eff655ab1..00000000000 --- a/packages/reflex-base/news/7397.bugfix.md +++ /dev/null @@ -1 +0,0 @@ -`LambdaEventCallback.__code__` is now read-only, so bound methods such as `ClientStateVar.set_value` match the event handler type in type checkers that require protocol attributes to be writable. diff --git a/packages/reflex-base/news/7397.misc.md b/packages/reflex-base/news/7397.misc.md new file mode 100644 index 00000000000..82277b2d6bf --- /dev/null +++ b/packages/reflex-base/news/7397.misc.md @@ -0,0 +1 @@ +`LambdaEventCallback.__code__` is now declared read-only, matching bound methods such as `ClientStateVar.set_value`, whose `__code__` cannot be assigned.