reflex 0.7.11__py3-none-any.whl → 0.7.12__py3-none-any.whl

reflex/components/recharts/general.pyi

@@ -33,6 +33,7 @@ class ResponsiveContainer(Recharts, MemoizationLeaf):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -68,6 +69,7 @@ class ResponsiveContainer(Recharts, MemoizationLeaf):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -134,6 +136,7 @@ class Legend(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -180,6 +183,7 @@ class Legend(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -223,6 +227,7 @@ class GraphingTooltip(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -266,6 +271,7 @@ class GraphingTooltip(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -335,6 +341,7 @@ class Label(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -366,6 +373,7 @@ class Label(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -436,6 +444,7 @@ class LabelList(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -468,6 +477,7 @@ class LabelList(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -493,6 +503,7 @@ class Cell(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -522,6 +533,7 @@ class Cell(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute

reflex/components/recharts/polar.pyi

@@ -80,6 +80,7 @@ class Pie(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -121,6 +122,7 @@ class Pie(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -189,6 +191,7 @@ class Radar(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -215,6 +218,7 @@ class Radar(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -281,6 +285,7 @@ class RadialBar(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -311,6 +316,7 @@ class RadialBar(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -348,6 +354,7 @@ class PolarAngleAxis(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -395,6 +402,7 @@ class PolarAngleAxis(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -428,6 +436,7 @@ class PolarGrid(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -463,6 +472,7 @@ class PolarGrid(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -540,6 +550,7 @@ class PolarRadiusAxis(Recharts):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -571,6 +582,7 @@ class PolarRadiusAxis(Recharts):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute

reflex/components/recharts/recharts.pyi

@@ -24,6 +24,7 @@ class Recharts(Component):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -51,6 +52,7 @@ class Recharts(Component):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
@@ -74,6 +76,7 @@ class RechartsCharts(NoSSRComponent, MemoizationLeaf):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -101,6 +104,7 @@ class RechartsCharts(NoSSRComponent, MemoizationLeaf):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute

reflex/components/sonner/toast.pyi

@@ -126,6 +126,7 @@ class Toaster(Component):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -167,6 +168,7 @@ class Toaster(Component):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute

reflex/components/suneditor/editor.pyi

@@ -124,6 +124,7 @@ class Editor(NoSSRComponent):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -184,6 +185,7 @@ class Editor(NoSSRComponent):
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
+            ref: The Var to pass as the ref to the component.
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute

reflex/config.py

@@ -748,6 +748,9 @@ class EnvironmentVariables:
     # The timeout to wait for a pong from the websocket server in seconds.
     REFLEX_SOCKET_TIMEOUT: EnvVar[int] = env_var(constants.Ping.TIMEOUT)
 
+    # Whether to run Granian in a spawn process. This enables Reflex to pick up on environment variable changes between hot reloads.
+    REFLEX_STRICT_HOT_RELOAD: EnvVar[bool] = env_var(False)
+
 
 environment = EnvironmentVariables()
 

reflex/constants/compiler.py

@@ -171,6 +171,12 @@ class MemoizationMode:
     recursive: bool = True
 
 
+DATA_UNDERSCORE = "data_"
+DATA_DASH = "data-"
+ARIA_UNDERSCORE = "aria_"
+ARIA_DASH = "aria-"
+
+
 class SpecialAttributes(enum.Enum):
     """Special attributes for components.
 
@@ -178,11 +184,6 @@ class SpecialAttributes(enum.Enum):
     to a style prop.
     """
 
-    DATA_UNDERSCORE = "data_"
-    DATA_DASH = "data-"
-    ARIA_UNDERSCORE = "aria_"
-    ARIA_DASH = "aria-"
-
     @classmethod
     def is_special(cls, attr: str) -> bool:
         """Check if the attribute is special.
@@ -193,4 +194,9 @@ class SpecialAttributes(enum.Enum):
         Returns:
             True if the attribute is special.
         """
-        return any(attr.startswith(value.value) for value in cls)
+        return (
+            attr.startswith(DATA_UNDERSCORE)
+            or attr.startswith(DATA_DASH)
+            or attr.startswith(ARIA_UNDERSCORE)
+            or attr.startswith(ARIA_DASH)
+        )

reflex/constants/installer.py

@@ -14,7 +14,7 @@ class Bun(SimpleNamespace):
     """Bun constants."""
 
     # The Bun version.
-    VERSION = "1.2.12"
+    VERSION = "1.2.13"
 
     # Min Bun Version
     MIN_VERSION = "1.2.8"

reflex/event.py

@@ -14,6 +14,7 @@ from typing import (
     Annotated,
     Any,
     Generic,
+    NoReturn,
     Protocol,
     TypedDict,
     TypeVar,
@@ -1683,6 +1684,16 @@ prevent_default = noop().prevent_default
 class EventVar(ObjectVar, python_types=(EventSpec, EventHandler)):
     """Base class for event vars."""
 
+    def bool(self) -> NoReturn:
+        """Get the boolean value of the var.
+
+        Raises:
+            TypeError: EventVar cannot be converted to a boolean.
+        """
+        raise TypeError(
+            f"Cannot convert {self._js_expr} of type {type(self).__name__} to bool."
+        )
+
 
 @dataclasses.dataclass(
     eq=False,
@@ -1759,6 +1770,16 @@ class LiteralEventVar(VarOperationCall, LiteralVar, EventVar):
 class EventChainVar(BuilderFunctionVar, python_types=EventChain):
     """Base class for event chain vars."""
 
+    def bool(self) -> NoReturn:
+        """Get the boolean value of the var.
+
+        Raises:
+            TypeError: EventChainVar cannot be converted to a boolean.
+        """
+        raise TypeError(
+            f"Cannot convert {self._js_expr} of type {type(self).__name__} to bool."
+        )
+
 
 @dataclasses.dataclass(
     eq=False,

reflex/experimental/layout.pyi

@@ -207,6 +207,7 @@ class Sidebar(Box, MemoizationLeaf):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -276,6 +277,7 @@ class DrawerSidebar(DrawerRoot):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -330,6 +332,7 @@ class SidebarTrigger(Fragment):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -553,6 +556,7 @@ class Layout(Box):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
@@ -779,6 +783,7 @@ class LayoutNamespace(ComponentNamespace):
         | None = None,
         key: Any | None = None,
         id: Any | None = None,
+        ref: Var | None = None,
         class_name: Any | None = None,
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,

reflex/reflex.py

@@ -351,6 +351,30 @@ def run(
     )
 
 
+@cli.command()
+@loglevel_option
+@click.option(
+    "--dry",
+    is_flag=True,
+    default=False,
+    help="Run the command without making any changes.",
+)
+def compile(dry: bool):
+    """Compile the app in the current directory."""
+    import time
+
+    from reflex.utils import prerequisites
+
+    # Check the app.
+    if prerequisites.needs_reinit():
+        _init(name=get_config().app_name)
+    get_config(reload=True)
+    starting_time = time.monotonic()
+    prerequisites.compile_app(dry_run=dry)
+    elapsed_time = time.monotonic() - starting_time
+    console.success(f"App compiled successfully in {elapsed_time:.3f} seconds.")
+
+
 @cli.command()
 @loglevel_option
 @click.option(

reflex/testing.py

@@ -14,6 +14,7 @@ import signal
 import socket
 import socketserver
 import subprocess
+import sys
 import textwrap
 import threading
 import time
@@ -475,7 +476,7 @@ class AppHarness:
             frontend_children = psutil.Process(self.frontend_process.pid).children(
                 recursive=True,
             )
-            if platform.system() == "Windows":
+            if sys.platform == "win32":
                 self.frontend_process.terminate()
             else:
                 pgrp = os.getpgid(self.frontend_process.pid)

reflex/utils/exec.py

@@ -384,6 +384,11 @@ def run_granian_backend(host: str, port: int, loglevel: LogLevel):
     """
     console.debug("Using Granian for backend")
 
+    if environment.REFLEX_STRICT_HOT_RELOAD.get():
+        import multiprocessing
+
+        multiprocessing.set_start_method("spawn", force=True)
+
     from granian.constants import Interfaces
     from granian.log import LogLevels
     from granian.server import MPServer as Granian

reflex/utils/format.py

@@ -436,19 +436,12 @@ def format_props(*single_props, **key_value_props) -> list[str]:
         The formatted props list.
     """
     # Format all the props.
-    from reflex.vars.base import LiteralVar, Var
+    from reflex.vars import LiteralStringVar, LiteralVar, Var
 
     return [
-        ":".join(
-            [
-                str(name if "-" not in name else LiteralVar.create(name)),
-                str(
-                    format_prop(
-                        prop if isinstance(prop, Var) else LiteralVar.create(prop)
-                    )
-                ),
-            ]
-        )
+        (str(LiteralStringVar.create(name)) if "-" in name else name)
+        + ":"
+        + str(format_prop(prop if isinstance(prop, Var) else LiteralVar.create(prop)))
         for name, prop in sorted(key_value_props.items())
         if prop is not None
     ] + [(f"...{LiteralVar.create(prop)!s}") for prop in single_props]

reflex/utils/net.py

@@ -8,6 +8,7 @@ from typing import ParamSpec, TypeVar
 import httpx
 
 from reflex.utils.decorator import once
+from reflex.utils.types import Unset
 
 from . import console
 
@@ -63,6 +64,30 @@ def _wrap_https_func(
     return wrapper
 
 
+def _wrap_https_lazy_func(
+    func: Callable[[], Callable[_P, _T]],
+) -> Callable[_P, _T]:
+    """Wrap an HTTPS function with logging.
+
+    Args:
+        func: The function to wrap.
+
+    Returns:
+        The wrapped function.
+    """
+    unset = Unset()
+    f: Callable[_P, _T] | Unset = unset
+
+    def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> _T:
+        nonlocal f
+        if isinstance(f, Unset):
+            f = _wrap_https_func(func())
+            functools.update_wrapper(wrapper, f)
+        return f(*args, **kwargs)
+
+    return wrapper
+
+
 def _is_ipv4_supported() -> bool:
     """Determine if the system supports IPv4.
 
@@ -120,12 +145,20 @@ def _httpx_client() -> httpx.Client:
     Returns:
         An HTTPX client.
     """
+    from httpx._utils import get_environment_proxies
+
     return httpx.Client(
         transport=httpx.HTTPTransport(
             local_address=_httpx_local_address_kwarg(),
             verify=_httpx_verify_kwarg(),
-        )
+        ),
+        mounts={
+            key: (
+                None if url is None else httpx.HTTPTransport(proxy=httpx.Proxy(url=url))
+            )
+            for key, url in get_environment_proxies().items()
+        },
     )
 
 
-get = _wrap_https_func(_httpx_client().get)
+get = _wrap_https_lazy_func(lambda: _httpx_client().get)

reflex/utils/prerequisites.py

@@ -431,12 +431,15 @@ def validate_app(reload: bool = False) -> None:
     get_and_validate_app(reload=reload)
 
 
-def get_compiled_app(reload: bool = False, export: bool = False) -> ModuleType:
+def get_compiled_app(
+    reload: bool = False, export: bool = False, dry_run: bool = False
+) -> ModuleType:
     """Get the app module based on the default config after first compiling it.
 
     Args:
         reload: Re-import the app module from disk
         export: Compile the app for export
+        dry_run: If True, do not write the compiled app to disk.
 
     Returns:
         The compiled app based on the default config.
@@ -445,18 +448,21 @@ def get_compiled_app(reload: bool = False, export: bool = False) -> ModuleType:
     # For py3.9 compatibility when redis is used, we MUST add any decorator pages
     # before compiling the app in a thread to avoid event loop error (REF-2172).
     app._apply_decorated_pages()
-    app._compile(export=export)
+    app._compile(export=export, dry_run=dry_run)
     return app_module
 
 
-def compile_app(reload: bool = False, export: bool = False) -> None:
+def compile_app(
+    reload: bool = False, export: bool = False, dry_run: bool = False
+) -> None:
     """Compile the app module based on the default config.
 
     Args:
         reload: Re-import the app module from disk
         export: Compile the app for export
+        dry_run: If True, do not write the compiled app to disk.
     """
-    get_compiled_app(reload=reload, export=export)
+    get_compiled_app(reload=reload, export=export, dry_run=dry_run)
 
 
 def _can_colorize() -> bool:

reflex/utils/pyi_generator.py

@@ -221,6 +221,12 @@ def _get_type_hint(
             if ev.__name__ == "Var"
             else value
         )
+    elif isinstance(value, list):
+        res = [
+            _get_type_hint(arg, type_hint_globals, rx_types.is_optional(arg))
+            for arg in value
+        ]
+        return f"[{', '.join(res)}]"
     else:
         res = value.__name__
     if is_optional and not res.startswith("Optional") and not res.endswith("| None"):
@@ -1029,7 +1035,7 @@ class StubGenerator(ast.NodeTransformer):
             return node
         if isinstance(node.target, ast.Name) and node.target.id.startswith("_"):
             return None
-        if self.current_class in self.classes:
+        if self._current_class_is_component():
             # Remove annotated assignments in Component classes (props)
             return None
         # Blank out assignments in type stubs.

reflex/utils/types.py

@@ -24,17 +24,13 @@ from typing import (  # noqa: UP035
     _GenericAlias,  # pyright: ignore [reportAttributeAccessIssue]
     _SpecialGenericAlias,  # pyright: ignore [reportAttributeAccessIssue]
     get_args,
+    is_typeddict,
 )
 from typing import get_origin as get_origin_og
 from typing import get_type_hints as get_type_hints_og
 
-import sqlalchemy
 from pydantic.v1.fields import ModelField
-from sqlalchemy.ext.associationproxy import AssociationProxyInstance
-from sqlalchemy.ext.hybrid import hybrid_property
-from sqlalchemy.orm import DeclarativeBase, Mapped, QueryableAttribute, Relationship
 from typing_extensions import Self as Self
-from typing_extensions import is_typeddict
 from typing_extensions import override as override
 
 import reflex
@@ -331,6 +327,8 @@ def get_property_hint(attr: Any | None) -> GenericType | None:
     Returns:
         The type hint of the property, if it is a property, else None.
     """
+    from sqlalchemy.ext.hybrid import hybrid_property
+
     if not isinstance(attr, (property, hybrid_property)):
         return None
     hints = get_type_hints(attr.fget)
@@ -349,6 +347,10 @@ def get_attribute_access_type(cls: GenericType, name: str) -> GenericType | None
     Returns:
         The type of the attribute, if accessible, or None
     """
+    import sqlalchemy
+    from sqlalchemy.ext.associationproxy import AssociationProxyInstance
+    from sqlalchemy.orm import DeclarativeBase, Mapped, QueryableAttribute, Relationship
+
     from reflex.model import Model
 
     try: