reflex 0.4.6a4__tar.gz → 0.4.7__tar.gz

{reflex-0.4.6a4 → reflex-0.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: reflex
-Version: 0.4.6a4
+Version: 0.4.7
 Summary: Web apps in pure Python.
 Home-page: https://reflex.dev
 License: Apache-2.0
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: alembic (>=1.11.1,<2.0)
 Requires-Dist: build (>=1.0.3,<2.0)
 Requires-Dist: charset-normalizer (>=3.3.2,<4.0)
@@ -74,6 +75,18 @@ Description-Content-Type: text/markdown
 [English](https://github.com/reflex-dev/reflex/blob/main/README.md) | [简体中文](https://github.com/reflex-dev/reflex/blob/main/docs/zh/zh_cn/README.md) | [繁體中文](https://github.com/reflex-dev/reflex/blob/main/docs/zh/zh_tw/README.md) | [Türkçe](https://github.com/reflex-dev/reflex/blob/main/docs/tr/README.md) | [हिंदी](https://github.com/reflex-dev/reflex/blob/main/docs/in/README.md) | [Português (Brasil)](https://github.com/reflex-dev/reflex/blob/main/docs/pt/pt_br/README.md) | [Italiano](https://github.com/reflex-dev/reflex/blob/main/docs/it/README.md) | [Español](https://github.com/reflex-dev/reflex/blob/main/docs/es/README.md) | [한국어](https://github.com/reflex-dev/reflex/blob/main/docs/kr/README.md)
 
 ---
+
+# Reflex
+
+Reflex is a library to build full-stack web apps in pure Python.
+
+Key features:
+* **Pure Python** - Write your app's frontend and backend all in Python, no need to learn Javascript.
+* **Full Flexibility** - Reflex is easy to get started with, but can also scale to complex apps.
+* **Deploy Instantly** - After building, deploy your app with a [single command](https://reflex.dev/docs/hosting/deploy-quick-start/) or host it on your own server.
+
+See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architecture/#the-reflex-architecture) to learn how Reflex works under the hood.
+
 ## ⚙️ Installation
 
 Open a terminal and run (Requires Python 3.8+):
@@ -263,19 +276,11 @@ You can create a multi-page app by adding more pages.
 </div>
 
 
-
-
-
 ## ✅ Status
 
 Reflex launched in December 2022 with the name Pynecone.
 
-As of July 2023, we are in the **Public Beta** stage.
-
--   :white_check_mark: **Public Alpha**: Anyone can install and use Reflex. There may be issues, but we are working to resolve them actively.
--   :large_orange_diamond: **Public Beta**: Stable enough for non-enterprise use-cases.
--   **Public Hosting Beta**: _Optionally_, deploy and host your apps on Reflex!
--   **Public**: Reflex is production ready.
+As of February 2024, our hosting service is in alpha! During this time anyone can deploy their apps for free. See our [roadmap](https://github.com/reflex-dev/reflex/issues/2727) to see what's planned.
 
 Reflex has new releases and features coming every week! Make sure to :star: star and :eyes: watch this repository to stay up to date.
 

{reflex-0.4.6a4 → reflex-0.4.7}/README.md

@@ -21,6 +21,18 @@
 [English](https://github.com/reflex-dev/reflex/blob/main/README.md) | [简体中文](https://github.com/reflex-dev/reflex/blob/main/docs/zh/zh_cn/README.md) | [繁體中文](https://github.com/reflex-dev/reflex/blob/main/docs/zh/zh_tw/README.md) | [Türkçe](https://github.com/reflex-dev/reflex/blob/main/docs/tr/README.md) | [हिंदी](https://github.com/reflex-dev/reflex/blob/main/docs/in/README.md) | [Português (Brasil)](https://github.com/reflex-dev/reflex/blob/main/docs/pt/pt_br/README.md) | [Italiano](https://github.com/reflex-dev/reflex/blob/main/docs/it/README.md) | [Español](https://github.com/reflex-dev/reflex/blob/main/docs/es/README.md) | [한국어](https://github.com/reflex-dev/reflex/blob/main/docs/kr/README.md)
 
 ---
+
+# Reflex
+
+Reflex is a library to build full-stack web apps in pure Python.
+
+Key features:
+* **Pure Python** - Write your app's frontend and backend all in Python, no need to learn Javascript.
+* **Full Flexibility** - Reflex is easy to get started with, but can also scale to complex apps.
+* **Deploy Instantly** - After building, deploy your app with a [single command](https://reflex.dev/docs/hosting/deploy-quick-start/) or host it on your own server.
+
+See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architecture/#the-reflex-architecture) to learn how Reflex works under the hood.
+
 ## ⚙️ Installation
 
 Open a terminal and run (Requires Python 3.8+):
@@ -210,19 +222,11 @@ You can create a multi-page app by adding more pages.
 </div>
 
 
-
-
-
 ## ✅ Status
 
 Reflex launched in December 2022 with the name Pynecone.
 
-As of July 2023, we are in the **Public Beta** stage.
-
--   :white_check_mark: **Public Alpha**: Anyone can install and use Reflex. There may be issues, but we are working to resolve them actively.
--   :large_orange_diamond: **Public Beta**: Stable enough for non-enterprise use-cases.
--   **Public Hosting Beta**: _Optionally_, deploy and host your apps on Reflex!
--   **Public**: Reflex is production ready.
+As of February 2024, our hosting service is in alpha! During this time anyone can deploy their apps for free. See our [roadmap](https://github.com/reflex-dev/reflex/issues/2727) to see what's planned.
 
 Reflex has new releases and features coming every week! Make sure to :star: star and :eyes: watch this repository to stay up to date.
 

{reflex-0.4.6a4 → reflex-0.4.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "reflex"
-version = "0.4.6a4"
+version = "0.4.7"
 description = "Web apps in pure Python."
 license = "Apache-2.0"
 authors = [

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/.templates/apps/blank/code/blank.py

@@ -23,6 +23,7 @@ def index() -> rx.Component:
                 on_click=lambda: rx.redirect(docs_url),
                 size="4",
             ),
+            rx.logo(),
             align="center",
             spacing="7",
             font_size="2em",

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/.templates/jinja/custom_components/pyproject.toml.jinja2

@@ -10,7 +10,7 @@ readme = "README.md"
 license = { text = "Apache-2.0" }
 requires-python = ">=3.8"
 authors = [{ name = "", email = "YOUREMAIL@domain.com" }]
-keywords = ["reflex", "reflex-custom-components"]
+keywords = ["reflex","reflex-custom-components"]
 
 dependencies = ["reflex>=0.4.2"]
 

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/.templates/jinja/custom_components/src.py.jinja2

@@ -4,9 +4,9 @@
 
 import reflex as rx
 
-# Some libraries you may want to wrap may require dynamic imports.
+# Some libraries you want to wrap may require dynamic imports.
 # This is because they they may not be compatible with Server-Side Rendering (SSR).
-# To handle this in Reflex all you need to do is subclass NoSSRComponent instead.
+# To handle this in Reflex, all you need to do is subclass `NoSSRComponent` instead.
 # For example:
 # from reflex.components.component import NoSSRComponent
 # class {{ component_class_name }}(NoSSRComponent):
@@ -42,12 +42,12 @@ class {{ component_class_name }}(rx.Component):
     # In this case you can use the lib_dependencies property to specify other libraries to install.
     # lib_dependencies: list[str] = []
 
-    # Event triggers, I did not understand the wording of the doc.
-    # def get_event_triggers(self) -> dict[str, Any]:
-    #     return {
-    #         **super().get_event_triggers(),
-    #         "on_change": lambda e0: [e0],
-    #     }
+    # Event triggers declaration if any.
+    # Below is equivalent to merging `{ "on_change": lambda e: [e] }`
+    # onto the default event triggers of parent/base Component.
+    # The function defined for the `on_change` trigger maps event for the javascript
+    # trigger to what will be passed to the backend event handler function.
+    # on_change: rx.EventHandler[lambda e: [e]]
 
     # To add custom code to your component
     # def _get_custom_code(self) -> str:

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/.templates/jinja/web/pages/index.js.jinja2

@@ -8,10 +8,6 @@
 
 {% block export %}
 export default function Component() {
-  {% for ref_hook in ref_hooks %}
-  {{ ref_hook }}
-  {% endfor %}
-  
   {% for hook in hooks %}
   {{ hook }}
   {% endfor %}

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/.templates/jinja/web/pages/stateful_component.js.jinja2

@@ -1,11 +1,7 @@
 {% import 'web/pages/utils.js.jinja2' as utils %}
 
 export function {{tag_name}} () {
-  {% for ref_hook in component.get_ref_hooks() %}
-  {{ ref_hook }}
-  {% endfor %}
-
-  {% for hook in component.get_hooks_internal() %}
+  {% for hook in component._get_all_hooks_internal() %}
   {{ hook }}
   {% endfor %}
 
@@ -13,7 +9,7 @@ export function {{tag_name}} () {
   {{ hook }}
   {% endfor %}
 
-  {% for hook in component.get_hooks() %}
+  {% for hook in component._get_all_hooks() %}
   {{ hook }}
   {% endfor %}
 

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/.templates/web/utils/state.js

@@ -646,7 +646,12 @@ export const useEventLoop = (
 
   // Route after the initial page hydration.
   useEffect(() => {
-    const change_start = () => dispatch["state"]({is_hydrated: false})
+    const change_start = () => {
+      const main_state_dispatch = dispatch["state"]
+      if (main_state_dispatch !== undefined) {
+        main_state_dispatch({is_hydrated: false})
+      }
+    }
     const change_complete = () => addEvents(onLoadInternalEvent());
     router.events.on("routeChangeStart", change_start);
     router.events.on("routeChangeComplete", change_complete);

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/__init__.py

@@ -109,9 +109,11 @@ _ALL_COMPONENTS = [
     "unordered_list",
     "ordered_list",
     "moment",
+    "logo",
 ]
 
 _MAPPING = {
+    "reflex.experimental": ["_x"],
     "reflex.admin": ["admin", "AdminDash"],
     "reflex.app": ["app", "App", "UploadFile"],
     "reflex.base": ["base", "Base"],

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/__init__.pyi

@@ -1,3 +1,4 @@
+from reflex.experimental import _x as _x
 from reflex import admin as admin
 from reflex.admin import AdminDash as AdminDash
 from reflex import app as app
@@ -95,6 +96,7 @@ from reflex.components import list_item as list_item
 from reflex.components import unordered_list as unordered_list
 from reflex.components import ordered_list as ordered_list
 from reflex.components import moment as moment
+from reflex.components import logo as logo
 from reflex.components.component import Component as Component
 from reflex.components.component import NoSSRComponent as NoSSRComponent
 from reflex.components.component import memo as memo

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/app.py

@@ -214,12 +214,7 @@ class App(Base):
             self.setup_state()
 
     def setup_state(self) -> None:
-        """Set up the state for the app.
-
-        Raises:
-            ValueError: If the event namespace is not provided in the config.
-                        If the state has not been enabled.
-        """
+        """Set up the state for the app."""
         if not self.state:
             return
 
@@ -246,9 +241,6 @@ class App(Base):
         self.socket_app = ASGIApp(self.sio, socketio_path="")
         namespace = config.get_event_namespace()
 
-        if not namespace:
-            raise ValueError("event namespace must be provided in the config.")
-
         # Create the event namespace and attach the main app. Not related to any paths.
         self.event_namespace = EventNamespace(namespace, self)
 
@@ -457,6 +449,10 @@ class App(Base):
         # Generate the component if it is a callable.
         component = self._generate_component(component)
 
+        # unpack components that return tuples in an rx.fragment.
+        if isinstance(component, tuple):
+            component = Fragment.create(*component)
+
         # Ensure state is enabled if this page uses state.
         if self.state is None:
             if on_load or component._has_event_triggers():
@@ -657,7 +653,7 @@ class App(Base):
 
     def _app_root(self, app_wrappers: dict[tuple[int, str], Component]) -> Component:
         for component in tuple(app_wrappers.values()):
-            app_wrappers.update(component.get_app_wrap_components())
+            app_wrappers.update(component._get_all_app_wrap_components())
         order = sorted(app_wrappers, key=lambda k: k[0], reverse=True)
         root = parent = copy.deepcopy(app_wrappers[order[0]])
         for key in order[1:]:
@@ -795,18 +791,18 @@ class App(Base):
 
         for _route, component in self.pages.items():
             # Merge the component style with the app style.
-            component.add_style(self.style)
+            component._add_style_recursive(self.style)
 
             component.apply_theme(self.theme)
 
-            # Add component.get_imports() to all_imports.
-            all_imports.update(component.get_imports())
+            # Add component._get_all_imports() to all_imports.
+            all_imports.update(component._get_all_imports())
 
             # Add the app wrappers from this component.
-            app_wrappers.update(component.get_app_wrap_components())
+            app_wrappers.update(component._get_all_app_wrap_components())
 
             # Add the custom components from the page to the set.
-            custom_components |= component.get_custom_components()
+            custom_components |= component._get_all_custom_components()
 
         progress.advance(task)
 
@@ -928,7 +924,7 @@ class App(Base):
             all_imports.update(custom_components_imports)
 
         # Get imports from AppWrap components.
-        all_imports.update(app_root.get_imports())
+        all_imports.update(app_root._get_all_imports())
 
         progress.advance(task)
 

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/app.pyi

@@ -94,7 +94,9 @@ class App(Base):
         **kwargs
     ) -> None: ...
     def __call__(self) -> FastAPI: ...
+    def enable_state(self) -> None: ...
     def add_default_endpoints(self) -> None: ...
+    def add_optional_endpoints(self): ...
     def add_cors(self) -> None: ...
     async def preprocess(self, state: State, event: Event) -> StateUpdate | None: ...
     async def postprocess(

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/compiler/compiler.py

@@ -33,7 +33,7 @@ def _compile_document_root(root: Component) -> str:
         The compiled document root.
     """
     return templates.DOCUMENT_ROOT.render(
-        imports=utils.compile_imports(root.get_imports()),
+        imports=utils.compile_imports(root._get_all_imports()),
         document=root.render(),
     )
 
@@ -48,9 +48,9 @@ def _compile_app(app_root: Component) -> str:
         The compiled app.
     """
     return templates.APP_ROOT.render(
-        imports=utils.compile_imports(app_root.get_imports()),
-        custom_codes=app_root.get_custom_code(),
-        hooks=app_root.get_hooks_internal() | app_root.get_hooks(),
+        imports=utils.compile_imports(app_root._get_all_imports()),
+        custom_codes=app_root._get_all_custom_code(),
+        hooks={**app_root._get_all_hooks_internal(), **app_root._get_all_hooks()},
         render=app_root.render(),
     )
 
@@ -109,7 +109,7 @@ def _compile_page(
     Returns:
         The compiled component.
     """
-    imports = component.get_imports()
+    imports = component._get_all_imports()
     imports = utils.compile_imports(imports)
 
     # Compile the code to render the component.
@@ -117,10 +117,9 @@ def _compile_page(
 
     return templates.PAGE.render(
         imports=imports,
-        dynamic_imports=component.get_dynamic_imports(),
-        custom_codes=component.get_custom_code(),
-        ref_hooks=component.get_ref_hooks(),
-        hooks=component.get_hooks_internal() | component.get_hooks(),
+        dynamic_imports=component._get_all_dynamic_imports(),
+        custom_codes=component._get_all_custom_code(),
+        hooks={**component._get_all_hooks_internal(), **component._get_all_hooks()},
         render=component.render(),
         **kwargs,
     )
@@ -265,9 +264,9 @@ def _compile_stateful_components(
             component.rendered_as_shared = False
 
             rendered_components.update(
-                {code: None for code in component.get_custom_code()},
+                {code: None for code in component._get_all_custom_code()},
             )
-            all_import_dicts.append(component.get_imports())
+            all_import_dicts.append(component._get_all_imports())
 
             # Indicate that this component now imports from the shared file.
             component.rendered_as_shared = True

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/compiler/utils.py

@@ -252,7 +252,7 @@ def compile_custom_component(
     # Get the imports.
     imports = {
         lib: fields
-        for lib, fields in render.get_imports().items()
+        for lib, fields in render._get_all_imports().items()
         if lib != component.library
     }
 
@@ -265,8 +265,8 @@ def compile_custom_component(
             "name": component.tag,
             "props": props,
             "render": render.render(),
-            "hooks": render.get_hooks_internal() | render.get_hooks(),
-            "custom_code": render.get_custom_code(),
+            "hooks": {**render._get_all_hooks_internal(), **render._get_all_hooks()},
+            "custom_code": render._get_all_custom_code(),
         },
         imports,
     )

{reflex-0.4.6a4 → reflex-0.4.7}/reflex/components/chakra/forms/pininput.py

@@ -1,4 +1,5 @@
 """A pin input component."""
+
 from __future__ import annotations
 
 from typing import Any, Optional, Union
@@ -71,7 +72,7 @@ class PinInput(ChakraComponent):
         range_var = Var.range(0)
         return merge_imports(
             super()._get_imports(),
-            PinInputField().get_imports(),  # type: ignore
+            PinInputField()._get_all_imports(),  # type: ignore
             range_var._var_data.imports if range_var._var_data is not None else {},
         )