v3.8.0 (#224)

.github/workflows/codeql.yml

@@ -12,67 +12,66 @@
 name: "CodeQL"
 
 on:
- push:
- branches: [ "main" ]
- pull_request:
- # The branches below must be a subset of the branches above
- branches: [ "main" ]
- schedule:
- # Runs at 22:21 on Monday.
- - cron: '21 22 * * 1'
+  push:
+  branches: ["main"]
+  pull_request:
+  # The branches below must be a subset of the branches above
+  branches: ["main"]
+  schedule:
+  # Runs at 22:21 on Monday.
+  - cron: "21 22 * * 1"
 
 jobs:
- analyze:
- name: Analyze
- runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
- timeout-minutes: ${{ (matrix.language == 'swift' && 120) || 360 }}
- permissions:
- actions: read
- contents: read
- security-events: write
+  analyze:
+  name: Analyze
+  runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+  timeout-minutes: ${{ (matrix.language == 'swift' && 120) || 360 }}
+  permissions:
+  actions: read
+  contents: read
+  security-events: write
 
- strategy:
- fail-fast: false
- matrix:
- language: [ 'javascript', 'python' ]
- # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby', 'swift' ]
- # Use only 'java' to analyze code written in Java, Kotlin or both
- # Use only 'javascript' to analyze code written in JavaScript, TypeScript or both
- # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
+  strategy:
+  fail-fast: false
+  matrix:
+  language: ["javascript", "python"]
+  # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby', 'swift' ]
+  # Use only 'java' to analyze code written in Java, Kotlin or both
+  # Use only 'javascript' to analyze code written in JavaScript, TypeScript or both
+  # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
 
- steps:
- - name: Checkout repository
- uses: actions/checkout@v3
+  steps:
+  - name: Checkout repository
+  uses: actions/checkout@v4
 
- # Initializes the CodeQL tools for scanning.
- - name: Initialize CodeQL
- uses: github/codeql-action/init@v2
- with:
- languages: ${{ matrix.language }}
- # If you wish to specify custom queries, you can do so here or in a config file.
- # By default, queries listed here will override any specified in a config file.
- # Prefix the list here with "+" to use these queries and those in the config file.
+  # Initializes the CodeQL tools for scanning.
+  - name: Initialize CodeQL
+  uses: github/codeql-action/init@v2
+  with:
+  languages: ${{ matrix.language }}
+  # If you wish to specify custom queries, you can do so here or in a config file.
+  # By default, queries listed here will override any specified in a config file.
+  # Prefix the list here with "+" to use these queries and those in the config file.
 
- # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
- # queries: security-extended,security-and-quality
+  # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+  # queries: security-extended,security-and-quality
 
+ # Autobuild attempts to build any compiled languages (C/C++, C#, Go, Java, or Swift).
+ # If this step fails, then you should remove it and run the build manually (see below)
+ - name: Autobuild
+ uses: github/codeql-action/autobuild@v2
 
- # Autobuild attempts to build any compiled languages (C/C++, C#, Go, Java, or Swift).
- # If this step fails, then you should remove it and run the build manually (see below)
- - name: Autobuild
- uses: github/codeql-action/autobuild@v2
+ # ℹ️ Command-line programs to run using the OS shell.
+ # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
 
- # ℹ️ Command-line programs to run using the OS shell.
- # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+  # If the Autobuild fails above, remove it and uncomment the following three lines.
+  # modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
 
- # If the Autobuild fails above, remove it and uncomment the following three lines.
- # modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
+ # - run: |
+ # echo "Run, Build Application using script"
+ # ./location_of_script_within_repo/buildscript.sh
 
- # - run: |
- # echo "Run, Build Application using script"
- # ./location_of_script_within_repo/buildscript.sh
-
- - name: Perform CodeQL Analysis
- uses: github/codeql-action/analyze@v2
- with:
- category: "/language:${{matrix.language}}"
+ - name: Perform CodeQL Analysis
+ uses: github/codeql-action/analyze@v2
+ with:
+ category: "/language:${{matrix.language}}"

.github/workflows/publish-develop-docs.yml

@@ -8,10 +8,10 @@ jobs:
  deploy:
  runs-on: ubuntu-latest
  steps:
- - uses: actions/checkout@v3
+ - uses: actions/checkout@v4
  with:
  fetch-depth: 0
- - uses: actions/setup-python@v4
+ - uses: actions/setup-python@v5
  with:
  python-version: 3.x
  - run: pip install -r requirements/build-docs.txt

.github/workflows/publish-py.yml

@@ -11,9 +11,9 @@ jobs:
  release-package:
  runs-on: ubuntu-latest
  steps:
- - uses: actions/checkout@v3
+ - uses: actions/checkout@v4
  - name: Set up Python
- uses: actions/setup-python@v4
+ uses: actions/setup-python@v5
  with:
  python-version: "3.x"
  - name: Install dependencies

.github/workflows/publish-release-docs.yml

@@ -8,10 +8,10 @@ jobs:
  deploy:
  runs-on: ubuntu-latest
  steps:
- - uses: actions/checkout@v3
+ - uses: actions/checkout@v4
  with:
  fetch-depth: 0
- - uses: actions/setup-python@v4
+ - uses: actions/setup-python@v5
  with:
  python-version: 3.x
  - run: pip install -r requirements/build-docs.txt

.github/workflows/test-docs.yml

@@ -14,10 +14,10 @@ jobs:
  docs:
  runs-on: ubuntu-latest
  steps:
- - uses: actions/checkout@v3
+ - uses: actions/checkout@v4
  with:
  fetch-depth: 0
- - uses: actions/setup-python@v4
+ - uses: actions/setup-python@v5
  with:
  python-version: 3.x
  - name: Check docs build

.github/workflows/test-src.yml

@@ -17,9 +17,9 @@ jobs:
  matrix:
  python-version: ["3.9", "3.10", "3.11"]
  steps:
- - uses: actions/checkout@v3
+ - uses: actions/checkout@v4
  - name: Use Python ${{ matrix.python-version }}
- uses: actions/setup-python@v4
+ uses: actions/setup-python@v5
  with:
  python-version: ${{ matrix.python-version }}
  - name: Install Python Dependencies

CHANGELOG.md

@@ -34,14 +34,18 @@ Using the following categories, list your changes in this order:
 
 ## [Unreleased]
 
+- Nothing (yet)!
+
+## [3.8.0] - 2024-02-20
+
 ### Added
 
 - Built-in cross-process communication mechanism via the `reactpy_django.hooks.use_channel_layer` hook.
 - Access to the root component's `id` via the `reactpy_django.hooks.use_root_id` hook.
 - More robust control over ReactPy clean up tasks!
  - `settings.py:REACTPY_CLEAN_INTERVAL` to control how often ReactPy automatically performs cleaning tasks.
- - `settings.py:REACTPY_CLEAN_SESSIONS` to control whether ReactPy automatically cleans up expired sessions.
- - `settings.py:REACTPY_CLEAN_USER_DATA` to control whether ReactPy automatically cleans up orphaned user data.
+ - `settings.py:REACTPY_CLEAN_SESSIONS` to control whether ReactPy should clean up expired sessions during automatic cleanups.
+ - `settings.py:REACTPY_CLEAN_USER_DATA` to control whether ReactPy should clean up orphaned user data during automatic cleanups.
  - `python manage.py clean_reactpy` command to manually perform ReactPy clean up tasks.
 
 ### Changed
@@ -461,7 +465,8 @@ Using the following categories, list your changes in this order:
 
 - Support for IDOM within the Django
 
-[Unreleased]: https://github.com/reactive-python/reactpy-django/compare/3.7.0...HEAD
+[Unreleased]: https://github.com/reactive-python/reactpy-django/compare/3.8.0...HEAD
+[3.8.0]: https://github.com/reactive-python/reactpy-django/compare/3.7.0...3.8.0
 [3.7.0]: https://github.com/reactive-python/reactpy-django/compare/3.6.0...3.7.0
 [3.6.0]: https://github.com/reactive-python/reactpy-django/compare/3.5.1...3.6.0
 [3.5.1]: https://github.com/reactive-python/reactpy-django/compare/3.5.0...3.5.1

README.md

@@ -27,6 +27,7 @@
 - [Customizable reconnection behavior](https://reactive-python.github.io/reactpy-django/latest/reference/settings/#stability-settings)
 - [Customizable disconnection behavior](https://reactive-python.github.io/reactpy-django/latest/reference/template-tag)
 - [Multiple root components](https://reactive-python.github.io/reactpy-django/latest/reference/template-tag/)
+- [Cross-process communication/signaling (Channel Layers)](https://reactive-python.github.io/reactpy-django/latest/reference/hooks/#use-channel-layer)
 - [Django view to ReactPy component conversion](https://reactive-python.github.io/reactpy-django/latest/reference/components/#view-to-component)
 - [Django static file access](https://reactive-python.github.io/reactpy-django/latest/reference/components/#django-css)
 - [Django database access](https://reactive-python.github.io/reactpy-django/latest/reference/hooks/#use-query)

docs/src/reference/hooks.md

@@ -369,7 +369,7 @@ This is often used to create chat systems, synchronize data between components,
   pip install channels-redis
   ```
 
- 3. Configure your `settings.py` to use `RedisChannelLayer` as your layer backend.
+ 3. Configure your `settings.py` to use `#!python RedisChannelLayer` as your layer backend.
 
   ```python linenums="0"
   CHANNEL_LAYERS = {

docs/src/reference/settings.md

@@ -232,7 +232,7 @@ Use `#!python 0` to not store any session data.
 
 Minimum seconds between ReactPy automatic clean up operations.
 
-The server will check if the interval has passed after every component disconnection, and will perform a clean if needed.
+After a component disconnection, the server will perform a clean up if this amount of time has passed since the last clean up.
 
 Set this value to `#!python None` to disable automatic clean up operations.
 

docs/src/reference/template-tag.md

@@ -12,6 +12,8 @@ Django template tags can be used within your HTML templates to provide ReactPy f
 
 This template tag can be used to insert any number of ReactPy components onto your page.
 
+Each component loaded via this template tag will receive a dedicated WebSocket connection to the server.
+
 === "my-template.html"
 
  {% include-markdown "../../../README.md" start="<!--html-code-start-->" end="<!--html-code-end-->" %}
@@ -27,7 +29,7 @@ This template tag can be used to insert any number of ReactPy components onto yo
  | `#!python class` | `#!python str | None` | The HTML class to apply to the top-level component div. | `#!python None` |
  | `#!python key` | `#!python Any` | Force the component's root node to use a [specific key value](https://reactpy.dev/docs/guides/creating-interfaces/rendering-data/index.html#organizing-items-with-keys). Using `#!python key` within a template tag is effectively useless. | `#!python None` |
  | `#!python host` | `#!python str | None` | The host to use for the ReactPy connections. If unset, the host will be automatically configured.<br/>Example values include: `localhost:8000`, `example.com`, `example.com/subdir` | `#!python None` |
- | `#!python prerender` | `#!python str` | If `#!python "true"`, the component will pre-rendered, which enables SEO compatibility and reduces perceived latency. | `#!python "false"` |
+ | `#!python prerender` | `#!python str` | If `#!python "true"` the component will pre-rendered, which enables SEO compatibility and reduces perceived latency. | `#!python "false"` |
  | `#!python offline` | `#!python str` | The dotted path to a component that will be displayed if your root component loses connection to the server. Keep in mind, this `offline` component will be non-interactive (hooks won't operate). | `#!python ""` |
  | `#!python **kwargs` | `#!python Any` | The keyword arguments to provide to the component. | N/A |
 

src/reactpy_django/__init__.py

@@ -8,7 +8,7 @@
  REACTPY_WEBSOCKET_ROUTE,
 )
 
-__version__ = "3.7.0"
+__version__ = "3.8.0"
 __all__ = [
  "REACTPY_WEBSOCKET_PATH",
  "REACTPY_WEBSOCKET_ROUTE",