Merge remote-tracking branch 'upstream/develop' into fix-corrupted-hook-state

Author: Archmonger

.github/workflows/.hatch-run.yml

@@ -43,7 +43,7 @@ jobs:
               with:
                   python-version: ${{ matrix.python-version }}
             - name: Install Python Dependencies
-              run: pip install --upgrade pip hatch uv
+              run: pip install --upgrade hatch uv
             - name: Run Scripts
               env:
                   NPM_CONFIG_TOKEN: ${{ secrets.node-auth-token }}

.github/workflows/check.yml

@@ -6,7 +6,7 @@ on:
             - main
     pull_request:
         branches:
-            - main
+            - "*"
     schedule:
         - cron: "0 0 * * 0"
 
@@ -27,8 +27,10 @@ jobs:
             job-name: "python-{0} {1}"
             run-cmd: "hatch test"
             runs-on: '["ubuntu-latest", "macos-latest", "windows-latest"]'
-            python-version: '["3.9", "3.10", "3.11"]'
+            python-version: '["3.10", "3.11", "3.12", "3.13"]'
     test-documentation:
+        # Temporarily disabled
+        if: 0
         uses: ./.github/workflows/.hatch-run.yml
         with:
             job-name: "python-{0}"

.gitignore

@@ -1,5 +1,5 @@
 # --- Build Artifacts ---
-src/reactpy/static/**/index.js*
+src/reactpy/static/*
 
 # --- Jupyter ---
 *.ipynb_checkpoints
@@ -15,8 +15,8 @@ src/reactpy/static/**/index.js*
 
 # --- Python ---
 .hatch
-.venv
-venv
+.venv*
+venv*
 MANIFEST
 build
 dist

docs/Dockerfile

@@ -33,6 +33,6 @@ RUN sphinx-build -v -W -b html source build
 # Define Entrypoint
 # -----------------
 ENV PORT=5000
-ENV REACTPY_DEBUG_MODE=1
+ENV REACTPY_DEBUG=1
 ENV REACTPY_CHECK_VDOM_SPEC=0
 CMD ["python", "main.py"]

docs/docs_app/app.py

@@ -6,7 +6,7 @@
 from docs_app.examples import get_normalized_example_name, load_examples
 from reactpy import component
 from reactpy.backend.sanic import Options, configure, use_request
-from reactpy.core.types import ComponentConstructor
+from reactpy.types import ComponentConstructor
 
 THIS_DIR = Path(__file__).parent
 DOCS_DIR = THIS_DIR.parent

docs/source/_exts/autogen_api_docs.py

@@ -43,7 +43,7 @@ def generate_api_docs():
         if file.name == "__init__.py":
             if file.parent != PYTHON_PACKAGE:
                 content.append(make_package_section(file))
-        else:
+        elif not file.name.startswith("_"):
             content.append(make_module_section(file))
 
     API_FILE.write_text("\n".join(content))

docs/source/about/changelog.rst

@@ -15,17 +15,44 @@ Changelog
 Unreleased
 ----------
 
+**Added**
+- :pull:`1113` - Added ``reactpy.ReactPy`` that can be used to run ReactPy in standalone mode.
+- :pull:`1113` - Added ``reactpy.ReactPyMiddleware`` that can be used to run ReactPy with any ASGI compatible framework.
+- :pull:`1113` - Added ``reactpy.jinja.Component`` that can be used alongside ``ReactPyMiddleware`` to embed several ReactPy components into your existing application.
+- :pull:`1113` - Added ``standard``, ``uvicorn``, ``jinja`` installation extras (for example ``pip install reactpy[standard]``).
+- :pull:`1113` - Added support for Python 3.12 and 3.13.
+
 **Changed**
 
 - :pull:`1251` - Substitute client-side usage of ``react`` with ``preact``.
 - :pull:`1239` - Script elements no longer support behaving like effects. They now strictly behave like plain HTML script elements.
+- :pull:`1255` - The ``reactpy.html`` module has been modified to allow for auto-creation of any HTML nodes. For example, you can create a ``<data-table>`` element by calling ``html.data_table()``.
+- :pull:`1256` - Change ``set_state`` comparison method to check equality with ``==`` more consistently.
+- :pull:`1257` - Add support for rendering ``@component`` children within ``vdom_to_html``.
+- :pull:`1113` - Renamed the ``use_location`` hook's ``search`` attribute to ``query_string``.
+- :pull:`1113` - Renamed the ``use_location`` hook's ``pathname`` attribute to ``path``.
+- :pull:`1113` - Renamed ``reactpy.config.REACTPY_DEBUG_MODE`` to ``reactpy.config.REACTPY_DEBUG``.
+
+**Removed**
+
+- :pull:`1255` - Removed the ability to import ``reactpy.html.*`` elements directly. You must now call ``html.*`` to access the elements.
+- :pull:`1255` - Removed ``reactpy.sample`` module.
+- :pull:`1255` - Removed ``reactpy.svg`` module. Contents previously within ``reactpy.svg.*`` can now be accessed via ``html.svg.*``.
+- :pull:`1255` - Removed ``reactpy.html._`` function. Use ``html.fragment`` instead.
+- :pull:`1113` - Removed ``reactpy.run``. See the documentation for the new method to run ReactPy applications.
+- :pull:`1113` - Removed ``reactpy.backend.*``. See the documentation for the new method to run ReactPy applications.
+- :pull:`1113` - Removed ``reactpy.core.types`` module. Use ``reactpy.types`` instead.
+- :pull:`1113` - All backend related installation extras (such as ``pip install reactpy[starlette]``) have been removed.
+- :pull:`1113` - Removed deprecated function ``module_from_template``.
+- :pull:`1113` - Removed support for Python 3.9.
 
 **Fixed**
 
 - :pull:`1239` - Fixed a bug where script elements would not render to the DOM as plain text.
 
 v1.1.0
 ------
+:octicon:`milestone` *released on 2024-11-24*
 
 **Fixed**
 
@@ -61,6 +88,7 @@ v1.1.0
 
 v1.0.2
 ------
+:octicon:`milestone` *released on 2023-07-03*
 
 **Fixed**
 
@@ -69,6 +97,7 @@ v1.0.2
 
 v1.0.1
 ------
+:octicon:`milestone` *released on 2023-06-16*
 
 **Changed**
 

docs/source/guides/escape-hatches/distributing-javascript.rst

@@ -188,7 +188,7 @@ loaded with :func:`~reactpy.web.module.export`.
 
 .. note::
 
-    When :data:`reactpy.config.REACTPY_DEBUG_MODE` is active, named exports will be validated.
+    When :data:`reactpy.config.REACTPY_DEBUG` is active, named exports will be validated.
 
 The remaining files that we need to create are concerned with creating a Python package.
 We won't cover all the details here, so refer to the Setuptools_ documentation for

docs/source/guides/getting-started/_examples/run_starlette.py

@@ -1,4 +1,4 @@
-# :lines: 11-
+# :lines: 10-
 
 from reactpy import run
 from reactpy.backend import starlette as starlette_server

docs/source/guides/getting-started/running-reactpy.rst

@@ -103,29 +103,29 @@ Running ReactPy in Debug Mode
 -----------------------------
 
 ReactPy provides a debug mode that is turned off by default. This can be enabled when you
-run your application by setting the ``REACTPY_DEBUG_MODE`` environment variable.
+run your application by setting the ``REACTPY_DEBUG`` environment variable.
 
 .. tab-set::
 
     .. tab-item:: Unix Shell
 
         .. code-block::
 
-            export REACTPY_DEBUG_MODE=1
+            export REACTPY_DEBUG=1
             python my_reactpy_app.py
 
     .. tab-item:: Command Prompt
 
         .. code-block:: text
 
-            set REACTPY_DEBUG_MODE=1
+            set REACTPY_DEBUG=1
             python my_reactpy_app.py
 
     .. tab-item:: PowerShell
 
         .. code-block:: powershell
 
-            $env:REACTPY_DEBUG_MODE = "1"
+            $env:REACTPY_DEBUG = "1"
             python my_reactpy_app.py
 
 .. danger::