reflex 0.5.2__py3-none-any.whl → 0.5.3__py3-none-any.whl

reflex/components/recharts/__init__.py

@@ -1,108 +1,118 @@
 """Recharts components."""
+from __future__ import annotations
 
-from .cartesian import (
-    Area,
-    Bar,
-    Brush,
-    Cartesian,
-    CartesianAxis,
-    CartesianGrid,
-    ErrorBar,
-    Funnel,
-    Line,
-    ReferenceArea,
-    ReferenceDot,
-    ReferenceLine,
-    Scatter,
-    XAxis,
-    YAxis,
-    ZAxis,
-)
-from .charts import (
-    AreaChart,
-    BarChart,
-    ComposedChart,
-    FunnelChart,
-    LineChart,
-    PieChart,
-    RadarChart,
-    RadialBarChart,
-    ScatterChart,
-    Treemap,
-)
-from .general import GraphingTooltip, Label, LabelList, Legend, ResponsiveContainer
-from .polar import (
-    Pie,
-    PolarAngleAxis,
-    PolarGrid,
-    PolarRadiusAxis,
-    Radar,
-    RadialBar,
-)
-from .recharts import (
-    LiteralAnimationEasing,
-    LiteralAreaType,
-    LiteralAxisType,
-    LiteralBarChartStackOffset,
-    LiteralComposedChartBaseValue,
-    LiteralDirection,
-    LiteralGridType,
-    LiteralIconType,
-    LiteralIfOverflow,
-    LiteralInterval,
-    LiteralLayout,
-    LiteralLegendAlign,
-    LiteralLegendType,
-    LiteralLineType,
-    LiteralOrientation,
-    LiteralOrientationLeftRightMiddle,
-    LiteralOrientationTopBottom,
-    LiteralOrientationTopBottomLeftRight,
-    LiteralPolarRadiusType,
-    LiteralScale,
-    LiteralShape,
-    LiteralStackOffset,
-    LiteralSyncMethod,
-    LiteralVerticalAlign,
-)
+from reflex.utils import lazy_loader
 
-area_chart = AreaChart.create
-bar_chart = BarChart.create
-line_chart = LineChart.create
-composed_chart = ComposedChart.create
-pie_chart = PieChart.create
-radar_chart = RadarChart.create
-radial_bar_chart = RadialBarChart.create
-scatter_chart = ScatterChart.create
-funnel_chart = FunnelChart.create
-treemap = Treemap.create
+_SUBMOD_ATTRS: dict = {
+    "cartesian": [
+        "area",
+        "Area",
+        "bar",
+        "Bar",
+        "line",
+        "Line",
+        "scatter",
+        "Scatter",
+        "x_axis",
+        "XAxis",
+        "y_axis",
+        "YAxis",
+        "z_axis",
+        "ZAxis",
+        "brush",
+        "Brush",
+        "cartesian_axis",
+        "CartesianAxis",
+        "cartesian_grid",
+        "CartesianGrid",
+        "reference_line",
+        "ReferenceLine",
+        "reference_dot",
+        "ReferenceDot",
+        "reference_area",
+        "ReferenceArea",
+        "error_bar",
+        "ErrorBar",
+        "funnel",
+        "Funnel",
+    ],
+    "charts": [
+        "area_chart",
+        "AreaChart",
+        "bar_chart",
+        "BarChart",
+        "line_chart",
+        "LineChart",
+        "composed_chart",
+        "ComposedChart",
+        "pie_chart",
+        "PieChart",
+        "radar_chart",
+        "RadarChart",
+        "radial_bar_chart",
+        "RadialBarChart",
+        "scatter_chart",
+        "ScatterChart",
+        "funnel_chart",
+        "FunnelChart",
+        "treemap",
+        "Treemap",
+    ],
+    "general": [
+        "responsive_container",
+        "ResponsiveContainer",
+        "legend",
+        "Legend",
+        "graphing_tooltip",
+        "GraphingTooltip",
+        "label",
+        "Label",
+        "label_list",
+        "LabelList",
+    ],
+    "polar": [
+        "pie",
+        "Pie",
+        "radar",
+        "Radar",
+        "radial_bar",
+        "RadialBar",
+        "polar_angle_axis",
+        "PolarAngleAxis",
+        "polar_grid",
+        "PolarGrid",
+        "polar_radius_axis",
+        "PolarRadiusAxis",
+    ],
+    "recharts": [
+        "LiteralAnimationEasing",
+        "LiteralAreaType",
+        "LiteralAxisType",
+        "LiteralBarChartStackOffset",
+        "LiteralComposedChartBaseValue",
+        "LiteralDirection",
+        "LiteralGridType",
+        "LiteralIconType",
+        "LiteralIfOverflow",
+        "LiteralInterval",
+        "LiteralLayout",
+        "LiteralLegendAlign",
+        "LiteralLegendType",
+        "LiteralLineType",
+        "LiteralOrientation",
+        "LiteralOrientationLeftRightMiddle",
+        "LiteralOrientationTopBottom",
+        "LiteralOrientationTopBottomLeftRight",
+        "LiteralPolarRadiusType",
+        "LiteralScale",
+        "LiteralShape",
+        "LiteralStackOffset",
+        "LiteralSyncMethod",
+        "LiteralVerticalAlign",
+    ],
+}
 
-
-area = Area.create
-bar = Bar.create
-line = Line.create
-scatter = Scatter.create
-x_axis = XAxis.create
-y_axis = YAxis.create
-z_axis = ZAxis.create
-brush = Brush.create
-cartesian_axis = CartesianAxis.create
-cartesian_grid = CartesianGrid.create
-reference_line = ReferenceLine.create
-reference_dot = ReferenceDot.create
-reference_area = ReferenceArea.create
-error_bar = ErrorBar.create
-funnel = Funnel.create
-
-responsive_container = ResponsiveContainer.create
-legend = Legend.create
-graphing_tooltip = GraphingTooltip.create
-label = Label.create
-label_list = LabelList.create
-
-pie = Pie.create
-radar = Radar.create
-radial_bar = RadialBar.create
-polar_angle_axis = PolarAngleAxis.create
-polar_grid = PolarGrid.create
-polar_radius_axis = PolarRadiusAxis.create
+__getattr__, __dir__, __all__ = lazy_loader.attach(
+    __name__,
+    submod_attrs=_SUBMOD_ATTRS,
+)

reflex/components/recharts/__init__.pyi

@@ -0,0 +1,106 @@
+"""Stub file for reflex/components/recharts/__init__.py"""
+# ------------------- DO NOT EDIT ----------------------
+# This file was generated by `reflex/utils/pyi_generator.py`!
+# ------------------------------------------------------
+
+from .cartesian import area as area
+from .cartesian import Area as Area
+from .cartesian import bar as bar
+from .cartesian import Bar as Bar
+from .cartesian import line as line
+from .cartesian import Line as Line
+from .cartesian import scatter as scatter
+from .cartesian import Scatter as Scatter
+from .cartesian import x_axis as x_axis
+from .cartesian import XAxis as XAxis
+from .cartesian import y_axis as y_axis
+from .cartesian import YAxis as YAxis
+from .cartesian import z_axis as z_axis
+from .cartesian import ZAxis as ZAxis
+from .cartesian import brush as brush
+from .cartesian import Brush as Brush
+from .cartesian import cartesian_axis as cartesian_axis
+from .cartesian import CartesianAxis as CartesianAxis
+from .cartesian import cartesian_grid as cartesian_grid
+from .cartesian import CartesianGrid as CartesianGrid
+from .cartesian import reference_line as reference_line
+from .cartesian import ReferenceLine as ReferenceLine
+from .cartesian import reference_dot as reference_dot
+from .cartesian import ReferenceDot as ReferenceDot
+from .cartesian import reference_area as reference_area
+from .cartesian import ReferenceArea as ReferenceArea
+from .cartesian import error_bar as error_bar
+from .cartesian import ErrorBar as ErrorBar
+from .cartesian import funnel as funnel
+from .cartesian import Funnel as Funnel
+from .charts import area_chart as area_chart
+from .charts import AreaChart as AreaChart
+from .charts import bar_chart as bar_chart
+from .charts import BarChart as BarChart
+from .charts import line_chart as line_chart
+from .charts import LineChart as LineChart
+from .charts import composed_chart as composed_chart
+from .charts import ComposedChart as ComposedChart
+from .charts import pie_chart as pie_chart
+from .charts import PieChart as PieChart
+from .charts import radar_chart as radar_chart
+from .charts import RadarChart as RadarChart
+from .charts import radial_bar_chart as radial_bar_chart
+from .charts import RadialBarChart as RadialBarChart
+from .charts import scatter_chart as scatter_chart
+from .charts import ScatterChart as ScatterChart
+from .charts import funnel_chart as funnel_chart
+from .charts import FunnelChart as FunnelChart
+from .charts import treemap as treemap
+from .charts import Treemap as Treemap
+from .general import responsive_container as responsive_container
+from .general import ResponsiveContainer as ResponsiveContainer
+from .general import legend as legend
+from .general import Legend as Legend
+from .general import graphing_tooltip as graphing_tooltip
+from .general import GraphingTooltip as GraphingTooltip
+from .general import label as label
+from .general import Label as Label
+from .general import label_list as label_list
+from .general import LabelList as LabelList
+from .polar import pie as pie
+from .polar import Pie as Pie
+from .polar import radar as radar
+from .polar import Radar as Radar
+from .polar import radial_bar as radial_bar
+from .polar import RadialBar as RadialBar
+from .polar import polar_angle_axis as polar_angle_axis
+from .polar import PolarAngleAxis as PolarAngleAxis
+from .polar import polar_grid as polar_grid
+from .polar import PolarGrid as PolarGrid
+from .polar import polar_radius_axis as polar_radius_axis
+from .polar import PolarRadiusAxis as PolarRadiusAxis
+from .recharts import LiteralAnimationEasing as LiteralAnimationEasing
+from .recharts import LiteralAreaType as LiteralAreaType
+from .recharts import LiteralAxisType as LiteralAxisType
+from .recharts import LiteralBarChartStackOffset as LiteralBarChartStackOffset
+from .recharts import LiteralComposedChartBaseValue as LiteralComposedChartBaseValue
+from .recharts import LiteralDirection as LiteralDirection
+from .recharts import LiteralGridType as LiteralGridType
+from .recharts import LiteralIconType as LiteralIconType
+from .recharts import LiteralIfOverflow as LiteralIfOverflow
+from .recharts import LiteralInterval as LiteralInterval
+from .recharts import LiteralLayout as LiteralLayout
+from .recharts import LiteralLegendAlign as LiteralLegendAlign
+from .recharts import LiteralLegendType as LiteralLegendType
+from .recharts import LiteralLineType as LiteralLineType
+from .recharts import LiteralOrientation as LiteralOrientation
+from .recharts import (
+    LiteralOrientationLeftRightMiddle as LiteralOrientationLeftRightMiddle,
+)
+from .recharts import LiteralOrientationTopBottom as LiteralOrientationTopBottom
+from .recharts import (
+    LiteralOrientationTopBottomLeftRight as LiteralOrientationTopBottomLeftRight,
+)
+from .recharts import LiteralPolarRadiusType as LiteralPolarRadiusType
+from .recharts import LiteralScale as LiteralScale
+from .recharts import LiteralShape as LiteralShape
+from .recharts import LiteralStackOffset as LiteralStackOffset
+from .recharts import LiteralSyncMethod as LiteralSyncMethod
+from .recharts import LiteralVerticalAlign as LiteralVerticalAlign
+from reflex.utils import lazy_loader

reflex/components/recharts/cartesian.py

@@ -572,3 +572,20 @@ class CartesianAxis(Grid):
 
     # The margin between tick line and tick.
     tick_margin: Var[int]
+
+
+area = Area.create
+bar = Bar.create
+line = Line.create
+scatter = Scatter.create
+x_axis = XAxis.create
+y_axis = YAxis.create
+z_axis = ZAxis.create
+brush = Brush.create
+cartesian_axis = CartesianAxis.create
+cartesian_grid = CartesianGrid.create
+reference_line = ReferenceLine.create
+reference_dot = ReferenceDot.create
+reference_area = ReferenceArea.create
+error_bar = ErrorBar.create
+funnel = Funnel.create

reflex/components/recharts/cartesian.pyi

@@ -1849,3 +1849,19 @@ class CartesianAxis(Grid):
             The component.
         """
         ...
+
+area = Area.create
+bar = Bar.create
+line = Line.create
+scatter = Scatter.create
+x_axis = XAxis.create
+y_axis = YAxis.create
+z_axis = ZAxis.create
+brush = Brush.create
+cartesian_axis = CartesianAxis.create
+cartesian_grid = CartesianGrid.create
+reference_line = ReferenceLine.create
+reference_dot = ReferenceDot.create
+reference_area = ReferenceArea.create
+error_bar = ErrorBar.create
+funnel = Funnel.create

reflex/components/recharts/charts.py

@@ -521,3 +521,15 @@ class Treemap(RechartsCharts):
             width=props.pop("width", "100%"),
             height=props.pop("height", "100%"),
         )
+
+
+area_chart = AreaChart.create
+bar_chart = BarChart.create
+line_chart = LineChart.create
+composed_chart = ComposedChart.create
+pie_chart = PieChart.create
+radar_chart = RadarChart.create
+radial_bar_chart = RadialBarChart.create
+scatter_chart = ScatterChart.create
+funnel_chart = FunnelChart.create
+treemap = Treemap.create

reflex/components/recharts/charts.pyi

@@ -893,3 +893,14 @@ class Treemap(RechartsCharts):
             The Treemap component wrapped in a responsive container.
         """
         ...
+
+area_chart = AreaChart.create
+bar_chart = BarChart.create
+line_chart = LineChart.create
+composed_chart = ComposedChart.create
+pie_chart = PieChart.create
+radar_chart = RadarChart.create
+radial_bar_chart = RadialBarChart.create
+scatter_chart = ScatterChart.create
+funnel_chart = FunnelChart.create
+treemap = Treemap.create

reflex/components/recharts/general.py

@@ -182,3 +182,10 @@ class LabelList(Recharts):
 
     # Color of the stroke
     stroke: Var[str]
+
+
+responsive_container = ResponsiveContainer.create
+legend = Legend.create
+graphing_tooltip = GraphingTooltip.create
+label = Label.create
+label_list = LabelList.create

reflex/components/recharts/general.pyi

@@ -573,3 +573,9 @@ class LabelList(Recharts):
             The component.
         """
         ...
+
+responsive_container = ResponsiveContainer.create
+legend = Legend.create
+graphing_tooltip = GraphingTooltip.create
+label = Label.create
+label_list = LabelList.create

reflex/components/recharts/polar.py

@@ -308,6 +308,9 @@ class PolarRadiusAxis(Recharts):
     # Valid children components
     _valid_children: List[str] = ["Label"]
 
+    # The domain of the polar radius axis, specifying the minimum and maximum values.
+    domain: List[int] = [0, 250]
+
     def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
         """Get the event triggers that pass the component's value to the handler.
 
@@ -322,3 +325,11 @@ class PolarRadiusAxis(Recharts):
             EventTriggers.ON_MOUSE_ENTER: lambda: [],
             EventTriggers.ON_MOUSE_LEAVE: lambda: [],
         }
+
+
+pie = Pie.create
+radar = Radar.create
+radial_bar = RadialBar.create
+polar_angle_axis = PolarAngleAxis.create
+polar_grid = PolarGrid.create
+polar_radius_axis = PolarRadiusAxis.create

reflex/components/recharts/polar.pyi

@@ -492,6 +492,7 @@ class PolarRadiusAxis(Recharts):
                 ],
             ]
         ] = None,
+        domain: Optional[List[int]] = None,
         style: Optional[Style] = None,
         key: Optional[Any] = None,
         id: Optional[Any] = None,
@@ -533,6 +534,7 @@ class PolarRadiusAxis(Recharts):
             tick: The width or height of tick.
             tick_count: The count of ticks.
             scale: If 'auto' set, the scale funtion is linear scale. 'auto' | 'linear' | 'pow' | 'sqrt' | 'log' | 'identity' | 'time' | 'band' | 'point' | 'ordinal' | 'quantile' | 'quantize' | 'utc' | 'sequential' | 'threshold'
+            domain: The domain of the polar radius axis, specifying the minimum and maximum values.
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
@@ -545,3 +547,10 @@ class PolarRadiusAxis(Recharts):
             The component.
         """
         ...
+
+pie = Pie.create
+radar = Radar.create
+radial_bar = RadialBar.create
+polar_angle_axis = PolarAngleAxis.create
+polar_grid = PolarGrid.create
+polar_radius_axis = PolarRadiusAxis.create

reflex/config.py

@@ -202,6 +202,9 @@ class Config(Base):
     # Whether to enable or disable nextJS gzip compression.
     next_compression: bool = True
 
+    # Whether to use React strict mode in nextJS
+    react_strict_mode: bool = True
+
     # Additional frontend packages to install.
     frontend_packages: List[str] = []
 

reflex/constants/__init__.py

@@ -35,7 +35,6 @@ from .compiler import (
 )
 from .config import (
     ALEMBIC_CONFIG,
-    PRODUCTION_BACKEND_URL,
     Config,
     Expiration,
     GitIgnore,
@@ -99,7 +98,6 @@ __ALL__ = [
     Ping,
     POLLING_MAX_HTTP_BUFFER_SIZE,
     PYTEST_CURRENT_TEST,
-    PRODUCTION_BACKEND_URL,
     Reflex,
     RELOAD_CONFIG,
     RequirementsTxt,

reflex/constants/base.py

@@ -21,10 +21,14 @@ class Dirs(SimpleNamespace):
     WEB = ".web"
     # The name of the assets directory.
     APP_ASSETS = "assets"
+    # The name of the assets directory for external ressource (a subfolder of APP_ASSETS).
+    EXTERNAL_APP_ASSETS = "external"
     # The name of the utils file.
     UTILS = "utils"
     # The name of the output static directory.
     STATIC = "_static"
+    # The name of the public html directory served at "/"
+    PUBLIC = "public"
     # The name of the state file.
     STATE_PATH = "/".join([UTILS, "state"])
     # The name of the components file.
@@ -38,7 +42,7 @@ class Dirs(SimpleNamespace):
     # The directory where the utils file is located.
     WEB_UTILS = os.path.join(WEB, UTILS)
     # The directory where the assets are located.
-    WEB_ASSETS = os.path.join(WEB, "public")
+    WEB_ASSETS = os.path.join(WEB, PUBLIC)
     # The env json file.
     ENV_JSON = os.path.join(WEB, "env.json")
     # The reflex json file.

reflex/constants/installer.py

@@ -35,7 +35,7 @@ class Bun(SimpleNamespace):
     """Bun constants."""
 
     # The Bun version.
-    VERSION = "1.1.8"
+    VERSION = "1.1.10"
     # Min Bun Version
     MIN_VERSION = "0.7.0"
     # The directory to store the bun.
@@ -123,4 +123,5 @@ class PackageJson(SimpleNamespace):
     DEV_DEPENDENCIES = {
         "autoprefixer": "10.4.14",
         "postcss": "8.4.31",
+        "postcss-import": "16.1.0",
     }

reflex/experimental/__init__.py

@@ -8,6 +8,7 @@ from reflex.components.sonner.toast import toast as toast
 
 from ..utils.console import warn
 from . import hooks as hooks
+from .assets import asset as asset
 from .client_state import ClientStateVar as ClientStateVar
 from .layout import layout as layout
 from .misc import run_in_thread as run_in_thread
@@ -17,6 +18,7 @@ warn(
 )
 
 _x = SimpleNamespace(
+    asset=asset,
     client_state=ClientStateVar.create,
     hooks=hooks,
     layout=layout,

reflex/experimental/assets.py

@@ -0,0 +1,56 @@
+"""Helper functions for adding assets to the app."""
+import inspect
+from pathlib import Path
+from typing import Optional
+
+from reflex import constants
+
+
+def asset(relative_filename: str, subfolder: Optional[str] = None) -> str:
+    """Add an asset to the app.
+    Place the file next to your including python file.
+    Copies the file to the app's external assets directory.
+
+    Example:
+    ```python
+    rx.script(src=rx._x.asset("my_custom_javascript.js"))
+    rx.image(src=rx._x.asset("test_image.png","subfolder"))
+    ```
+
+    Args:
+        relative_filename: The relative filename of the asset.
+        subfolder: The directory to place the asset in.
+
+    Raises:
+        FileNotFoundError: If the file does not exist.
+
+    Returns:
+        The relative URL to the copied asset.
+    """
+    # Determine the file by which the asset is exposed.
+    calling_file = inspect.stack()[1].filename
+    module = inspect.getmodule(inspect.stack()[1][0])
+    assert module is not None
+    caller_module_path = module.__name__.replace(".", "/")
+
+    subfolder = f"{caller_module_path}/{subfolder}" if subfolder else caller_module_path
+
+    src_file = Path(calling_file).parent / relative_filename
+
+    assets = constants.Dirs.APP_ASSETS
+    external = constants.Dirs.EXTERNAL_APP_ASSETS
+
+    if not src_file.exists():
+        raise FileNotFoundError(f"File not found: {src_file}")
+
+    # Create the asset folder in the currently compiling app.
+    asset_folder = Path.cwd() / assets / external / subfolder
+    asset_folder.mkdir(parents=True, exist_ok=True)
+
+    dst_file = asset_folder / relative_filename
+
+    if not dst_file.exists():
+        dst_file.symlink_to(src_file)
+
+    asset_url = f"/{external}/{subfolder}/{relative_filename}"
+    return asset_url

reflex/experimental/client_state.py

@@ -2,7 +2,7 @@
 
 import dataclasses
 import sys
-from typing import Any, Callable, Optional, Type
+from typing import Any, Callable, Optional, Type, Union
 
 from reflex import constants
 from reflex.event import EventChain, EventHandler, EventSpec, call_script
@@ -171,7 +171,9 @@ class ClientStateVar(Var):
             )
         )
 
-    def retrieve(self, callback: EventHandler | Callable | None = None) -> EventSpec:
+    def retrieve(
+        self, callback: Union[EventHandler, Callable, None] = None
+    ) -> EventSpec:
         """Pass the value of the client state variable to a backend EventHandler.
 
         The event handler must `yield` or `return` the EventSpec to trigger the event.