Merge remote-tracking branch 'upstream/main' into use-db-for-clean-tracking

Author: Archmonger

.github/workflows/test-docs.yml

@@ -33,5 +33,4 @@ jobs:
                   pip install -r requirements/check-style.txt
                   mypy --show-error-codes docs/python/
                   black docs/python/ --check
-                  isort docs/python/ --check-only
-                  flake8 docs/python/
+                  ruff check docs/python/

.github/workflows/test-src.yml

@@ -1,35 +1,34 @@
 name: Test
 
 on:
-  push:
-    branches:
-      - main
-  pull_request:
-    branches:
-      - main
-  schedule:
-    - cron: "0 0 * * *"
+    push:
+        branches:
+            - main
+    pull_request:
+        branches:
+            - main
+    schedule:
+        - cron: "0 0 * * *"
 
 jobs:
-  source:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.8", "3.9", "3.10"]
-    steps:
-      - uses: actions/checkout@v3
-      - uses: nanasess/setup-chromedriver@master
-      - uses: actions/setup-node@v3
-        with:
-          node-version: "14"
-      - name: Use Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
-        with:
-          python-version: ${{ matrix.python-version }}
-      - name: Install Python Dependencies
-        run: pip install -r requirements/test-run.txt
-      - name: Run Tests
-        run: |
-          npm install -g npm@latest
-          npm --version
-          nox -s test
+    source:
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                python-version: ["3.9", "3.10", "3.11"]
+        steps:
+            - uses: actions/checkout@v3
+            - uses: actions/setup-node@v3
+              with:
+                  node-version: "14.x"
+            - name: Use Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v4
+              with:
+                  python-version: ${{ matrix.python-version }}
+            - name: Install Python Dependencies
+              run: pip install -r requirements/test-run.txt
+            - name: Run Tests
+              run: |
+                  npm install -g npm@latest
+                  npm --version
+                  nox -s test

CHANGELOG.md

@@ -34,8 +34,16 @@ Using the following categories, list your changes in this order:
 
 ## [Unreleased]
 
+### Added
+
+-   Added system checks for a variety of common ReactPy misconfigurations.
+-   `REACTPY_BACKHAUL_THREAD` setting to enable/disable threading behavior.
+
 ### Changed
 
+-   If using `settings.py:REACTPY_DATABASE`, `reactpy_django.database.Router` must now be registered in `settings.py:DATABASE_ROUTERS`.
+-   By default, ReactPy will now use a backhaul thread to increase performance.
+-   Minimum Python version required is now `3.9`
 -   A thread-safe cache is no longer required.
 
 ## [3.2.1] - 2023-06-29

docs/python/configure-urls.py

@@ -2,6 +2,6 @@
 
 
 urlpatterns = [
-    path("reactpy/", include("reactpy_django.http.urls")),
     ...,
+    path("reactpy/", include("reactpy_django.http.urls")),
 ]

docs/python/settings.py

@@ -1,22 +1,32 @@
+# Cache used to store ReactPy web modules.
 # ReactPy benefits from a fast, well indexed cache.
+# We recommend redis or python-diskcache.
 REACTPY_CACHE = "default"
 
+# Database ReactPy uses to store session data.
 # ReactPy requires a multiprocessing-safe and thread-safe database.
+# DATABASE_ROUTERS is mandatory if REACTPY_DATABASE is configured.
 REACTPY_DATABASE = "default"
+DATABASE_ROUTERS = ["reactpy_django.database.Router", ...]
 
 # Maximum seconds between reconnection attempts before giving up.
 # Use `0` to prevent component reconnection.
 REACTPY_RECONNECT_MAX = 259200
 
-# The URL for ReactPy to serve the component rendering websocket
+# The URL for ReactPy to serve the component rendering websocket.
 REACTPY_WEBSOCKET_URL = "reactpy/"
 
-# Dotted path to the default `reactpy_django.hooks.use_query` postprocessor function, or `None`
+# Dotted path to the default `reactpy_django.hooks.use_query` postprocessor function,
+# or `None`.
 REACTPY_DEFAULT_QUERY_POSTPROCESSOR = "reactpy_django.utils.django_query_postprocessor"
 
-# Dotted path to the Django authentication backend to use for ReactPy components
+# Dotted path to the Django authentication backend to use for ReactPy components.
 # This is only needed if:
 #   1. You are using `AuthMiddlewareStack` and...
 #   2. You are using Django's `AUTHENTICATION_BACKENDS` setting and...
 #   3. Your Django user model does not define a `backend` attribute
-REACTPY_AUTH_BACKEND = None
+REACTPY_AUTH_BACKEND = "django.contrib.auth.backends.ModelBackend"
+
+# Whether to enable rendering ReactPy via a dedicated backhaul thread
+# This allows the webserver to process traffic while during ReactPy rendering
+REACTPY_BACKHAUL_THREAD = True

docs/src/contribute/code.md

@@ -12,7 +12,7 @@
 
 If you plan to make code changes to this repository, you will need to install the following dependencies first:
 
--   [Python 3.8+](https://www.python.org/downloads/)
+-   [Python 3.9+](https://www.python.org/downloads/)
 -   [Git](https://git-scm.com/downloads)
 -   [NPM](https://docs.npmjs.com/try-the-latest-stable-version-of-npm) for installing and managing Javascript
 

docs/src/contribute/docs.md

@@ -8,7 +8,7 @@
 
 If you plan to make changes to this documentation, you will need to install the following dependencies first:
 
--   [Python 3.8+](https://www.python.org/downloads/)
+-   [Python 3.9+](https://www.python.org/downloads/)
 -   [Git](https://git-scm.com/downloads)
 
 Once done, you should clone this repository:

docs/src/contribute/running-tests.md

@@ -10,7 +10,7 @@ This repository uses [Nox](https://nox.thea.codes/en/stable/) to run tests. For
 
 If you plan to run tests, you will need to install the following dependencies first:
 
--   [Python 3.8+](https://www.python.org/downloads/)
+-   [Python 3.9+](https://www.python.org/downloads/)
 -   [Git](https://git-scm.com/downloads)
 
 Once done, you should clone this repository:

docs/src/dictionary.txt

@@ -35,3 +35,6 @@ backends
 backend
 frontend
 frontends
+misconfiguration
+misconfigurations
+backhaul

docs/src/get-started/installation.md

@@ -76,7 +76,7 @@ Register ReactPy's Websocket using `REACTPY_WEBSOCKET_PATH`.
 
     1. Access the `User` that is currently logged in
     2. Login or logout the current `User`
-    3. Access Django's `Sesssion` object
+    3. Access Django's `Session` object
 
     In these situations will need to ensure you are using `AuthMiddlewareStack` and/or `SessionMiddlewareStack`.