reflex 0.8.1a1__py3-none-any.whl → 0.8.2a1__py3-none-any.whl

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")
@@ -280,6 +294,9 @@ class Config(Base):
         if env_loglevel or self.loglevel != LogLevel.DEFAULT:
             console.set_log_level(env_loglevel or self.loglevel)
 
+        # Add builtin plugins if not disabled.
+        self._add_builtin_plugins()
+
         # Update the config from environment variables.
         env_kwargs = self.update_from_env()
         for key, env_value in env_kwargs.items():
@@ -287,7 +304,7 @@ class Config(Base):
 
         #   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/constants/compiler.py

@@ -85,7 +85,7 @@ class PageNames(SimpleNamespace):
     # The name of the index page.
     INDEX_ROUTE = "index"
     # The name of the app root page.
-    APP_ROOT = "root.js"
+    APP_ROOT = "root.jsx"
     # The root stylesheet filename.
     STYLESHEET_ROOT = "__reflex_global_styles"
     # The name of the document root page.

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,7 +143,7 @@ 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.3",
+        "rolldown-vite": "7.0.8",
     }
     OVERRIDES = {
         # This should always match the `react` version in DEPENDENCIES for recharts compatibility.

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/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/plugins/__init__.py

@@ -1,8 +1,15 @@
 """Reflex Plugin System."""
 
-from .base import CommonContext as CommonContext
-from .base import Plugin as Plugin
-from .base import PreCompileContext as PreCompileContext
-from .sitemap import Plugin as SitemapPlugin
-from .tailwind_v3 import TailwindV3Plugin as TailwindV3Plugin
-from .tailwind_v4 import TailwindV4Plugin as TailwindV4Plugin
+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/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

reflex/utils/console.py

@@ -79,7 +79,7 @@ def is_debug() -> bool:
     return _LOG_LEVEL <= LogLevel.DEBUG
 
 
-def print(msg: str, dedupe: bool = False, **kwargs):
+def print(msg: str, *, dedupe: bool = False, **kwargs):
     """Print a message.
 
     Args:
@@ -128,7 +128,7 @@ def should_use_log_file_console() -> bool:
     return environment.REFLEX_ENABLE_FULL_LOGGING.get()
 
 
-def print_to_log_file(msg: str, dedupe: bool = False, **kwargs):
+def print_to_log_file(msg: str, *, dedupe: bool = False, **kwargs):
     """Print a message to the log file.
 
     Args:
@@ -139,7 +139,7 @@ def print_to_log_file(msg: str, dedupe: bool = False, **kwargs):
     log_file_console().print(msg, **kwargs)
 
 
-def debug(msg: str, dedupe: bool = False, **kwargs):
+def debug(msg: str, *, dedupe: bool = False, **kwargs):
     """Print a debug message.
 
     Args:
@@ -161,7 +161,7 @@ def debug(msg: str, dedupe: bool = False, **kwargs):
         print_to_log_file(f"[purple]Debug: {msg}[/purple]", **kwargs)
 
 
-def info(msg: str, dedupe: bool = False, **kwargs):
+def info(msg: str, *, dedupe: bool = False, **kwargs):
     """Print an info message.
 
     Args:
@@ -179,7 +179,7 @@ def info(msg: str, dedupe: bool = False, **kwargs):
         print_to_log_file(f"[cyan]Info: {msg}[/cyan]", **kwargs)
 
 
-def success(msg: str, dedupe: bool = False, **kwargs):
+def success(msg: str, *, dedupe: bool = False, **kwargs):
     """Print a success message.
 
     Args:
@@ -197,7 +197,7 @@ def success(msg: str, dedupe: bool = False, **kwargs):
         print_to_log_file(f"[green]Success: {msg}[/green]", **kwargs)
 
 
-def log(msg: str, dedupe: bool = False, **kwargs):
+def log(msg: str, *, dedupe: bool = False, **kwargs):
     """Takes a string and logs it to the console.
 
     Args:
@@ -225,7 +225,7 @@ def rule(title: str, **kwargs):
     _console.rule(title, **kwargs)
 
 
-def warn(msg: str, dedupe: bool = False, **kwargs):
+def warn(msg: str, *, dedupe: bool = False, **kwargs):
     """Print a warning message.
 
     Args:
@@ -269,6 +269,7 @@ def _get_first_non_framework_frame() -> FrameType | None:
 
 
 def deprecate(
+    *,
     feature_name: str,
     reason: str,
     deprecation_version: str,
@@ -311,7 +312,7 @@ def deprecate(
             _EMITTED_DEPRECATION_WARNINGS.add(dedupe_key)
 
 
-def error(msg: str, dedupe: bool = False, **kwargs):
+def error(msg: str, *, dedupe: bool = False, **kwargs):
     """Print an error message.
 
     Args:

reflex/utils/processes.py

@@ -53,6 +53,31 @@ def get_num_workers() -> int:
     return (os.cpu_count() or 1) * 2 + 1
 
 
+def _can_bind_at_port(
+    address_family: socket.AddressFamily | int, address: str, port: int
+) -> bool:
+    """Check if a given address and port are responsive.
+
+    Args:
+        address_family: The address family (e.g., socket.AF_INET or socket.AF_INET6).
+        address: The address to check.
+        port: The port to check.
+
+    Returns:
+        Whether the address and port are responsive.
+    """
+    try:
+        with closing(socket.socket(address_family, socket.SOCK_STREAM)) as sock:
+            sock.bind((address, port))
+    except OverflowError:
+        return False
+    except PermissionError:
+        return False
+    except OSError:
+        return False
+    return True
+
+
 def is_process_on_port(port: int) -> bool:
     """Check if a process is running on the given port.
 
@@ -62,16 +87,11 @@ def is_process_on_port(port: int) -> bool:
     Returns:
         Whether a process is running on the given port.
     """
-    # Test IPv4 localhost (127.0.0.1)
-    with closing(socket.socket(socket.AF_INET, socket.SOCK_STREAM)) as sock:
-        ipv4_result = sock.connect_ex(("127.0.0.1", port)) == 0
-
-    # Test IPv6 localhost (::1)
-    with closing(socket.socket(socket.AF_INET6, socket.SOCK_STREAM)) as sock:
-        ipv6_result = sock.connect_ex(("::1", port)) == 0
-
-    # Port is in use if either IPv4 or IPv6 is listening
-    return ipv4_result or ipv6_result
+    return not _can_bind_at_port(  # Test IPv4 localhost (127.0.0.1)
+        socket.AF_INET, "127.0.0.1", port
+    ) or not _can_bind_at_port(
+        socket.AF_INET6, "::1", port
+    )  # Test IPv6 localhost (::1)
 
 
 def change_port(port: int, _type: str) -> int:
@@ -84,8 +104,15 @@ def change_port(port: int, _type: str) -> int:
     Returns:
         The new port.
 
+    Raises:
+        Exit: If the port is invalid or if the new port is occupied.
     """
     new_port = port + 1
+    if new_port < 0 or new_port > 65535:
+        console.error(
+            f"The {_type} port: {port} is invalid. It must be between 0 and 65535."
+        )
+        raise click.exceptions.Exit(1)
     if is_process_on_port(new_port):
         return change_port(new_port, _type)
     console.info(

{reflex-0.8.1a1.dist-info → reflex-0.8.2a1.dist-info}/METADATA

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