reflex 0.8.1a2__tar.gz → 0.8.2__tar.gz

{reflex-0.8.1a2 → reflex-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex
-Version: 0.8.1a2
+Version: 0.8.2
 Summary: Web apps in pure Python.
 Project-URL: homepage, https://reflex.dev
 Project-URL: repository, https://github.com/reflex-dev/reflex

{reflex-0.8.1a2 → reflex-0.8.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reflex"
-version = "0.8.1a2"
+version = "0.8.2"
 description = "Web apps in pure Python."
 license.text = "Apache-2.0"
 authors = [
@@ -229,7 +229,7 @@ fail_fast = true
 
 [[tool.pre-commit.repos]]
 repo = "https://github.com/astral-sh/ruff-pre-commit"
-rev = "v0.12.1"
+rev = "v0.12.2"
 hooks = [
   { id = "ruff-format", args = [
     "reflex",

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/.templates/apps/blank/code/blank.py

@@ -29,7 +29,6 @@ def index() -> rx.Component:
             justify="center",
             min_height="85vh",
         ),
-        rx.logo(),
     )
 
 

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/app.py

@@ -22,6 +22,7 @@ from collections.abc import (
     Sequence,
 )
 from datetime import datetime
+from itertools import chain
 from pathlib import Path
 from timeit import default_timer as timer
 from types import SimpleNamespace
@@ -238,10 +239,6 @@ def default_error_boundary(*children: Component, **props) -> Component:
     )
 
 
-class OverlayFragment(Fragment):
-    """Alias for Fragment, used to wrap the overlay_component."""
-
-
 @dataclasses.dataclass(frozen=True)
 class UploadFile(StarletteUploadFile):
     """A file uploaded to the server.
@@ -369,6 +366,11 @@ class App(MiddlewareMixin, LifespanMixin):
         )
     )
 
+    # Extra app wraps to be applied to the whole app.
+    extra_app_wraps: dict[tuple[int, str], Callable[[bool], Component | None]] = (
+        dataclasses.field(default_factory=dict)
+    )
+
     # Components to add to the head of every page.
     head_components: list[Component] = dataclasses.field(default_factory=list)
 
@@ -515,8 +517,8 @@ class App(MiddlewareMixin, LifespanMixin):
                 async_mode="asgi",
                 cors_allowed_origins=(
                     "*"
-                    if config.cors_allowed_origins == ["*"]
-                    else config.cors_allowed_origins
+                    if config.cors_allowed_origins == ("*",)
+                    else list(config.cors_allowed_origins)
                 ),
                 cors_credentials=True,
                 max_http_buffer_size=environment.REFLEX_SOCKET_MAX_HTTP_BUFFER_SIZE.get(),
@@ -1031,25 +1033,31 @@ class App(MiddlewareMixin, LifespanMixin):
         # By default, compile the app.
         return True
 
-    def _add_overlay_to_component(self, component: Component) -> Component:
-        if self.overlay_component is None:
-            return component
-
+    def _add_overlay_to_component(
+        self, component: Component, overlay_component: Component
+    ) -> Component:
         children = component.children
-        overlay_component = self._generate_component(self.overlay_component)
 
         if children[0] == overlay_component:
             return component
 
-        # recreate OverlayFragment with overlay_component as first child
-        return OverlayFragment.create(overlay_component, *children)
+        return Fragment.create(overlay_component, *children)
 
     def _setup_overlay_component(self):
         """If a State is not used and no overlay_component is specified, do not render the connection modal."""
-        if self._state is None and self.overlay_component is default_overlay_component:
-            self.overlay_component = None
+        if self.overlay_component is None:
+            return
+        console.deprecate(
+            feature_name="overlay_component",
+            reason="Use `extra_app_wraps` to add the overlay component instead.",
+            deprecation_version="0.8.2",
+            removal_version="0.9.0",
+        )
+        overlay_component = self._generate_component(self.overlay_component)
         for k, component in self._pages.items():
-            self._pages[k] = self._add_overlay_to_component(component)
+            self._pages[k] = self._add_overlay_to_component(
+                component, overlay_component
+            )
 
     def _setup_sticky_badge(self):
         """Add the sticky badge to the app."""
@@ -1261,7 +1269,10 @@ class App(MiddlewareMixin, LifespanMixin):
             app_wrappers[(1, "ToasterProvider")] = toast_provider
 
         # Add the app wraps to the app.
-        for key, app_wrap in self.app_wraps.items():
+        for key, app_wrap in chain(
+            self.app_wraps.items(), self.extra_app_wraps.items()
+        ):
+            # If the app wrap is a callable, generate the component
             component = app_wrap(self._state is not None)
             if component is not None:
                 app_wrappers[key] = component
@@ -2076,9 +2087,20 @@ class EventNamespace(AsyncNamespace):
         # Get the client IP
         try:
             client_ip = environ["asgi.scope"]["client"][0]
+            headers["asgi-scope-client"] = client_ip
         except (KeyError, IndexError):
             client_ip = environ.get("REMOTE_ADDR", "0.0.0.0")
 
+        # Unroll reverse proxy forwarded headers.
+        client_ip = (
+            headers.get(
+                "x-forwarded-for",
+                client_ip,
+            )
+            .partition(",")[0]
+            .strip()
+        )
+
         async with contextlib.aclosing(
             process(self.app, event, sid, headers, client_ip)
         ) as updates_gen:

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/compiler/compiler.py

@@ -828,10 +828,9 @@ def compile_unevaluated_page(
                     enable_state = True
                     break
 
-        from reflex.app import OverlayFragment
         from reflex.utils.format import make_default_page_title
 
-        component = OverlayFragment.create(component)
+        component = Fragment.create(component)
 
         meta_args = {
             "title": (

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/components/base/meta.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from reflex.components.base.bare import Bare
 from reflex.components.el import elements
+from reflex.components.el.elements.metadata import Meta as Meta  # for compatibility
 from reflex.vars.base import Var
 
 
@@ -26,13 +27,6 @@ class Title(elements.Title):
         return super().render()
 
 
-class Meta(elements.Meta):
-    """A component that displays metadata for the current page."""
-
-    # The type of metadata value.
-    property: Var[str]
-
-
 class Description(elements.Meta):
     """A component that displays the title of the current page."""
 

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/components/el/elements/metadata.py

@@ -73,6 +73,9 @@ class Meta(BaseHTML):  # Inherits common attributes from BaseHTML
     # Specifies a name for the metadata
     name: Var[str]
 
+    # The type of metadata value.
+    property: Var[str]
+
 
 class Title(Element):
     """Display the title element."""

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/config.py

@@ -1,21 +1,18 @@
 """The Reflex config."""
 
-from __future__ import annotations
-
+import dataclasses
 import importlib
 import os
 import sys
 import threading
 import urllib.parse
+from collections.abc import Sequence
 from importlib.util import find_spec
 from pathlib import Path
 from types import ModuleType
-from typing import Any, ClassVar
-
-import pydantic.v1 as pydantic
+from typing import TYPE_CHECKING, Any, ClassVar
 
 from reflex import constants
-from reflex.base import Base
 from reflex.constants.base import LogLevel
 from reflex.environment import EnvironmentVariables as EnvironmentVariables
 from reflex.environment import EnvVar as EnvVar
@@ -28,12 +25,13 @@ from reflex.environment import (
 from reflex.environment import env_var as env_var
 from reflex.environment import environment as environment
 from reflex.plugins import Plugin
+from reflex.plugins.sitemap import SitemapPlugin
 from reflex.utils import console
 from reflex.utils.exceptions import ConfigError
-from reflex.utils.types import true_type_for_pydantic_field
 
 
-class DBConfig(Base):
+@dataclasses.dataclass(kw_only=True)
+class DBConfig:
     """Database config."""
 
     engine: str
@@ -51,7 +49,7 @@ class DBConfig(Base):
         password: str | None = None,
         host: str | None = None,
         port: int | None = 5432,
-    ) -> DBConfig:
+    ) -> "DBConfig":
         """Create an instance with postgresql engine.
 
         Args:
@@ -81,7 +79,7 @@ class DBConfig(Base):
         password: str | None = None,
         host: str | None = None,
         port: int | None = 5432,
-    ) -> DBConfig:
+    ) -> "DBConfig":
         """Create an instance with postgresql+psycopg engine.
 
         Args:
@@ -107,7 +105,7 @@ class DBConfig(Base):
     def sqlite(
         cls,
         database: str,
-    ) -> DBConfig:
+    ) -> "DBConfig":
         """Create an instance with sqlite engine.
 
         Args:
@@ -145,32 +143,9 @@ class DBConfig(Base):
 _sensitive_env_vars = {"DB_URL", "ASYNC_DB_URL", "REDIS_URL"}
 
 
-class Config(Base):
-    """The config defines runtime settings for the app.
-
-    By default, the config is defined in an `rxconfig.py` file in the root of the app.
-
-    ```python
-    # rxconfig.py
-    import reflex as rx
-
-    config = rx.Config(
-        app_name="myapp",
-        api_url="http://localhost:8000",
-    )
-    ```
-
-    Every config value can be overridden by an environment variable with the same name in uppercase.
-    For example, `db_url` can be overridden by setting the `DB_URL` environment variable.
-
-    See the [configuration](https://reflex.dev/docs/getting-started/configuration/) docs for more info.
-    """
-
-    class Config:  # pyright: ignore [reportIncompatibleVariableOverride]
-        """Pydantic config for the config."""
-
-        validate_assignment = True
-        use_enum_values = False
+@dataclasses.dataclass(kw_only=True)
+class BaseConfig:
+    """Base config for the Reflex app."""
 
     # The name of the app (should match the name of the app directory).
     app_name: str
@@ -218,13 +193,13 @@ class Config(Base):
     static_page_generation_timeout: int = 60
 
     # List of origins that are allowed to connect to the backend API.
-    cors_allowed_origins: list[str] = ["*"]
+    cors_allowed_origins: Sequence[str] = dataclasses.field(default=("*",))
 
     # Whether to use React strict mode.
     react_strict_mode: bool = True
 
     # Additional frontend packages to install.
-    frontend_packages: list[str] = []
+    frontend_packages: list[str] = dataclasses.field(default_factory=list)
 
     # Indicate which type of state manager to use
     state_manager_mode: constants.StateManagerMode = constants.StateManagerMode.DISK
@@ -239,7 +214,9 @@ class Config(Base):
     redis_token_expiration: int = constants.Expiration.TOKEN
 
     # Attributes that were explicitly set by the user.
-    _non_default_attributes: set[str] = pydantic.PrivateAttr(set())
+    _non_default_attributes: set[str] = dataclasses.field(
+        default_factory=set, init=False
+    )
 
     # Path to file containing key-values pairs to override in the environment; Dotenv format.
     env_file: str | None = None
@@ -257,21 +234,58 @@ class Config(Base):
     extra_overlay_function: str | None = None
 
     # List of plugins to use in the app.
-    plugins: list[Plugin] = []
+    plugins: list[Plugin] = dataclasses.field(default_factory=list)
+
+    # List of fully qualified import paths of plugins to disable in the app (e.g. reflex.plugins.sitemap.SitemapPlugin).
+    disable_plugins: list[str] = dataclasses.field(default_factory=list)
 
     _prefixes: ClassVar[list[str]] = ["REFLEX_"]
 
-    def __init__(self, *args, **kwargs):
-        """Initialize the config values.
+
+_PLUGINS_ENABLED_BY_DEFAULT = [
+    SitemapPlugin,
+]
+
+
+@dataclasses.dataclass(kw_only=True, init=False)
+class Config(BaseConfig):
+    """The config defines runtime settings for the app.
+
+    By default, the config is defined in an `rxconfig.py` file in the root of the app.
+
+    ```python
+    # rxconfig.py
+    import reflex as rx
+
+    config = rx.Config(
+        app_name="myapp",
+        api_url="http://localhost:8000",
+    )
+    ```
+
+    Every config value can be overridden by an environment variable with the same name in uppercase and a REFLEX_ prefix.
+    For example, `db_url` can be overridden by setting the `REFLEX_DB_URL` environment variable.
+
+    See the [configuration](https://reflex.dev/docs/getting-started/configuration/) docs for more info.
+    """
+
+    def _post_init(self, **kwargs):
+        """Post-initialization method to set up the config.
+
+        This method is called after the config is initialized. It sets up the
+        environment variables, updates the config from the environment, and
+        replaces default URLs if ports were set.
 
         Args:
-            *args: The args to pass to the Pydantic init method.
-            **kwargs: The kwargs to pass to the Pydantic init method.
+            **kwargs: The kwargs passed to the Pydantic init method.
 
         Raises:
             ConfigError: If some values in the config are invalid.
         """
-        super().__init__(*args, **kwargs)
+        class_fields = self.class_fields()
+        for key, value in kwargs.items():
+            if key not in class_fields:
+                setattr(self, key, value)
 
         # Clean up this code when we remove plain envvar in 0.8.0
         env_loglevel = os.environ.get("REFLEX_LOGLEVEL")
@@ -285,9 +299,12 @@ class Config(Base):
         for key, env_value in env_kwargs.items():
             setattr(self, key, env_value)
 
+        # Add builtin plugins if not disabled.
+        self._add_builtin_plugins()
+
         #   Update default URLs if ports were set
         kwargs.update(env_kwargs)
-        self._non_default_attributes.update(kwargs)
+        self._non_default_attributes = set(kwargs.keys())
         self._replace_defaults(**kwargs)
 
         if (
@@ -297,6 +314,74 @@ class Config(Base):
             msg = f"{self._prefixes[0]}REDIS_URL is required when using the redis state manager."
             raise ConfigError(msg)
 
+    def _add_builtin_plugins(self):
+        """Add the builtin plugins to the config."""
+        for plugin in _PLUGINS_ENABLED_BY_DEFAULT:
+            plugin_name = plugin.__module__ + "." + plugin.__qualname__
+            if plugin_name not in self.disable_plugins:
+                if not any(isinstance(p, plugin) for p in self.plugins):
+                    console.warn(
+                        f"`{plugin_name}` plugin is enabled by default, but not explicitly added to the config. "
+                        "If you want to use it, please add it to the `plugins` list in your config inside of `rxconfig.py`. "
+                        f"To disable this plugin, set `disable_plugins` to `{[plugin_name, *self.disable_plugins]!r}`.",
+                    )
+                    self.plugins.append(plugin())
+            else:
+                if any(isinstance(p, plugin) for p in self.plugins):
+                    console.warn(
+                        f"`{plugin_name}` is disabled in the config, but it is still present in the `plugins` list. "
+                        "Please remove it from the `plugins` list in your config inside of `rxconfig.py`.",
+                    )
+
+        for disabled_plugin in self.disable_plugins:
+            if not isinstance(disabled_plugin, str):
+                console.warn(
+                    f"reflex.Config.disable_plugins should only contain strings, but got {disabled_plugin!r}. "
+                )
+            if not any(
+                plugin.__module__ + "." + plugin.__qualname__ == disabled_plugin
+                for plugin in _PLUGINS_ENABLED_BY_DEFAULT
+            ):
+                console.warn(
+                    f"`{disabled_plugin}` is disabled in the config, but it is not a built-in plugin. "
+                    "Please remove it from the `disable_plugins` list in your config inside of `rxconfig.py`.",
+                )
+
+    @classmethod
+    def class_fields(cls) -> set[str]:
+        """Get the fields of the config class.
+
+        Returns:
+            The fields of the config class.
+        """
+        return {field.name for field in dataclasses.fields(cls)}
+
+    if not TYPE_CHECKING:
+
+        def __init__(self, **kwargs):
+            """Initialize the config values.
+
+            Args:
+                **kwargs: The kwargs to pass to the Pydantic init method.
+
+            # noqa: DAR101 self
+            """
+            class_fields = self.class_fields()
+            super().__init__(**{k: v for k, v in kwargs.items() if k in class_fields})
+            self._post_init(**kwargs)
+
+    def json(self) -> str:
+        """Get the config as a JSON string.
+
+        Returns:
+            The config as a JSON string.
+        """
+        import json
+
+        from reflex.utils.serializers import serialize
+
+        return json.dumps(self, default=serialize)
+
     @property
     def app_module(self) -> ModuleType | None:
         """Return the app module if `app_module_import` is set.
@@ -333,11 +418,13 @@ class Config(Base):
 
         updated_values = {}
         # Iterate over the fields.
-        for key, field in self.__fields__.items():
+        for field in dataclasses.fields(self):
             # The env var name is the key in uppercase.
             environment_variable = None
             for prefix in self._prefixes:
-                if environment_variable := os.environ.get(f"{prefix}{key.upper()}"):
+                if environment_variable := os.environ.get(
+                    f"{prefix}{field.name.upper()}"
+                ):
                     break
 
             # If the env var is set, override the config value.
@@ -345,19 +432,19 @@ class Config(Base):
                 # Interpret the value.
                 value = interpret_env_var_value(
                     environment_variable,
-                    true_type_for_pydantic_field(field),
+                    field.type,
                     field.name,
                 )
 
                 # Set the value.
-                updated_values[key] = value
+                updated_values[field.name] = value
 
-                if key.upper() in _sensitive_env_vars:
+                if field.name.upper() in _sensitive_env_vars:
                     environment_variable = "***"
 
-                if value != getattr(self, key):
+                if value != getattr(self, field.name):
                     console.debug(
-                        f"Overriding config value {key} with env var {key.upper()}={environment_variable}",
+                        f"Overriding config value {field.name} with env var {field.name.upper()}={environment_variable}",
                         dedupe=True,
                     )
         return updated_values

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/constants/installer.py

@@ -14,7 +14,7 @@ class Bun(SimpleNamespace):
     """Bun constants."""
 
     # The Bun version.
-    VERSION = "1.2.17"
+    VERSION = "1.2.18"
 
     # Min Bun Version
     MIN_VERSION = "1.2.17"
@@ -104,7 +104,7 @@ class PackageJson(SimpleNamespace):
     class Commands(SimpleNamespace):
         """The commands to define in package.json."""
 
-        DEV = "react-router dev"
+        DEV = "react-router dev --host"
         EXPORT = "react-router build"
         PROD = "serve ./build/client"
 
@@ -143,10 +143,11 @@ class PackageJson(SimpleNamespace):
         "postcss-import": "16.1.1",
         "@react-router/dev": _react_router_version,
         "@react-router/fs-routes": _react_router_version,
-        "rolldown-vite": "7.0.5",
+        "rolldown-vite": "7.0.8",
     }
     OVERRIDES = {
         # This should always match the `react` version in DEPENDENCIES for recharts compatibility.
         "react-is": _react_version,
         "cookie": "1.0.2",
+        "rollup": "4.44.2",
     }

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/environment.py

@@ -10,7 +10,7 @@ import inspect
 import multiprocessing
 import os
 import platform
-from collections.abc import Callable
+from collections.abc import Callable, Sequence
 from functools import lru_cache
 from pathlib import Path
 from typing import (
@@ -227,7 +227,7 @@ def interpret_env_var_value(
         return interpret_existing_path_env(value, field_name)
     if field_type is Plugin:
         return interpret_plugin_env(value, field_name)
-    if get_origin(field_type) is list:
+    if get_origin(field_type) in (list, Sequence):
         return [
             interpret_env_var_value(
                 v,

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/istate/data.py

@@ -202,8 +202,8 @@ class RouterData:
             The PageData object.
         """
         console.deprecate(
-            "RouterData.page",
-            "Use RouterData.url instead",
+            feature_name="RouterData.page",
+            reason="Use RouterData.url instead",
             deprecation_version="0.8.1",
             removal_version="0.9.0",
         )

reflex-0.8.2/reflex/plugins/__init__.py

@@ -0,0 +1,15 @@
+"""Reflex Plugin System."""
+
+from .base import CommonContext, Plugin, PreCompileContext
+from .sitemap import SitemapPlugin
+from .tailwind_v3 import TailwindV3Plugin
+from .tailwind_v4 import TailwindV4Plugin
+
+__all__ = [
+    "CommonContext",
+    "Plugin",
+    "PreCompileContext",
+    "SitemapPlugin",
+    "TailwindV3Plugin",
+    "TailwindV4Plugin",
+]

{reflex-0.8.1a2 → reflex-0.8.2}/reflex/plugins/sitemap.py

@@ -193,7 +193,7 @@ def sitemap_task(unevaluated_pages: Sequence["UnevaluatedPage"]) -> tuple[str, s
     )
 
 
-class Plugin(PluginBase):
+class SitemapPlugin(PluginBase):
     """Sitemap plugin for Reflex."""
 
     def pre_compile(self, **context):
@@ -204,3 +204,6 @@ class Plugin(PluginBase):
         """
         unevaluated_pages = context.get("unevaluated_pages", [])
         context["add_save_task"](sitemap_task, unevaluated_pages)
+
+
+Plugin = SitemapPlugin