reflex 0.8.15a2__tar.gz → 0.8.21__tar.gz

{reflex-0.8.15a2 → reflex-0.8.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex
-Version: 0.8.15a2
+Version: 0.8.21
 Summary: Web apps in pure Python.
 Project-URL: homepage, https://reflex.dev
 Project-URL: repository, https://github.com/reflex-dev/reflex
@@ -30,13 +30,13 @@ Requires-Dist: psutil<8.0,>=7.0.0; sys_platform == 'win32'
 Requires-Dist: pydantic<3.0,>=1.10.21
 Requires-Dist: python-multipart<1.0,>=0.0.20
 Requires-Dist: python-socketio<6.0,>=5.12.0
-Requires-Dist: redis<7.0,>=5.2.1
-Requires-Dist: reflex-hosting-cli>=0.1.55
+Requires-Dist: redis<8.0,>=5.2.1
+Requires-Dist: reflex-hosting-cli>=0.1.59
 Requires-Dist: rich<15,>=13
 Requires-Dist: sqlmodel<0.1,>=0.0.27
 Requires-Dist: starlette>=0.47.0
 Requires-Dist: typing-extensions>=4.13.0
-Requires-Dist: wrapt<2.0,>=1.17.0
+Requires-Dist: wrapt<3.0,>=1.17.0
 Provides-Extra: db
 Requires-Dist: alembic<2.0,>=1.15.2; extra == 'db'
 Requires-Dist: pydantic<3.0,>=1.10.21; extra == 'db'
@@ -86,25 +86,50 @@ See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architectu
 
 ## ⚙️ Installation
 
-Open a terminal and run (Requires Python 3.10+):
-
-```bash
-pip install reflex
-```
+**Important:** We strongly recommend using a virtual environment to ensure the `reflex` command is available in your PATH.
 
 ## 🥳 Create your first app
 
-Installing `reflex` also installs the `reflex` command line tool.
+### 1. Create the project directory
 
-Test that the install was successful by creating a new project. (Replace `my_app_name` with your project name):
+Replace `my_app_name` with your project name:
 
 ```bash
 mkdir my_app_name
 cd my_app_name
+```
+
+### 2. Set up a virtual environment
+
+Create and activate virtual environment
+
+```bash
+# On Windows:
+python -m venv .venv
+.venv\Scripts\activate
+
+# On macOS/Linux:
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+### 3. Install Reflex
+
+Reflex is available as a pip package (Requires Python 3.10+):
+
+```bash
+pip install reflex
+```
+
+### 4. Initialize the project
+
+This command initializes a template app in your new directory:
+
+```bash
 reflex init
 ```
 
-This command initializes a template app in your new directory.
+### 5. Run the app
 
 You can run this app in development mode:
 
@@ -116,6 +141,10 @@ You should see your app running at http://localhost:3000.
 
 Now you can modify the source code in `my_app_name/my_app_name.py`. Reflex has fast refreshes so you can see your changes instantly when you save your code.
 
+### Troubleshooting
+
+If you installed Reflex without a virtual environment and the `reflex` command is not found, you can run commands using: `python3 -m reflex init` and `python3 -m reflex run`
+
 ## 🫧 Example App
 
 Let's go over an example: creating an image generation UI around [DALL·E](https://platform.openai.com/docs/guides/images/image-generation?context=node). For simplicity, we just call the [OpenAI API](https://platform.openai.com/docs/api-reference/authentication), but you could replace this with an ML model run locally.

{reflex-0.8.15a2 → reflex-0.8.21}/README.md

@@ -39,25 +39,50 @@ See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architectu
 
 ## ⚙️ Installation
 
-Open a terminal and run (Requires Python 3.10+):
-
-```bash
-pip install reflex
-```
+**Important:** We strongly recommend using a virtual environment to ensure the `reflex` command is available in your PATH.
 
 ## 🥳 Create your first app
 
-Installing `reflex` also installs the `reflex` command line tool.
+### 1. Create the project directory
 
-Test that the install was successful by creating a new project. (Replace `my_app_name` with your project name):
+Replace `my_app_name` with your project name:
 
 ```bash
 mkdir my_app_name
 cd my_app_name
+```
+
+### 2. Set up a virtual environment
+
+Create and activate virtual environment
+
+```bash
+# On Windows:
+python -m venv .venv
+.venv\Scripts\activate
+
+# On macOS/Linux:
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+### 3. Install Reflex
+
+Reflex is available as a pip package (Requires Python 3.10+):
+
+```bash
+pip install reflex
+```
+
+### 4. Initialize the project
+
+This command initializes a template app in your new directory:
+
+```bash
 reflex init
 ```
 
-This command initializes a template app in your new directory.
+### 5. Run the app
 
 You can run this app in development mode:
 
@@ -69,6 +94,10 @@ You should see your app running at http://localhost:3000.
 
 Now you can modify the source code in `my_app_name/my_app_name.py`. Reflex has fast refreshes so you can see your changes instantly when you save your code.
 
+### Troubleshooting
+
+If you installed Reflex without a virtual environment and the `reflex` command is not found, you can run commands using: `python3 -m reflex init` and `python3 -m reflex run`
+
 ## 🫧 Example App
 
 Let's go over an example: creating an image generation UI around [DALL·E](https://platform.openai.com/docs/guides/images/image-generation?context=node). For simplicity, we just call the [OpenAI API](https://platform.openai.com/docs/api-reference/authentication), but you could replace this with an ML model run locally.

{reflex-0.8.15a2 → reflex-0.8.21}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reflex"
-version = "0.8.15a2"
+version = "0.8.21"
 description = "Web apps in pure Python."
 license.text = "Apache-2.0"
 authors = [
@@ -30,13 +30,13 @@ dependencies = [
   "pydantic >=1.10.21,<3.0",
   "python-multipart >=0.0.20,<1.0",
   "python-socketio >=5.12.0,<6.0",
-  "redis >=5.2.1,<7.0",
-  "reflex-hosting-cli >=0.1.55",
+  "redis >=5.2.1,<8.0",
+  "reflex-hosting-cli >=0.1.59",
   "rich >=13,<15",
   "sqlmodel >=0.0.27,<0.1",
   "starlette >=0.47.0",
   "typing_extensions >=4.13.0",
-  "wrapt >=1.17.0,<2.0",
+  "wrapt >=1.17.0,<3.0",
 ]
 
 classifiers = [
@@ -123,6 +123,7 @@ reportIncompatibleMethodOverride = false
 target-version = "py310"
 output-format = "concise"
 lint.isort.split-on-trailing-comma = false
+preview = true
 lint.select = ["ALL"]
 lint.ignore = [
   "A",
@@ -134,12 +135,18 @@ lint.ignore = [
   "BLE",
   "C901",
   "COM",
+  "CPY001",
   "D205",
+  "DOC202",
+  "DOC501",
+  "DOC502",
   "DTZ",
   "E501",
   "F403",
   "FBT",
   "FIX",
+  "FURB189",
+  "FURB140",
   "G004",
   "ISC003",
   "PLC",
@@ -180,6 +187,7 @@ lint.flake8-bugbear.extend-immutable-calls = [
 "*.pyi" = ["D301", "D415", "D417", "D418", "E742", "N", "PGH"]
 "pyi_generator.py" = ["N802"]
 "reflex/constants/*.py" = ["N"]
+"reflex/.templates/apps/blank/code/*" = ["INP001"]
 "*/blank.py" = ["I001"]
 
 [tool.pytest.ini_options]
@@ -235,7 +243,7 @@ fail_fast = true
 
 [[tool.pre-commit.repos]]
 repo = "https://github.com/astral-sh/ruff-pre-commit"
-rev = "v0.13.3"
+rev = "v0.14.6"
 hooks = [
   { id = "ruff-format", args = [
     "reflex",
@@ -267,14 +275,9 @@ hooks = [
 
 [[tool.pre-commit.repos]]
 repo = "https://github.com/RobertCraigie/pyright-python"
-rev = "v1.1.406"
+rev = "v1.1.407"
 hooks = [{ id = "pyright", args = ["reflex", "tests"], language = "system" }]
 
-[[tool.pre-commit.repos]]
-repo = "https://github.com/terrencepreilly/darglint"
-rev = "v1.8.1"
-hooks = [{ id = "darglint", exclude = "^reflex/reflex.py" }]
-
 [[tool.pre-commit.repos]]
 repo = "https://github.com/pre-commit/mirrors-prettier"
 rev = "f62a70a3a7114896b062de517d72829ea1c884b6"

{reflex-0.8.15a2 → reflex-0.8.21}/reflex/.templates/web/utils/state.js

@@ -176,7 +176,7 @@ export const queueEventIfSocketExists = async (
   if (!socket) {
     return;
   }
-  await queueEvents(events, socket, navigate, params);
+  await queueEvents(events, socket, false, navigate, params);
 };
 
 /**
@@ -256,13 +256,13 @@ export const applyEvent = async (event, socket, navigate, params) => {
 
   if (event.name == "_clear_session_storage") {
     sessionStorage.clear();
-    queueEvents(initialEvents(), socket, navigate, params);
+    queueEventIfSocketExists(initialEvents(), socket, navigate, params);
     return false;
   }
 
   if (event.name == "_remove_session_storage") {
     sessionStorage.removeItem(event.payload.key);
-    queueEvents(initialEvents(), socket, navigate, params);
+    queueEventIfSocketExists(initialEvents(), socket, navigate, params);
     return false;
   }
 
@@ -568,6 +568,7 @@ export const connect = async (
       !socket.current.wait_connect
     ) {
       socket.current.wait_connect = true;
+      socket.current.rehydrate = true;
       socket.current.io.opts.query = { token: getToken() }; // Update token for reconnect.
       socket.current.connect();
     }
@@ -615,6 +616,16 @@ export const connect = async (
     window.addEventListener("pagehide", pagehideHandler);
     window.addEventListener("beforeunload", disconnectTrigger);
     window.addEventListener("unload", disconnectTrigger);
+    if (socket.current.rehydrate) {
+      socket.current.rehydrate = false;
+      queueEvents(
+        initialEvents(),
+        socket,
+        true,
+        navigate,
+        () => params.current,
+      );
+    }
     // Drain any initial events from the queue.
     while (event_queue.length > 0 && !event_processing) {
       await processEvent(socket.current, navigate, () => params.current);
@@ -665,7 +676,9 @@ export const connect = async (
       }
     }
     applyClientStorageDelta(client_storage, update.delta);
-    event_processing = !update.final;
+    if (update.final !== null) {
+      event_processing = !update.final;
+    }
     if (update.events) {
       queueEvents(update.events, socket, false, navigate, params);
     }
@@ -852,7 +865,7 @@ export const useEventLoop = (
       await connect(
         socket,
         dispatch,
-        ["websocket"],
+        [env.TRANSPORT],
         setConnectErrors,
         client_storage,
         navigate,