Merge remote-tracking branch 'origin/main' into add-context-for-lock-expiry

Author: masenf

README.md

@@ -39,25 +39,50 @@ See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architectu
 
 ## ⚙️ Installation
 
-Open a terminal and run (Requires Python 3.10+):
-
-```bash
-pip install reflex
-```
+**Important:** We strongly recommend using a virtual environment to ensure the `reflex` command is available in your PATH.
 
 ## 🥳 Create your first app
 
-Installing `reflex` also installs the `reflex` command line tool.
+### 1. Create the project directory
 
-Test that the install was successful by creating a new project. (Replace `my_app_name` with your project name):
+Replace `my_app_name` with your project name:
 
 ```bash
 mkdir my_app_name
 cd my_app_name
+```
+
+### 2. Set up a virtual environment
+
+Create and activate virtual environment
+
+```bash
+# On Windows:
+python -m venv .venv
+.venv\Scripts\activate
+
+# On macOS/Linux:
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+### 3. Install Reflex
+
+Reflex is available as a pip package (Requires Python 3.10+):
+
+```bash
+pip install reflex
+```
+
+### 4. Initialize the project
+
+This command initializes a template app in your new directory:
+
+```bash
 reflex init
 ```
 
-This command initializes a template app in your new directory.
+### 5. Run the app
 
 You can run this app in development mode:
 
@@ -69,6 +94,10 @@ You should see your app running at http://localhost:3000.
 
 Now you can modify the source code in `my_app_name/my_app_name.py`. Reflex has fast refreshes so you can see your changes instantly when you save your code.
 
+### Troubleshooting
+
+If you installed Reflex without a virtual environment and the `reflex` command is not found, you can run commands using: `python3 -m reflex init` and `python3 -m reflex run`
+
 ## 🫧 Example App
 
 Let's go over an example: creating an image generation UI around [DALL·E](https://platform.openai.com/docs/guides/images/image-generation?context=node). For simplicity, we just call the [OpenAI API](https://platform.openai.com/docs/api-reference/authentication), but you could replace this with an ML model run locally.

pyi_hashes.json

@@ -39,7 +39,7 @@
   "reflex/components/el/elements/tables.pyi": "686eb70ea7d8c4dafb0cc5c284e76184",
   "reflex/components/el/elements/typography.pyi": "684e83dde887dba12badd0fb75c87c04",
   "reflex/components/gridjs/datatable.pyi": "98a7e1b3f3b60cafcdfcd8879750ee42",
-  "reflex/components/lucide/icon.pyi": "ecaa40d72315ff4b8577f22c1537c0f3",
+  "reflex/components/lucide/icon.pyi": "cc0bbb10e53b339b8c8f10c00996768c",
   "reflex/components/markdown/markdown.pyi": "2f84254a548e908020949564fc289339",
   "reflex/components/moment/moment.pyi": "e1952f1c2c82cef85d91e970d1be64ab",
   "reflex/components/plotly/plotly.pyi": "4311a0aae2abcc9226abb6a273f96372",

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reflex"
-version = "0.8.16dev1"
+version = "0.8.17dev1"
 description = "Web apps in pure Python."
 license.text = "Apache-2.0"
 authors = [
@@ -31,12 +31,12 @@ dependencies = [
   "python-multipart >=0.0.20,<1.0",
   "python-socketio >=5.12.0,<6.0",
   "redis >=5.2.1,<7.0",
-  "reflex-hosting-cli >=0.1.55",
+  "reflex-hosting-cli >=0.1.57",
   "rich >=13,<15",
   "sqlmodel >=0.0.27,<0.1",
   "starlette >=0.47.0",
   "typing_extensions >=4.13.0",
-  "wrapt >=1.17.0,<2.0",
+  "wrapt >=1.17.0,<3.0",
 ]
 
 classifiers = [
@@ -243,7 +243,7 @@ fail_fast = true
 
 [[tool.pre-commit.repos]]
 repo = "https://github.com/astral-sh/ruff-pre-commit"
-rev = "v0.14.0"
+rev = "v0.14.1"
 hooks = [
   { id = "ruff-format", args = [
     "reflex",

reflex/components/lucide/icon.py

@@ -6,7 +6,7 @@
 from reflex.vars.base import LiteralVar, Var
 from reflex.vars.sequence import LiteralStringVar, StringVar
 
-LUCIDE_LIBRARY = "lucide-react@0.545.0"
+LUCIDE_LIBRARY = "lucide-react@0.546.0"
 
 
 class LucideIconComponent(Component):
@@ -1115,6 +1115,7 @@ def _get_imports(self):
     "minimize",
     "minus",
     "monitor_check",
+    "monitor_cloud",
     "monitor_cog",
     "monitor_dot",
     "monitor_down",

reflex/components/plotly/plotly.py

@@ -72,7 +72,7 @@ class Plotly(NoSSRComponent):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js@3.1.2"]
 
     tag = "Plot"
 
@@ -303,7 +303,7 @@ class PlotlyBasic(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-basic-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-basic-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly basic component.
@@ -329,7 +329,7 @@ class PlotlyCartesian(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-cartesian-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-cartesian-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly cartesian component.
@@ -355,7 +355,7 @@ class PlotlyGeo(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-geo-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-geo-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly geo component.
@@ -381,7 +381,7 @@ class PlotlyGl3d(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-gl3d-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-gl3d-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly 3d component.
@@ -407,7 +407,7 @@ class PlotlyGl2d(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-gl2d-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-gl2d-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly 2d component.
@@ -433,7 +433,7 @@ class PlotlyMapbox(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-mapbox-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-mapbox-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly mapbox component.
@@ -459,7 +459,7 @@ class PlotlyFinance(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-finance-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-finance-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly finance component.
@@ -485,7 +485,7 @@ class PlotlyStrict(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-strict-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-strict-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly strict component.

reflex/components/recharts/recharts.py

@@ -8,7 +8,7 @@
 class Recharts(Component):
     """A component that wraps a recharts lib."""
 
-    library = "recharts@3.2.1"
+    library = "recharts@3.3.0"
 
     def _get_style(self) -> dict:
         return {"wrapperStyle": self.style}
@@ -17,7 +17,7 @@ def _get_style(self) -> dict:
 class RechartsCharts(NoSSRComponent, MemoizationLeaf):
     """A component that wraps a recharts lib."""
 
-    library = "recharts@3.2.1"
+    library = "recharts@3.3.0"
 
 
 LiteralAnimationEasing = Literal["ease", "ease-in", "ease-out", "ease-in-out", "linear"]

reflex/constants/installer.py

@@ -143,11 +143,11 @@ def DEPENDENCIES(cls) -> dict[str, str]:
         "postcss-import": "16.1.1",
         "@react-router/dev": _react_router_version,
         "@react-router/fs-routes": _react_router_version,
-        "vite": "npm:rolldown-vite@7.1.17",
+        "vite": "npm:rolldown-vite@7.1.18",
     }
     OVERRIDES = {
         # This should always match the `react` version in DEPENDENCIES for recharts compatibility.
         "react-is": _react_version,
         "cookie": "1.0.2",
-        "vite": "npm:rolldown-vite@7.1.17",
+        "vite": "npm:rolldown-vite@7.1.18",
     }

reflex/istate/proxy.py

@@ -198,7 +198,7 @@ def __getattr__(self, name: str) -> Any:
             )
             raise ImmutableStateError(msg)
 
-        value = super().__getattr__(name)
+        value = super().__getattr__(name)  # pyright: ignore[reportAttributeAccessIssue]
         if not name.startswith("_self_") and isinstance(value, MutableProxy):
             # ensure mutations to these containers are blocked unless proxy is _mutable
             return ImmutableMutableProxy(
@@ -397,7 +397,7 @@ class MutableProxy(wrapt.ObjectProxy):
     }
 
     # Dynamically generated classes for tracking dataclass mutations.
-    __dataclass_proxies__: dict[type, type] = {}
+    __dataclass_proxies__: dict[str, type] = {}
 
     def __new__(cls, wrapped: Any, *args, **kwargs) -> MutableProxy:
         """Create a proxy instance for a mutable object that tracks changes.
@@ -427,7 +427,7 @@ def __new__(cls, wrapped: Any, *args, **kwargs) -> MutableProxy:
                     },
                 )
             cls = cls.__dataclass_proxies__[wrapper_cls_name]
-        return super().__new__(cls)
+        return super().__new__(cls)  # pyright: ignore[reportArgumentType]
 
     def __init__(self, wrapped: Any, state: BaseState, field_name: str):
         """Create a proxy for a mutable object that tracks changes.
@@ -543,7 +543,7 @@ def __getattr__(self, __name: str) -> Any:
         Returns:
             The attribute value.
         """
-        value = super().__getattr__(__name)
+        value = super().__getattr__(__name)  # pyright: ignore[reportAttributeAccessIssue]
 
         if callable(value):
             if __name in self.__mark_dirty_attrs__:
@@ -554,7 +554,7 @@ def __getattr__(self, __name: str) -> Any:
                 # Wrap methods that may return mutable objects tied to the state.
                 value = wrapt.FunctionWrapper(
                     value,
-                    self._wrap_recursive_decorator,
+                    self._wrap_recursive_decorator,  # pyright: ignore[reportArgumentType]
                 )
 
             if (
@@ -564,8 +564,8 @@ def __getattr__(self, __name: str) -> Any:
             ):
                 # Wrap methods called on Base subclasses, which might do _anything_
                 return wrapt.FunctionWrapper(
-                    functools.partial(value.__func__, self),  # pyright: ignore [reportFunctionMemberAccess]
-                    self._wrap_recursive_decorator,
+                    functools.partial(value.__func__, self),  # pyright: ignore [reportFunctionMemberAccess, reportAttributeAccessIssue]
+                    self._wrap_recursive_decorator,  # pyright: ignore[reportArgumentType]
                 )
 
         if is_mutable_type(type(value)) and __name not in (
@@ -587,7 +587,7 @@ def __getitem__(self, key: Any) -> Any:
         Returns:
             The item value.
         """
-        value = super().__getitem__(key)
+        value = super().__getitem__(key)  # pyright: ignore[reportAttributeAccessIssue]
         if isinstance(key, slice) and isinstance(value, list):
             return [self._wrap_recursive(item) for item in value]
         # Recursively wrap mutable items retrieved through this proxy.
@@ -599,7 +599,7 @@ def __iter__(self) -> Any:
         Yields:
             Each item value (possibly wrapped in MutableProxy).
         """
-        for value in super().__iter__():
+        for value in super().__iter__():  # pyright: ignore[reportAttributeAccessIssue]
             # Recursively wrap mutable items retrieved through this proxy.
             yield self._wrap_recursive(value)
 
@@ -617,7 +617,7 @@ def __delitem__(self, key: str):
         Args:
             key: The key of the item.
         """
-        self._mark_dirty(super().__delitem__, args=(key,))
+        self._mark_dirty(super().__delitem__, args=(key,))  # pyright: ignore[reportAttributeAccessIssue]
 
     def __setitem__(self, key: str, value: Any):
         """Set the item on the proxied object and mark state dirty.
@@ -626,7 +626,7 @@ def __setitem__(self, key: str, value: Any):
             key: The key of the item.
             value: The value of the item.
         """
-        self._mark_dirty(super().__setitem__, args=(key, value))
+        self._mark_dirty(super().__setitem__, args=(key, value))  # pyright: ignore[reportAttributeAccessIssue]
 
     def __setattr__(self, name: str, value: Any):
         """Set the attribute on the proxied object and mark state dirty.

reflex/plugins/tailwind_v4.py

@@ -17,7 +17,7 @@ class Constants(SimpleNamespace):
     """Tailwind constants."""
 
     # The Tailwindcss version
-    VERSION = "tailwindcss@4.1.14"
+    VERSION = "tailwindcss@4.1.15"
     # The Tailwind config.
     CONFIG = "tailwind.config.js"
     # Default Tailwind content paths
@@ -156,7 +156,7 @@ def get_frontend_development_dependencies(self, **context) -> list[str]:
         return [
             *super().get_frontend_development_dependencies(**context),
             Constants.VERSION,
-            "@tailwindcss/postcss@4.1.14",
+            "@tailwindcss/postcss@4.1.15",
         ]
 
     def pre_compile(self, **context):

reflex/state.py

@@ -523,15 +523,17 @@ def __init_subclass__(cls, mixin: bool = False, **kwargs):
 
         new_backend_vars = {
             name: value if not isinstance(value, Field) else value.default_value()
-            for name, value in list(cls.__dict__.items())
-            if types.is_backend_base_variable(name, cls)
+            for mixin_cls in [*cls._mixins(), cls]
+            for name, value in list(mixin_cls.__dict__.items())
+            if types.is_backend_base_variable(name, mixin_cls)
         }
         # Add annotated backend vars that may not have a default value.
         new_backend_vars.update({
             name: cls._get_var_default(name, annotation_value)
-            for name, annotation_value in cls._get_type_hints().items()
+            for mixin_cls in [*cls._mixins(), cls]
+            for name, annotation_value in mixin_cls._get_type_hints().items()
             if name not in new_backend_vars
-            and types.is_backend_base_variable(name, cls)
+            and types.is_backend_base_variable(name, mixin_cls)
         })
 
         cls.backend_vars = {
@@ -579,9 +581,6 @@ def __init_subclass__(cls, mixin: bool = False, **kwargs):
                     cls.computed_vars[name] = newcv
                     cls.vars[name] = newcv
                     continue
-                if types.is_backend_base_variable(name, mixin_cls):
-                    cls.backend_vars[name] = copy.deepcopy(value)
-                    continue
                 if events.get(name) is not None:
                     continue
                 if not cls._item_is_event_handler(name, value):