reflex 0.8.15a2__tar.gz → 0.8.23a4__tar.gz

{reflex-0.8.15a2 → reflex-0.8.23a4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex
-Version: 0.8.15a2
+Version: 0.8.23a4
 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.23a4}/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.23a4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reflex"
-version = "0.8.15a2"
+version = "0.8.23a4"
 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.8"
 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.23a4/reflex/.templates/web/utils/helpers/paste.js

@@ -0,0 +1,105 @@
+import { useEffect, useRef } from "react";
+
+const handle_paste_data = (clipboardData) =>
+  new Promise((resolve, reject) => {
+    const pasted_data = [];
+    const n_items = clipboardData.items.length;
+    const extract_data = (item) => {
+      const type = item.type;
+      if (item.kind === "string") {
+        item.getAsString((data) => {
+          pasted_data.push([type, data]);
+          if (pasted_data.length === n_items) {
+            resolve(pasted_data);
+          }
+        });
+      } else if (item.kind === "file") {
+        const file = item.getAsFile();
+        const reader = new FileReader();
+        reader.onload = (e) => {
+          pasted_data.push([type, e.target.result]);
+          if (pasted_data.length === n_items) {
+            resolve(pasted_data);
+          }
+        };
+        if (type.indexOf("text/") === 0) {
+          reader.readAsText(file);
+        } else {
+          reader.readAsDataURL(file);
+        }
+      }
+    };
+    for (const item of clipboardData.items) {
+      extract_data(item);
+    }
+  });
+
+export default function usePasteHandler(target_ids, event_actions, on_paste) {
+  const onPasteRef = useRef(on_paste);
+  const eventActionsRef = useRef(event_actions);
+
+  useEffect(() => {
+    onPasteRef.current = on_paste;
+  }, [on_paste]);
+  useEffect(() => {
+    eventActionsRef.current = event_actions;
+  }, [event_actions]);
+
+  useEffect(() => {
+    const handle_paste = (_ev) => {
+      eventActionsRef.current?.preventDefault && _ev.preventDefault();
+      eventActionsRef.current?.stopPropagation && _ev.stopPropagation();
+      handle_paste_data(_ev.clipboardData).then(onPasteRef.current);
+    };
+
+    let cleanupListeners = null;
+    let observer = null;
+
+    const attachListeners = (targets) => {
+      targets.forEach((target) =>
+        target.addEventListener("paste", handle_paste, false),
+      );
+      return () => {
+        targets.forEach((target) =>
+          target.removeEventListener("paste", handle_paste, false),
+        );
+      };
+    };
+
+    const tryAttach = () => {
+      if (target_ids.length === 0) {
+        cleanupListeners = attachListeners([document]);
+        return true;
+      }
+      const targets = target_ids
+        .map((id) => document.getElementById(id))
+        .filter((element) => !!element);
+
+      if (targets.length === target_ids.length) {
+        cleanupListeners = attachListeners(targets);
+        return true;
+      }
+
+      return false;
+    };
+
+    if (!tryAttach()) {
+      observer = new MutationObserver(() => {
+        if (tryAttach()) {
+          observer.disconnect();
+          observer = null;
+        }
+      });
+      observer.observe(document.body, { childList: true, subtree: true });
+    }
+
+    return () => {
+      if (observer) {
+        observer.disconnect();
+      }
+      if (cleanupListeners) {
+        cleanupListeners();
+      }
+    };
+  }, [target_ids]);
+}

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

@@ -56,10 +56,10 @@ export const generateUUID = () => {
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
     let r = Math.random() * 16;
     if (d > 0) {
-      r = (d + r) % 16 | 0;
+      r = ((d + r) % 16) | 0;
       d = Math.floor(d / 16);
     } else {
-      r = (d2 + r) % 16 | 0;
+      r = ((d2 + r) % 16) | 0;
       d2 = Math.floor(d2 / 16);
     }
     return (c == "x" ? r : (r & 0x7) | 0x8).toString(16);
@@ -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,

{reflex-0.8.15a2 → reflex-0.8.23a4}/reflex/__init__.py

@@ -336,6 +336,7 @@ _MAPPING: dict = {
         "State",
         "dynamic",
     ],
+    "istate.shared": ["SharedState"],
     "istate.wrappers": ["get_state"],
     "style": ["Style", "toggle_color_mode"],
     "utils.imports": ["ImportDict", "ImportVar"],

{reflex-0.8.15a2 → reflex-0.8.23a4}/reflex/__init__.pyi

@@ -148,6 +148,7 @@ from .event import (
     window_alert,
 )
 from .experimental import _x
+from .istate.shared import SharedState
 from .istate.storage import Cookie, LocalStorage, SessionStorage
 from .istate.wrappers import get_state
 from .middleware import Middleware, middleware
@@ -205,6 +206,7 @@ __all__ = [
     "PropsBase",
     "Script",
     "SessionStorage",
+    "SharedState",
     "State",
     "Style",
     "UploadFile",