match.py 9.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287
  1. """rx.match."""
  2. import textwrap
  3. from typing import Any, Dict, List, Optional, Tuple, Union
  4. from reflex.components.base import Fragment
  5. from reflex.components.component import BaseComponent, Component, MemoizationLeaf
  6. from reflex.components.tags import MatchTag, Tag
  7. from reflex.style import Style
  8. from reflex.utils import format, imports, types
  9. from reflex.utils.exceptions import MatchTypeError
  10. from reflex.vars import BaseVar, Var, VarData
  11. class Match(MemoizationLeaf):
  12. """Match cases based on a condition."""
  13. # The condition to determine which case to match.
  14. cond: Var[Any]
  15. # The list of match cases to be matched.
  16. match_cases: List[Any] = []
  17. # The catchall case to match.
  18. default: Any
  19. @classmethod
  20. def create(cls, cond: Any, *cases) -> Union[Component, BaseVar]:
  21. """Create a Match Component.
  22. Args:
  23. cond: The condition to determine which case to match.
  24. cases: This list of cases to match.
  25. Returns:
  26. The match component.
  27. Raises:
  28. ValueError: When a default case is not provided for cases with Var return types.
  29. """
  30. match_cond_var = cls._create_condition_var(cond)
  31. cases, default = cls._process_cases(list(cases))
  32. match_cases = cls._process_match_cases(cases)
  33. cls._validate_return_types(match_cases)
  34. if default is None and types._issubclass(type(match_cases[0][-1]), BaseVar):
  35. raise ValueError(
  36. "For cases with return types as Vars, a default case must be provided"
  37. )
  38. return cls._create_match_cond_var_or_component(
  39. match_cond_var, match_cases, default
  40. )
  41. @classmethod
  42. def _create_condition_var(cls, cond: Any) -> BaseVar:
  43. """Convert the condition to a Var.
  44. Args:
  45. cond: The condition.
  46. Returns:
  47. The condition as a base var
  48. Raises:
  49. ValueError: If the condition is not provided.
  50. """
  51. match_cond_var = Var.create(cond, _var_is_string=type(cond) is str)
  52. if match_cond_var is None:
  53. raise ValueError("The condition must be set")
  54. return match_cond_var # type: ignore
  55. @classmethod
  56. def _process_cases(
  57. cls, cases: List
  58. ) -> Tuple[List, Optional[Union[BaseVar, BaseComponent]]]:
  59. """Process the list of match cases and the catchall default case.
  60. Args:
  61. cases: The list of match cases.
  62. Returns:
  63. The default case and the list of match case tuples.
  64. Raises:
  65. ValueError: If there are multiple default cases.
  66. """
  67. default = None
  68. if len([case for case in cases if not isinstance(case, tuple)]) > 1:
  69. raise ValueError("rx.match can only have one default case.")
  70. # Get the default case which should be the last non-tuple arg
  71. if not isinstance(cases[-1], tuple):
  72. default = cases.pop()
  73. default = (
  74. cls._create_case_var_with_var_data(default)
  75. if not isinstance(default, BaseComponent)
  76. else default
  77. )
  78. return cases, default # type: ignore
  79. @classmethod
  80. def _create_case_var_with_var_data(cls, case_element):
  81. """Convert a case element into a Var.If the case
  82. is a Style type, we extract the var data and merge it with the
  83. newly created Var.
  84. Args:
  85. case_element: The case element.
  86. Returns:
  87. The case element Var.
  88. """
  89. _var_data = case_element._var_data if isinstance(case_element, Style) else None # type: ignore
  90. case_element = Var.create(
  91. case_element, _var_is_string=type(case_element) is str
  92. )
  93. if _var_data is not None:
  94. case_element._var_data = VarData.merge(case_element._var_data, _var_data) # type: ignore
  95. return case_element
  96. @classmethod
  97. def _process_match_cases(cls, cases: List) -> List[List[BaseVar]]:
  98. """Process the individual match cases.
  99. Args:
  100. cases: The match cases.
  101. Returns:
  102. The processed match cases.
  103. Raises:
  104. ValueError: If the default case is not the last case or the tuple elements are less than 2.
  105. """
  106. match_cases = []
  107. for case in cases:
  108. if not isinstance(case, tuple):
  109. raise ValueError(
  110. "rx.match should have tuples of cases and a default case as the last argument."
  111. )
  112. # There should be at least two elements in a case tuple(a condition and return value)
  113. if len(case) < 2:
  114. raise ValueError(
  115. "A case tuple should have at least a match case element and a return value."
  116. )
  117. case_list = []
  118. for element in case:
  119. # convert all non component element to vars.
  120. el = (
  121. cls._create_case_var_with_var_data(element)
  122. if not isinstance(element, BaseComponent)
  123. else element
  124. )
  125. if not isinstance(el, (BaseVar, BaseComponent)):
  126. raise ValueError("Case element must be a var or component")
  127. case_list.append(el)
  128. match_cases.append(case_list)
  129. return match_cases
  130. @classmethod
  131. def _validate_return_types(cls, match_cases: List[List[BaseVar]]) -> None:
  132. """Validate that match cases have the same return types.
  133. Args:
  134. match_cases: The match cases.
  135. Raises:
  136. MatchTypeError: If the return types of cases are different.
  137. """
  138. first_case_return = match_cases[0][-1]
  139. return_type = type(first_case_return)
  140. if types._isinstance(first_case_return, BaseComponent):
  141. return_type = BaseComponent
  142. elif types._isinstance(first_case_return, BaseVar):
  143. return_type = BaseVar
  144. for index, case in enumerate(match_cases):
  145. if not types._issubclass(type(case[-1]), return_type):
  146. raise MatchTypeError(
  147. f"Match cases should have the same return types. Case {index} with return "
  148. f"value `{case[-1]._var_name if isinstance(case[-1], BaseVar) else textwrap.shorten(str(case[-1]), width=250)}`"
  149. f" of type {type(case[-1])!r} is not {return_type}"
  150. )
  151. @classmethod
  152. def _create_match_cond_var_or_component(
  153. cls,
  154. match_cond_var: Var,
  155. match_cases: List[List[BaseVar]],
  156. default: Optional[Union[BaseVar, BaseComponent]],
  157. ) -> Union[Component, BaseVar]:
  158. """Create and return the match condition var or component.
  159. Args:
  160. match_cond_var: The match condition.
  161. match_cases: The list of match cases.
  162. default: The default case.
  163. Returns:
  164. The match component wrapped in a fragment or the match var.
  165. Raises:
  166. ValueError: If the return types are not vars when creating a match var for Var types.
  167. """
  168. if default is None and types._issubclass(
  169. type(match_cases[0][-1]), BaseComponent
  170. ):
  171. default = Fragment.create()
  172. if types._issubclass(type(match_cases[0][-1]), BaseComponent):
  173. return Fragment.create(
  174. cls(
  175. cond=match_cond_var,
  176. match_cases=match_cases,
  177. default=default,
  178. children=[case[-1] for case in match_cases] + [default], # type: ignore
  179. )
  180. )
  181. # Validate the match cases (as well as the default case) to have Var return types.
  182. if any(
  183. case for case in match_cases if not types._isinstance(case[-1], BaseVar)
  184. ) or not types._isinstance(default, BaseVar):
  185. raise ValueError("Return types of match cases should be Vars.")
  186. # match cases and default should all be Vars at this point.
  187. # Retrieve var data of every var in the match cases and default.
  188. var_data = [
  189. *[el._var_data for case in match_cases for el in case],
  190. default._var_data, # type: ignore
  191. ]
  192. return match_cond_var._replace(
  193. _var_name=format.format_match(
  194. cond=match_cond_var._var_name_unwrapped,
  195. match_cases=match_cases, # type: ignore
  196. default=default, # type: ignore
  197. ),
  198. _var_type=default._var_type, # type: ignore
  199. _var_is_local=False,
  200. _var_full_name_needs_state_prefix=False,
  201. _var_is_string=False,
  202. merge_var_data=VarData.merge(*var_data),
  203. )
  204. def _render(self) -> Tag:
  205. return MatchTag(
  206. cond=self.cond, match_cases=self.match_cases, default=self.default
  207. )
  208. def render(self) -> Dict:
  209. """Render the component.
  210. Returns:
  211. The dictionary for template of component.
  212. """
  213. tag = self._render()
  214. tag.name = "match"
  215. return dict(tag)
  216. def _get_imports(self) -> imports.ImportDict:
  217. return imports.merge_imports(
  218. super()._get_imports(),
  219. getattr(self.cond._var_data, "imports", {}),
  220. )
  221. def _apply_theme(self, theme: Component):
  222. """Apply the theme to this component.
  223. Args:
  224. theme: The theme to apply.
  225. """
  226. # apply theme to return components.
  227. for match_case in self.match_cases:
  228. if isinstance(match_case[-1], Component):
  229. match_case[-1].apply_theme(theme)
  230. # apply theme to default component
  231. if isinstance(self.default, Component):
  232. self.default.apply_theme(theme)