reflex 0.3.7__py3-none-any.whl → 0.3.8__py3-none-any.whl

reflex/components/{forms → core}/debounce.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 
 from typing import Any, Type
 
-from reflex.components import Component
+from reflex.components.component import Component
 from reflex.constants import EventTriggers
 from reflex.vars import Var, VarData
 

reflex/components/{forms → core}/debounce.pyi

@@ -1,4 +1,4 @@
-"""Stub file for reflex/components/forms/debounce.py"""
+"""Stub file for reflex/components/core/debounce.py"""
 # ------------------- DO NOT EDIT ----------------------
 # This file was generated by `scripts/pyi_generator.py`!
 # ------------------------------------------------------
@@ -8,7 +8,7 @@ from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
 from typing import Any, Type
-from reflex.components import Component
+from reflex.components.component import Component
 from reflex.constants import EventTriggers
 from reflex.vars import Var, VarData
 

reflex/components/{layout → core}/foreach.py

@@ -3,10 +3,10 @@ from __future__ import annotations
 
 import inspect
 from hashlib import md5
-from typing import Any, Callable, Iterable
+from typing import Any, Callable, Iterable, Optional
 
+from reflex.components.base.fragment import Fragment
 from reflex.components.component import Component
-from reflex.components.layout.fragment import Fragment
 from reflex.components.tags import IterTag
 from reflex.constants import MemoizationMode
 from reflex.vars import Var
@@ -23,6 +23,17 @@ class Foreach(Component):
     # A function from the render args to the component.
     render_fn: Callable = Fragment.create
 
+    # The theme if set.
+    theme: Optional[Component] = None
+
+    def _apply_theme(self, theme: Component):
+        """Apply the theme to this component.
+
+        Args:
+            theme: The theme to apply.
+        """
+        self.theme = theme
+
     @classmethod
     def create(cls, iterable: Var[Iterable], render_fn: Callable, **props) -> Foreach:
         """Create a foreach component.
@@ -85,6 +96,11 @@ class Foreach(Component):
         """
         tag = self._render()
         component = tag.render_component()
+
+        # Apply the theme to the children.
+        if self.theme is not None:
+            component.apply_theme(self.theme)
+
         return dict(
             tag.add_props(
                 **self.event_triggers,

reflex/components/core/match.py

@@ -0,0 +1,257 @@
+"""rx.match."""
+import textwrap
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+from reflex.components.base import Fragment
+from reflex.components.component import BaseComponent, Component, MemoizationLeaf
+from reflex.components.tags import MatchTag, Tag
+from reflex.utils import format, imports, types
+from reflex.utils.exceptions import MatchTypeError
+from reflex.vars import BaseVar, Var, VarData
+
+
+class Match(MemoizationLeaf):
+    """Match cases based on a condition."""
+
+    # The condition to determine which case to match.
+    cond: Var[Any]
+
+    # The list of match cases to be matched.
+    match_cases: List[Any] = []
+
+    # The catchall case to match.
+    default: Any
+
+    @classmethod
+    def create(cls, cond: Any, *cases) -> Union[Component, BaseVar]:
+        """Create a Match Component.
+
+        Args:
+            cond: The condition to determine which case to match.
+            cases: This list of cases to match.
+
+        Returns:
+            The match component.
+
+        Raises:
+            ValueError: When a default case is not provided for cases with Var return types.
+        """
+        match_cond_var = cls._create_condition_var(cond)
+        cases, default = cls._process_cases(list(cases))
+        match_cases = cls._process_match_cases(cases)
+
+        cls._validate_return_types(match_cases)
+
+        if default is None and types._issubclass(type(match_cases[0][-1]), BaseVar):
+            raise ValueError(
+                "For cases with return types as Vars, a default case must be provided"
+            )
+
+        return cls._create_match_cond_var_or_component(
+            match_cond_var, match_cases, default
+        )
+
+    @classmethod
+    def _create_condition_var(cls, cond: Any) -> BaseVar:
+        """Convert the condition to a Var.
+
+        Args:
+            cond: The condition.
+
+        Returns:
+            The condition as a base var
+
+        Raises:
+            ValueError: If the condition is not provided.
+        """
+        match_cond_var = Var.create(cond)
+        if match_cond_var is None:
+            raise ValueError("The condition must be set")
+        return match_cond_var  # type: ignore
+
+    @classmethod
+    def _process_cases(
+        cls, cases: List
+    ) -> Tuple[List, Optional[Union[BaseVar, BaseComponent]]]:
+        """Process the list of match cases and the catchall default case.
+
+        Args:
+            cases: The list of match cases.
+
+        Returns:
+            The default case and the list of match case tuples.
+
+        Raises:
+            ValueError: If there are multiple default cases.
+        """
+        default = None
+
+        if len([case for case in cases if not isinstance(case, tuple)]) > 1:
+            raise ValueError("rx.match can only have one default case.")
+
+        # Get the default case which should be the last non-tuple arg
+        if not isinstance(cases[-1], tuple):
+            default = cases.pop()
+            default = (
+                Var.create(default, _var_is_string=type(default) is str)
+                if not isinstance(default, BaseComponent)
+                else default
+            )
+
+        return cases, default  # type: ignore
+
+    @classmethod
+    def _process_match_cases(cls, cases: List) -> List[List[BaseVar]]:
+        """Process the individual match cases.
+
+        Args:
+            cases: The match cases.
+
+        Returns:
+            The processed match cases.
+
+        Raises:
+            ValueError: If the default case is not the last case or the tuple elements are less than 2.
+        """
+        match_cases = []
+        for case in cases:
+            if not isinstance(case, tuple):
+                raise ValueError(
+                    "rx.match should have tuples of cases and a default case as the last argument."
+                )
+            # There should be at least two elements in a case tuple(a condition and return value)
+            if len(case) < 2:
+                raise ValueError(
+                    "A case tuple should have at least a match case element and a return value."
+                )
+
+            case_list = []
+            for element in case:
+                # convert all non component element to vars.
+                el = (
+                    Var.create(element, _var_is_string=type(element) is str)
+                    if not isinstance(element, BaseComponent)
+                    else element
+                )
+                if not isinstance(el, (BaseVar, BaseComponent)):
+                    raise ValueError("Case element must be a var or component")
+                case_list.append(el)
+
+            match_cases.append(case_list)
+
+        return match_cases
+
+    @classmethod
+    def _validate_return_types(cls, match_cases: List[List[BaseVar]]) -> None:
+        """Validate that match cases have the same return types.
+
+        Args:
+            match_cases: The match cases.
+
+        Raises:
+            MatchTypeError: If the return types of cases are different.
+        """
+        first_case_return = match_cases[0][-1]
+        return_type = type(first_case_return)
+
+        if types._isinstance(first_case_return, BaseComponent):
+            return_type = BaseComponent
+        elif types._isinstance(first_case_return, BaseVar):
+            return_type = BaseVar
+
+        for index, case in enumerate(match_cases):
+            if not types._issubclass(type(case[-1]), return_type):
+                raise MatchTypeError(
+                    f"Match cases should have the same return types. Case {index} with return "
+                    f"value `{case[-1]._var_name if isinstance(case[-1], BaseVar) else textwrap.shorten(str(case[-1]), width=250)}`"
+                    f" of type {type(case[-1])!r} is not {return_type}"
+                )
+
+    @classmethod
+    def _create_match_cond_var_or_component(
+        cls,
+        match_cond_var: Var,
+        match_cases: List[List[BaseVar]],
+        default: Optional[Union[BaseVar, BaseComponent]],
+    ) -> Union[Component, BaseVar]:
+        """Create and return the match condition var or component.
+
+        Args:
+            match_cond_var: The match condition.
+            match_cases: The list of match cases.
+            default: The default case.
+
+        Returns:
+            The match component wrapped in a fragment or the match var.
+
+        Raises:
+            ValueError: If the return types are not vars when creating a match var for Var types.
+        """
+        if default is None and types._issubclass(
+            type(match_cases[0][-1]), BaseComponent
+        ):
+            default = Fragment.create()
+
+        if types._issubclass(type(match_cases[0][-1]), BaseComponent):
+            return Fragment.create(
+                cls(
+                    cond=match_cond_var,
+                    match_cases=match_cases,
+                    default=default,
+                )
+            )
+
+        # Validate the match cases (as well as the default case) to have Var return types.
+        if any(
+            case for case in match_cases if not types._isinstance(case[-1], BaseVar)
+        ) or not types._isinstance(default, BaseVar):
+            raise ValueError("Return types of match cases should be Vars.")
+
+        # match cases and default should all be Vars at this point.
+        # Retrieve var data of every var in the match cases and default.
+        var_data = [
+            *[el._var_data for case in match_cases for el in case],
+            default._var_data,  # type: ignore
+        ]
+
+        return match_cond_var._replace(
+            _var_name=format.format_match(
+                cond=match_cond_var._var_full_name,
+                match_cases=match_cases,  # type: ignore
+                default=default,  # type: ignore
+            ),
+            _var_type=default._var_type,  # type: ignore
+            _var_is_local=False,
+            _var_full_name_needs_state_prefix=False,
+            merge_var_data=VarData.merge(*var_data),
+        )
+
+    def _render(self) -> Tag:
+        return MatchTag(
+            cond=self.cond, match_cases=self.match_cases, default=self.default
+        )
+
+    def render(self) -> Dict:
+        """Render the component.
+
+        Returns:
+            The dictionary for template of component.
+        """
+        tag = self._render()
+        tag.name = "match"
+        return dict(tag)
+
+    def _get_imports(self):
+        merged_imports = super()._get_imports()
+        # Obtain the imports of all components the in match case.
+        for case in self.match_cases:
+            if isinstance(case[-1], BaseComponent):
+                merged_imports = imports.merge_imports(
+                    merged_imports, case[-1].get_imports()
+                )
+        # Get the import of the default case component.
+        if isinstance(self.default, BaseComponent):
+            merged_imports = imports.merge_imports(
+                merged_imports, self.default.get_imports()
+            )
+        return merged_imports

reflex/components/{layout → core}/responsive.py

@@ -1,6 +1,6 @@
 """Responsive components."""
 
-from reflex.components.layout.box import Box
+from reflex.components.chakra.layout.box import Box
 
 
 # Add responsive styles shortcuts.

reflex/components/{forms → core}/upload.py

@@ -4,9 +4,9 @@ from __future__ import annotations
 from typing import Any, Dict, List, Optional, Union
 
 from reflex import constants
+from reflex.components.chakra.forms.input import Input
+from reflex.components.chakra.layout.box import Box
 from reflex.components.component import Component
-from reflex.components.forms.input import Input
-from reflex.components.layout.box import Box
 from reflex.constants import Dirs
 from reflex.event import CallableEventSpec, EventChain, EventSpec, call_script
 from reflex.utils import imports

reflex/components/{forms → core}/upload.pyi

@@ -1,4 +1,4 @@
-"""Stub file for reflex/components/forms/upload.py"""
+"""Stub file for reflex/components/core/upload.py"""
 # ------------------- DO NOT EDIT ----------------------
 # This file was generated by `scripts/pyi_generator.py`!
 # ------------------------------------------------------
@@ -9,9 +9,9 @@ from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
 from typing import Any, Dict, List, Optional, Union
 from reflex import constants
+from reflex.components.chakra.forms.input import Input
+from reflex.components.chakra.layout.box import Box
 from reflex.components.component import Component
-from reflex.components.forms.input import Input
-from reflex.components.layout.box import Box
 from reflex.constants import Dirs
 from reflex.event import CallableEventSpec, EventChain, EventSpec, call_script
 from reflex.utils import imports

reflex/components/datadisplay/__init__.py

@@ -1,15 +1,6 @@
-"""Data display components."""
+"""Data grid components."""
 
-from .badge import Badge
-from .code import Code, CodeBlock
-from .code import LiteralCodeBlockTheme as LiteralCodeBlockTheme
-from .code import LiteralCodeLanguage as LiteralCodeLanguage
 from .dataeditor import DataEditor, DataEditorTheme
-from .datatable import DataTable
-from .divider import Divider
-from .keyboard_key import KeyboardKey as Kbd
-from .list import List, ListItem, OrderedList, UnorderedList
-from .moment import Moment, MomentDelta
-from .stat import Stat, StatArrow, StatGroup, StatHelpText, StatLabel, StatNumber
-from .table import Table, TableCaption, TableContainer, Tbody, Td, Tfoot, Th, Thead, Tr
-from .tag import Tag, TagCloseButton, TagLabel, TagLeftIcon, TagRightIcon
+
+data_editor = DataEditor.create
+data_editor_theme = DataEditorTheme

reflex/components/el/elements/inline.py

@@ -86,6 +86,7 @@ class Data(BaseHTML):
 
     tag = "data"
 
+    # Specifies the machine-readable translation of the data element.
     value: Var[Union[str, int, bool]]
 
 
@@ -124,6 +125,7 @@ class Q(BaseHTML):
 
     tag = "q"
 
+    # Specifies the source URL of the quote.
     cite: Var[Union[str, int, bool]]
 
 
@@ -191,6 +193,8 @@ class Time(BaseHTML):
     """Display the time element."""
 
     tag = "time"
+
+    # Specifies the date and/or time of the element.
     date_time: Var[Union[str, int, bool]]
 
 

reflex/components/el/elements/inline.pyi

@@ -1262,6 +1262,7 @@ class Data(BaseHTML):
 
         Args:
             *children: The children of the component.
+            value: Specifies the machine-readable translation of the data element.
             access_key:  Provides a hint for generating a keyboard shortcut for the current element.
             auto_capitalize: Controls whether and how text input is automatically capitalized as it is entered/edited by the user.
             content_editable: Indicates whether the element's content is editable.
@@ -2097,6 +2098,7 @@ class Q(BaseHTML):
 
         Args:
             *children: The children of the component.
+            cite: Specifies the source URL of the quote.
             access_key:  Provides a hint for generating a keyboard shortcut for the current element.
             auto_capitalize: Controls whether and how text input is automatically capitalized as it is entered/edited by the user.
             content_editable: Indicates whether the element's content is editable.
@@ -3629,6 +3631,7 @@ class Time(BaseHTML):
 
         Args:
             *children: The children of the component.
+            date_time: Specifies the date and/or time of the element.
             access_key:  Provides a hint for generating a keyboard shortcut for the current element.
             auto_capitalize: Controls whether and how text input is automatically capitalized as it is entered/edited by the user.
             content_editable: Indicates whether the element's content is editable.

reflex/components/gridjs/__init__.py

@@ -0,0 +1,5 @@
+"""Grid components."""
+
+from .datatable import DataTable
+
+data_table = DataTable.create

reflex/components/{datadisplay → gridjs}/datatable.pyi

@@ -1,4 +1,4 @@
-"""Stub file for reflex/components/datadisplay/datatable.py"""
+"""Stub file for reflex/components/gridjs/datatable.py"""
 # ------------------- DO NOT EDIT ----------------------
 # This file was generated by `scripts/pyi_generator.py`!
 # ------------------------------------------------------

reflex/components/literals.py

@@ -2,4 +2,31 @@
 
 from typing import Literal
 
+# Base Literals
+LiteralInputType = Literal[
+    "button",
+    "checkbox",
+    "color",
+    "date",
+    "datetime-local",
+    "email",
+    "file",
+    "hidden",
+    "image",
+    "month",
+    "number",
+    "password",
+    "radio",
+    "range",
+    "reset",
+    "search",
+    "submit",
+    "tel",
+    "text",
+    "time",
+    "url",
+    "week",
+]
+
+
 LiteralRowMarker = Literal["none", "number", "checkbox", "both", "clickable-number"]

reflex/components/markdown/__init__.py

@@ -0,0 +1,5 @@
+"""Markdown components."""
+
+from .markdown import Markdown
+
+markdown = Markdown.create

reflex/components/{typography → markdown}/markdown.py

@@ -8,12 +8,16 @@ from hashlib import md5
 from typing import Any, Callable, Dict, Union
 
 from reflex.compiler import utils
+from reflex.components.chakra.datadisplay.list import (
+    ListItem,
+    OrderedList,
+    UnorderedList,
+)
+from reflex.components.chakra.navigation import Link
+from reflex.components.chakra.typography.heading import Heading
+from reflex.components.chakra.typography.text import Text
 from reflex.components.component import Component, CustomComponent
-from reflex.components.datadisplay.list import ListItem, OrderedList, UnorderedList
-from reflex.components.navigation import Link
 from reflex.components.tags.tag import Tag
-from reflex.components.typography.heading import Heading
-from reflex.components.typography.text import Text
 from reflex.style import Style
 from reflex.utils import console, imports, types
 from reflex.utils.imports import ImportVar
@@ -34,6 +38,8 @@ _REHYPE_KATEX = Var.create_safe("rehypeKatex", _var_is_local=False)
 _REHYPE_RAW = Var.create_safe("rehypeRaw", _var_is_local=False)
 _REHYPE_PLUGINS = Var.create_safe([_REHYPE_KATEX, _REHYPE_RAW])
 
+# These tags do NOT get props passed to them
+NO_PROPS_TAGS = ("ul", "ol", "li")
 
 # Component Mapping
 @lru_cache
@@ -43,7 +49,7 @@ def get_base_component_map() -> dict[str, Callable]:
     Returns:
         The base component map.
     """
-    from reflex.components.datadisplay.code import Code, CodeBlock
+    from reflex.components.chakra.datadisplay.code import Code, CodeBlock
 
     return {
         "h1": lambda value: Heading.create(
@@ -157,7 +163,7 @@ class Markdown(Component):
 
     def _get_imports(self) -> imports.ImportDict:
         # Import here to avoid circular imports.
-        from reflex.components.datadisplay.code import Code, CodeBlock
+        from reflex.components.chakra.datadisplay.code import Code, CodeBlock
 
         imports = super()._get_imports()
 
@@ -211,6 +217,10 @@ class Markdown(Component):
         special_props = {_PROPS}
         children = [_CHILDREN]
 
+        # For certain tags, the props from the markdown renderer are not actually valid for the component.
+        if tag in NO_PROPS_TAGS:
+            special_props = set()
+
         # If the children are set as a prop, don't pass them as children.
         children_prop = props.pop("children", None)
         if children_prop is not None:

reflex/components/{typography → markdown}/markdown.pyi

@@ -1,4 +1,4 @@
-"""Stub file for reflex/components/typography/markdown.py"""
+"""Stub file for reflex/components/markdown/markdown.py"""
 # ------------------- DO NOT EDIT ----------------------
 # This file was generated by `scripts/pyi_generator.py`!
 # ------------------------------------------------------
@@ -12,12 +12,16 @@ from functools import lru_cache
 from hashlib import md5
 from typing import Any, Callable, Dict, Union
 from reflex.compiler import utils
+from reflex.components.chakra.datadisplay.list import (
+    ListItem,
+    OrderedList,
+    UnorderedList,
+)
+from reflex.components.chakra.navigation import Link
+from reflex.components.chakra.typography.heading import Heading
+from reflex.components.chakra.typography.text import Text
 from reflex.components.component import Component, CustomComponent
-from reflex.components.datadisplay.list import ListItem, OrderedList, UnorderedList
-from reflex.components.navigation import Link
 from reflex.components.tags.tag import Tag
-from reflex.components.typography.heading import Heading
-from reflex.components.typography.text import Text
 from reflex.style import Style
 from reflex.utils import console, imports, types
 from reflex.utils.imports import ImportVar
@@ -32,6 +36,7 @@ _REMARK_PLUGINS = Var.create_safe([_REMARK_MATH, _REMARK_GFM])
 _REHYPE_KATEX = Var.create_safe("rehypeKatex", _var_is_local=False)
 _REHYPE_RAW = Var.create_safe("rehypeRaw", _var_is_local=False)
 _REHYPE_PLUGINS = Var.create_safe([_REHYPE_KATEX, _REHYPE_RAW])
+NO_PROPS_TAGS = ("ul", "ol", "li")
 
 @lru_cache
 def get_base_component_map() -> dict[str, Callable]: ...

reflex/components/media/__init__.py

@@ -1,8 +1 @@
-"""Media components."""
-
-from .audio import Audio
-from .avatar import Avatar, AvatarBadge, AvatarGroup
-from .icon import Icon
-from .video import Video
-
-__all__ = [f for f in dir() if f[0].isupper()]  # type: ignore
+"""Temporary shim for Chakra icon class."""