reflex 0.8.14a2__tar.gz → 0.8.15__tar.gz

{reflex-0.8.14a2 → reflex-0.8.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex
-Version: 0.8.14a2
+Version: 0.8.15
 Summary: Web apps in pure Python.
 Project-URL: homepage, https://reflex.dev
 Project-URL: repository, https://github.com/reflex-dev/reflex
@@ -18,10 +18,11 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <4.0,>=3.10
 Requires-Dist: alembic<2.0,>=1.15.2
 Requires-Dist: click>=8.2
-Requires-Dist: granian[reload]>=2.4.0
+Requires-Dist: granian[reload]>=2.5.5
 Requires-Dist: httpx<1.0,>=0.23.3
 Requires-Dist: packaging<26,>=24.2
 Requires-Dist: platformdirs<5.0,>=4.3.7
@@ -32,10 +33,14 @@ Requires-Dist: python-socketio<6.0,>=5.12.0
 Requires-Dist: redis<7.0,>=5.2.1
 Requires-Dist: reflex-hosting-cli>=0.1.55
 Requires-Dist: rich<15,>=13
-Requires-Dist: sqlmodel<0.1,>=0.0.24
+Requires-Dist: sqlmodel<0.1,>=0.0.27
 Requires-Dist: starlette>=0.47.0
 Requires-Dist: typing-extensions>=4.13.0
 Requires-Dist: wrapt<2.0,>=1.17.0
+Provides-Extra: db
+Requires-Dist: alembic<2.0,>=1.15.2; extra == 'db'
+Requires-Dist: pydantic<3.0,>=1.10.21; extra == 'db'
+Requires-Dist: sqlmodel<0.1,>=0.0.24; extra == 'db'
 Provides-Extra: monitoring
 Requires-Dist: pyleak<1.0,>=0.1.14; extra == 'monitoring'
 Description-Content-Type: text/markdown

{reflex-0.8.14a2 → reflex-0.8.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reflex"
-version = "0.8.14a2"
+version = "0.8.15"
 description = "Web apps in pure Python."
 license.text = "Apache-2.0"
 authors = [
@@ -22,7 +22,7 @@ requires-python = ">=3.10,<4.0"
 dependencies = [
   "alembic >=1.15.2,<2.0",
   "click >=8.2",
-  "granian[reload] >=2.4.0",
+  "granian[reload] >=2.5.5",
   "httpx >=0.23.3,<1.0",
   "packaging >=24.2,<26",
   "platformdirs >=4.3.7,<5.0",
@@ -33,7 +33,7 @@ dependencies = [
   "redis >=5.2.1,<7.0",
   "reflex-hosting-cli >=0.1.55",
   "rich >=13,<15",
-  "sqlmodel >=0.0.24,<0.1",
+  "sqlmodel >=0.0.27,<0.1",
   "starlette >=0.47.0",
   "typing_extensions >=4.13.0",
   "wrapt >=1.17.0,<2.0",
@@ -47,9 +47,15 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
 ]
 
 [project.optional-dependencies]
+db = [
+  "alembic >=1.15.2,<2.0",
+  "pydantic >=1.10.21,<3.0",
+  "sqlmodel >=0.0.24,<0.1",
+]
 monitoring = ["pyleak >=0.1.14,<1.0"]
 
 [project.urls]
@@ -84,7 +90,7 @@ dev = [
   "pytest-cov",
   "pytest-mock",
   "pytest-playwright",
-  "pytest-retry",
+  "pytest-rerunfailures",
   "pytest-split",
   "pytest",
   "python-dotenv",
@@ -229,7 +235,7 @@ fail_fast = true
 
 [[tool.pre-commit.repos]]
 repo = "https://github.com/astral-sh/ruff-pre-commit"
-rev = "v0.13.2"
+rev = "v0.13.3"
 hooks = [
   { id = "ruff-format", args = [
     "reflex",
@@ -261,7 +267,7 @@ hooks = [
 
 [[tool.pre-commit.repos]]
 repo = "https://github.com/RobertCraigie/pyright-python"
-rev = "v1.1.405"
+rev = "v1.1.406"
 hooks = [{ id = "pyright", args = ["reflex", "tests"], language = "system" }]
 
 [[tool.pre-commit.repos]]

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/.templates/web/utils/state.js

@@ -529,6 +529,14 @@ export const connect = async (
   navigate,
   params,
 ) => {
+  // Socket already allocated, just reconnect it if needed.
+  if (socket.current) {
+    if (!socket.current.connected) {
+      socket.current.reconnect();
+    }
+    return;
+  }
+
   // Get backend URL object from the endpoint.
   const endpoint = getBackendURL(EVENTURL);
   const on_hydrated_queue = [];
@@ -540,7 +548,9 @@ export const connect = async (
     protocols: [reflexEnvironment.version],
     autoUnref: false,
     query: { token: getToken() },
+    reconnection: false, // Reconnection will be handled manually.
   });
+  socket.current.wait_connect = !socket.current.connected;
   // Ensure undefined fields in events are sent as null instead of removed
   socket.current.io.encoder.replacer = (k, v) => (v === undefined ? null : v);
   socket.current.io.decoder.tryParse = (str) => {
@@ -550,6 +560,18 @@ export const connect = async (
       return false;
     }
   };
+  // Set up a reconnect helper function
+  socket.current.reconnect = () => {
+    if (
+      socket.current &&
+      !socket.current.connected &&
+      !socket.current.wait_connect
+    ) {
+      socket.current.wait_connect = true;
+      socket.current.io.opts.query = { token: getToken() }; // Update token for reconnect.
+      socket.current.connect();
+    }
+  };
 
   function checkVisibility() {
     if (document.visibilityState === "visible") {
@@ -565,7 +587,7 @@ export const connect = async (
         );
       } else if (!socket.current.connected) {
         console.log("Socket is disconnected, attempting to reconnect ");
-        socket.current.connect();
+        socket.current.reconnect();
       } else {
         console.log("Socket is reconnected ");
       }
@@ -588,6 +610,7 @@ export const connect = async (
 
   // Once the socket is open, hydrate the page.
   socket.current.on("connect", async () => {
+    socket.current.wait_connect = false;
     setConnectErrors([]);
     window.addEventListener("pagehide", pagehideHandler);
     window.addEventListener("beforeunload", disconnectTrigger);
@@ -599,16 +622,33 @@ export const connect = async (
   });
 
   socket.current.on("connect_error", (error) => {
-    setConnectErrors((connectErrors) => [connectErrors.slice(-9), error]);
+    socket.current.wait_connect = false;
+    let n_connect_errors = 0;
+    setConnectErrors((connectErrors) => {
+      const new_errors = [...connectErrors.slice(-9), error];
+      n_connect_errors = new_errors.length;
+      return new_errors;
+    });
+    window.setTimeout(() => {
+      if (socket.current && !socket.current.connected) {
+        socket.current.reconnect();
+      }
+    }, 200 * n_connect_errors); // Incremental backoff
   });
 
   // When the socket disconnects reset the event_processing flag
-  socket.current.on("disconnect", () => {
-    socket.current = null; // allow reconnect to occur automatically
+  socket.current.on("disconnect", (reason, details) => {
+    socket.current.wait_connect = false;
+    const try_reconnect =
+      reason !== "io server disconnect" && reason !== "io client disconnect";
     event_processing = false;
     window.removeEventListener("unload", disconnectTrigger);
     window.removeEventListener("beforeunload", disconnectTrigger);
     window.removeEventListener("pagehide", pagehideHandler);
+    if (try_reconnect) {
+      // Attempt to reconnect transient non-intentional disconnects.
+      socket.current.reconnect();
+    }
   });
 
   // On each received message, queue the updates and events.
@@ -785,6 +825,7 @@ export const useEventLoop = (
   const [searchParams] = useSearchParams();
   const [connectErrors, setConnectErrors] = useState([]);
   const params = useRef(paramsR);
+  const mounted = useRef(false);
 
   useEffect(() => {
     const { "*": splat, ...remainingParams } = paramsR;
@@ -796,11 +837,16 @@ export const useEventLoop = (
   }, [paramsR]);
 
   const ensureSocketConnected = useCallback(async () => {
+    if (!mounted.current) {
+      // During hot reload, some components may still have a reference to
+      // addEvents, so avoid reconnecting the socket of an unmounted event loop.
+      return;
+    }
     // only use websockets if state is present and backend is not disabled (reflex cloud).
     if (
       Object.keys(initialState).length > 1 &&
       !isBackendDisabled() &&
-      !socket.current
+      !socket.current?.connected
     ) {
       // Initialize the websocket connection.
       await connect(
@@ -813,13 +859,23 @@ export const useEventLoop = (
         () => params.current,
       );
     }
-  }, [socket, dispatch, setConnectErrors, client_storage, navigate, params]);
+  }, [
+    socket,
+    dispatch,
+    setConnectErrors,
+    client_storage,
+    navigate,
+    params,
+    mounted,
+  ]);
 
   // Function to add new events to the event queue.
   const addEvents = useCallback((events, args, event_actions) => {
     const _events = events.filter((e) => e !== undefined && e !== null);
-
-    ensureSocketConnected();
+    if (!event_actions?.temporal) {
+      // Reconnect socket if needed for non-temporal events.
+      ensureSocketConnected();
+    }
 
     if (!(args instanceof Array)) {
       args = [args];
@@ -914,12 +970,16 @@ export const useEventLoop = (
   // Handle socket connect/disconnect.
   useEffect(() => {
     // Initialize the websocket connection.
+    mounted.current = true;
     ensureSocketConnected();
 
     // Cleanup function.
     return () => {
+      mounted.current = false;
       if (socket.current) {
         socket.current.disconnect();
+        socket.current.off();
+        socket.current = null;
       }
     };
   }, []);

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/__init__.py

@@ -84,13 +84,18 @@ In the example above, you will be able to do `rx.list`
 
 from __future__ import annotations
 
-from reflex.utils import (
-    compat,  # for side-effects
-    lazy_loader,
-)
+import sys
+
+from reflex.utils import lazy_loader
+
+if sys.version_info < (3, 11):
+    from reflex.utils import console
 
-# Remove the `compat` name from the namespace, it was imported for side-effects only.
-del compat
+    console.warn(
+        "Reflex support for Python 3.10 is deprecated and will be removed in a future release. Please upgrade to Python 3.11 or higher for continued support."
+    )
+    del console
+del sys
 
 RADIX_THEMES_MAPPING: dict = {
     "components.radix.themes.base": ["color_mode", "theme", "theme_panel"],
@@ -323,7 +328,7 @@ _MAPPING: dict = {
         "SessionStorage",
     ],
     "middleware": ["middleware", "Middleware"],
-    "model": ["asession", "session", "Model"],
+    "model": ["asession", "session", "Model", "ModelRegistry"],
     "page": ["page"],
     "state": [
         "var",

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/__init__.pyi

@@ -3,7 +3,7 @@
 # This file was generated by `reflex/utils/pyi_generator.py`!
 # ------------------------------------------------------
 
-from reflex.utils import compat
+import sys
 
 from . import (
     admin,
@@ -151,7 +151,7 @@ from .experimental import _x
 from .istate.storage import Cookie, LocalStorage, SessionStorage
 from .istate.wrappers import get_state
 from .middleware import Middleware, middleware
-from .model import Model, asession, session
+from .model import Model, ModelRegistry, asession, session
 from .page import page
 from .state import ComponentState, State, dynamic, var
 from .style import Style, toggle_color_mode
@@ -160,7 +160,14 @@ from .utils.misc import run_in_thread
 from .utils.serializers import serializer
 from .vars import Field, Var, field
 
-del compat
+if sys.version_info < (3, 11):
+    from reflex.utils import console
+
+    console.warn(
+        "Reflex support for Python 3.10 is deprecated and will be removed in a future release. Please upgrade to Python 3.11 or higher for continued support."
+    )
+    del console
+del sys
 RADIX_THEMES_MAPPING: dict
 RADIX_THEMES_COMPONENTS_MAPPING: dict
 RADIX_THEMES_LAYOUT_MAPPING: dict
@@ -192,6 +199,7 @@ __all__ = [
     "LocalStorage",
     "Middleware",
     "Model",
+    "ModelRegistry",
     "MomentDelta",
     "NoSSRComponent",
     "PropsBase",

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/app.py

@@ -83,7 +83,6 @@ from reflex.event import (
     get_hydrate_event,
     noop,
 )
-from reflex.model import Model, get_db_status
 from reflex.page import DECORATED_PAGES
 from reflex.route import (
     get_route_args,
@@ -648,7 +647,7 @@ class App(MiddlewareMixin, LifespanMixin):
 
             for api_transformer in api_transformers:
                 if isinstance(api_transformer, Starlette):
-                    # Mount the api to the fastapi app.
+                    # Mount the api to the starlette app.
                     App._add_cors(api_transformer)
                     api_transformer.mount("", asgi_app)
                     asgi_app = api_transformer
@@ -957,6 +956,8 @@ class App(MiddlewareMixin, LifespanMixin):
         try:
             from starlette_admin.contrib.sqla.admin import Admin
             from starlette_admin.contrib.sqla.view import ModelView
+
+            from reflex.model import Model
         except ImportError:
             return
 
@@ -1780,16 +1781,16 @@ async def process(
                     name=f"reflex_emit_reload|{event.name}|{time.time()}|{event.token}",
                 )
                 return
+            router_data[constants.RouteVar.PATH] = "/" + (
+                app.router(path) or "404"
+                if (path := router_data.get(constants.RouteVar.PATH))
+                else "404"
+            ).removeprefix("/")
             # re-assign only when the value is different
             if state.router_data != router_data:
                 # assignment will recurse into substates and force recalculation of
                 # dependent ComputedVar (dynamic route variables)
                 state.router_data = router_data
-                router_data[constants.RouteVar.PATH] = "/" + (
-                    app.router(path) or "404"
-                    if (path := router_data.get(constants.RouteVar.PATH))
-                    else "404"
-                ).removeprefix("/")
                 state.router = RouterData.from_router_data(router_data)
 
             # Preprocess the event.
@@ -1849,6 +1850,8 @@ async def health(_request: Request) -> JSONResponse:
     tasks = []
 
     if prerequisites.check_db_used():
+        from reflex.model import get_db_status
+
         tasks.append(get_db_status())
     if prerequisites.check_redis_used():
         tasks.append(prerequisites.get_redis_status())

reflex-0.8.15/reflex/base.py

@@ -0,0 +1,72 @@
+"""Define the base Reflex class."""
+
+from importlib.util import find_spec
+
+if find_spec("pydantic") and find_spec("pydantic.v1"):
+    from pydantic.v1 import BaseModel
+
+    from reflex.utils.compat import ModelMetaclassLazyAnnotations
+
+    class Base(BaseModel, metaclass=ModelMetaclassLazyAnnotations):
+        """The base class subclassed by all Reflex classes.
+
+        This class wraps Pydantic and provides common methods such as
+        serialization and setting fields.
+
+        Any data structure that needs to be transferred between the
+        frontend and backend should subclass this class.
+        """
+
+        class Config:
+            """Pydantic config."""
+
+            arbitrary_types_allowed = True
+            use_enum_values = True
+            extra = "allow"
+
+        def __init_subclass__(cls):
+            """Warn that rx.Base is deprecated."""
+            from reflex.utils import console
+
+            console.deprecate(
+                feature_name="rx.Base",
+                reason=f"{cls!r} is subclassing rx.Base. You can subclass from `pydantic.BaseModel` directly instead or use dataclasses if possible.",
+                deprecation_version="0.8.15",
+                removal_version="0.9.0",
+            )
+            super().__init_subclass__()
+
+        def json(self) -> str:
+            """Convert the object to a json string.
+
+            Returns:
+                The object as a json string.
+            """
+            from reflex.utils.serializers import serialize
+
+            return self.__config__.json_dumps(
+                self.dict(),
+                default=serialize,
+            )
+else:
+
+    class PydanticNotFoundFallback:
+        """Fallback base class for environments without Pydantic."""
+
+        def __init__(self, *args, **kwargs):
+            """Initialize the base class.
+
+            Args:
+                *args: Positional arguments.
+                **kwargs: Keyword arguments.
+
+            Raises:
+                ImportError: As Pydantic is not installed.
+            """
+            msg = (
+                "Pydantic is not installed. Please install it to use rx.Base."
+                "You can install it with `pip install pydantic`."
+            )
+            raise ImportError(msg)
+
+    Base = PydanticNotFoundFallback  # pyright: ignore[reportAssignmentType]

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/components/datadisplay/dataeditor.py

@@ -2,11 +2,11 @@
 
 from __future__ import annotations
 
+import dataclasses
 from collections.abc import Mapping, Sequence
 from enum import Enum
 from typing import Any, Literal, TypedDict
 
-from reflex.base import Base
 from reflex.components.component import Component, NoSSRComponent
 from reflex.components.literals import LiteralRowMarker
 from reflex.event import EventHandler, no_args_event_spec, passthrough_event_spec
@@ -50,7 +50,8 @@ class GridColumnIcons(Enum):
     VideoUri = "video_uri"
 
 
-class DataEditorTheme(Base):
+@dataclasses.dataclass
+class DataEditorThemeBase:
     """The theme for the DataEditor component."""
 
     accent_color: str | None = None
@@ -87,6 +88,20 @@ class DataEditorTheme(Base):
     text_medium: str | None = None
 
 
+@dataclasses.dataclass(init=False)
+class DataEditorTheme(DataEditorThemeBase):
+    """The theme for the DataEditor component."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the DataEditorTheme.
+
+        Args:
+            **kwargs: The keyword arguments to initialize the theme.
+        """
+        kwargs = {format.to_snake_case(k): v for k, v in kwargs.items()}
+        super().__init__(**kwargs)
+
+
 class Bounds(TypedDict):
     """The bounds of the group header."""
 

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/components/datadisplay/dataeditor.pyi

@@ -3,11 +3,11 @@
 # ------------------- DO NOT EDIT ----------------------
 # This file was generated by `reflex/utils/pyi_generator.py`!
 # ------------------------------------------------------
+import dataclasses
 from collections.abc import Mapping, Sequence
 from enum import Enum
 from typing import Any, Literal, TypedDict
 
-from reflex.base import Base
 from reflex.components.component import NoSSRComponent
 from reflex.components.core.breakpoints import Breakpoints
 from reflex.event import EventType, PointerEventInfo
@@ -43,7 +43,8 @@ class GridColumnIcons(Enum):
     Uri = "uri"
     VideoUri = "video_uri"
 
-class DataEditorTheme(Base):
+@dataclasses.dataclass
+class DataEditorThemeBase:
     accent_color: str | None
     accent_fg: str | None
     accent_light: str | None
@@ -77,6 +78,9 @@ class DataEditorTheme(Base):
     text_light: str | None
     text_medium: str | None
 
+@dataclasses.dataclass(init=False)
+class DataEditorTheme(DataEditorThemeBase): ...
+
 class Bounds(TypedDict):
     x: int
     y: int

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/components/field.py

@@ -7,6 +7,7 @@ from dataclasses import _MISSING_TYPE, MISSING
 from typing import Annotated, Any, Generic, TypeVar, get_origin
 
 from reflex.utils import types
+from reflex.utils.compat import annotations_from_namespace
 
 FIELD_TYPE = TypeVar("FIELD_TYPE")
 
@@ -117,7 +118,8 @@ class FieldBasedMeta(type):
         cls, namespace: dict[str, Any], name: str
     ) -> dict[str, Any]:
         return types.resolve_annotations(
-            namespace.get("__annotations__", {}), namespace["__module__"]
+            annotations_from_namespace(namespace),
+            namespace["__module__"],
         )
 
     @classmethod

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/components/lucide/icon.py

@@ -6,7 +6,7 @@ from reflex.utils.imports import ImportVar
 from reflex.vars.base import LiteralVar, Var
 from reflex.vars.sequence import LiteralStringVar, StringVar
 
-LUCIDE_LIBRARY = "lucide-react@0.544.0"
+LUCIDE_LIBRARY = "lucide-react@0.545.0"
 
 
 class LucideIconComponent(Component):
@@ -1129,6 +1129,7 @@ LUCIDE_ICON_LIST = [
     "monitor",
     "moon_star",
     "moon",
+    "motorbike",
     "mountain_snow",
     "mountain",
     "mouse_off",

{reflex-0.8.14a2 → reflex-0.8.15}/reflex/components/lucide/icon.pyi

@@ -11,7 +11,7 @@ from reflex.components.core.breakpoints import Breakpoints
 from reflex.event import EventType, PointerEventInfo
 from reflex.vars.base import Var
 
-LUCIDE_LIBRARY = "lucide-react@0.544.0"
+LUCIDE_LIBRARY = "lucide-react@0.545.0"
 
 class LucideIconComponent(Component):
     @classmethod
@@ -1194,6 +1194,7 @@ LUCIDE_ICON_LIST = [
     "monitor",
     "moon_star",
     "moon",
+    "motorbike",
     "mountain_snow",
     "mountain",
     "mouse_off",