Maintenance/v0.3.5

.github/workflows/ci.yml

@@ -12,18 +12,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python 3.12
+      - name: Set up Python 3.13
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.13"
 
       - name: Install required packages
         run: pip install pre-commit
 
       - name: Run pre-commit hooks
         run: pre-commit run --all-files
 
-
   tests:
     name: Python ${{ matrix.python-version }}, django ${{ matrix.django-version }}
     runs-on: ubuntu-24.04
@@ -46,8 +45,10 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
       - name: Install tox
-        run: pip install tox
+        run: uv pip install --system tox tox-uv
       - name: Run Tests
         env:
           TOXENV: django${{ matrix.django-version }}
@@ -56,7 +57,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: coverage-data-${{ matrix.python-version }}-${{ matrix.django-version }}
-          path: '${{ github.workspace }}/.coverage.*'
+          path: '${{ github.workspace }}/.coverage'
           include-hidden-files: true
           if-no-files-found: error
 
@@ -69,21 +70,22 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: '3.12'
+          python-version: '3.13'
 
       - name: Install dependencies
         run: python -m pip install --upgrade coverage[toml]
 
       - name: Download data
         uses: actions/download-artifact@v4
         with:
-          path: ${{ github.workspace }}
+          path: ${{ github.workspace }}/coverage-reports
           pattern: coverage-data-*
-          merge-multiple: true
+          merge-multiple: false
 
       - name: Combine coverage and fail if it's <100.0%
         run: |
-          python -m coverage combine
+          python -m coverage combine coverage-reports/*/.coverage
+          python -m coverage xml
           python -m coverage html --skip-covered --skip-empty
           python -m coverage report --fail-under=100.0
           echo "## Coverage summary" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -140,7 +140,7 @@ cython_debug/
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 .idea/
 
-# Requirements.txt is managed by pip-tools
+# Deprecated dependency files
 requirements.txt
 
 # sphinx build folder
@@ -156,3 +156,6 @@ _build
 
 # Test databases
 *.sqlite
+
+# AI
+.claude/

.pre-commit-config.yaml

@@ -3,7 +3,7 @@
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.11
+    rev: v0.14.0
     hooks:
       # Run the Ruff formatter.
       - id: ruff-format
@@ -12,11 +12,11 @@ repos:
         args: [--fix, --exit-non-zero-on-fix]
 
   - repo: https://github.com/adamchainz/blacken-docs
-    rev: 1.19.1
+    rev: 1.20.0
     hooks:
       - id: blacken-docs
         additional_dependencies:
-        - black==25.1.0
+        - black==25.9.0
         files: '(?:README\.md|\.ambient-package-update\/templates\/snippets\/.*\.tpl|docs\/.*\.(?:md|rst))'
 
   - repo: https://github.com/asottile/pyupgrade
@@ -26,13 +26,13 @@ repos:
         args: [ --py310-plus ]
 
   - repo: https://github.com/adamchainz/django-upgrade
-    rev: 1.25.0
+    rev: 1.29.0
     hooks:
       - id: django-upgrade
         args: [--target-version, "4.2"]
 
   - repo: https://github.com/adamchainz/djade-pre-commit
-    rev: 1.4.0
+    rev: 1.6.0
     hooks:
     -   id: djade
         args: [--target-version, "4.2"]
@@ -43,7 +43,7 @@ repos:
           )$
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: check-ast
       - id: check-builtin-literals

.readthedocs.yaml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-24.04
   tools:
-    python: "3.12"
+    python: "3.13"
 
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:

CONTRIBUTING.md

@@ -3,9 +3,8 @@
 ## Setup package for development
 
 - Create a Python virtualenv and activate it
-- Install "pip-tools" with `pip install -U pip-tools`
-- Compile the requirements with `pip-compile --extra dev, -o requirements.txt pyproject.toml --resolver=backtracking`
-- Sync the dependencies with your virtualenv with `pip-sync`
+- Install "uv" with `pip install -U uv`
+- Sync the requirements with `uv sync --frozen --group dev`
 
 ## Add functionality
 
@@ -58,20 +57,19 @@ Example: run all hooks of pre-push stage
 - To build the documentation, run: `sphinx-build docs/ docs/_build/html/`.
 - Open `docs/_build/html/index.html` to see the documentation.
 
-
 ### Translation files
 
 If you have added custom text, make sure to wrap it in `_()` where `_` is
 gettext_lazy (`from django.utils.translation import gettext_lazy as _`).
 
 How to create translation file:
 
-* Navigate to `django-queuebie`
+* Navigate to `queuebie`
 * `python manage.py makemessages -l de`
 * Have a look at the new/changed files within `queuebie/locale`
 
 How to compile translation files:
 
-* Navigate to `django-queuebie`
+* Navigate to `queuebie`
 * `python manage.py compilemessages`
 * Have a look at the new/changed files within `queuebie/locale`

README.md

@@ -7,11 +7,9 @@
 
 A simple and synchronous message queue for commands and events for Django.
 
-* [PyPI](https://pypi.org/project/django-queuebie/)
-* [GitHub](https://github.com/ambient-innovation/django-queuebie)
-* [Full documentation](https://django-queuebie.readthedocs.io/en/latest/index.html)
-* Creator & Maintainer: [Ambient Digital](https://ambient.digital/)
+[PyPI](https://pypi.org/project/django-queuebie/) | [GitHub](https://github.com/ambient-innovation/django-queuebie) | [Full documentation](https://django-queuebie.readthedocs.io/en/latest/index.html)
 
+Creator & Maintainer: [Ambient Digital](https://ambient.digital/)
 
 ## Features
 
@@ -73,48 +71,62 @@ handle_message(
 
   `pip install django_queuebie`
 
-  or via pipenv:
+  or via uv:
 
-  `pipenv install django_queuebie`
+  `uv add django_queuebie`
 
 - Add module to `INSTALLED_APPS` within the main django `settings.py`:
 
-    ```python
-    INSTALLED_APPS = (
-        # ...
-        "queuebie",
-    )
-    ```
-
-
+```python
+INSTALLED_APPS = (
+    # ...
+    "queuebie",
+)
+```
 
 ### Publish to ReadTheDocs.io
 
 - Fetch the latest changes in GitHub mirror and push them
 - Trigger new build at ReadTheDocs.io (follow instructions in admin panel at RTD) if the GitHub webhook is not yet set
   up.
 
-### Publish to PyPi
+### Preparation and building
+
+This package uses [uv](https://github.com/astral-sh/uv) for dependency management and building.
 
 - Update documentation about new/changed functionality
 
-- Update the `Changelog`
+- Update the `CHANGES.md`
 
 - Increment version in main `__init__.py`
 
-- Create pull request / merge to main
+- Create pull request / merge to "main"
 
-- This project uses the flit package to publish to PyPI. Thus, publishing should be as easy as running:
-  ```
-  flit publish
+- This project uses uv to publish to PyPI. This will create distribution files in the `dist/` directory.
+
+  ```bash
+  uv build
   ```
 
-  To publish to TestPyPI use the following to ensure that you have set up your .pypirc as
-  shown [here](https://flit.readthedocs.io/en/latest/upload.html#using-pypirc) and use the following command:
+### Publishing to PyPI
 
-  ```
-  flit publish --repository testpypi
-  ```
+To publish to the production PyPI:
+
+```bash
+uv publish
+```
+
+To publish to TestPyPI first (recommended for testing):
+
+```bash
+uv publish --publish-url https://test.pypi.org/legacy/
+```
+
+You can then test the installation from TestPyPI:
+
+```bash
+uv pip install --index-url https://test.pypi.org/simple/ ambient-package-update
+```
 
 ### Maintenance
 

docs/conf.py

@@ -62,7 +62,6 @@
 # This pattern also affects html_static_path and html_extra_path.
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 
-
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for

manage.py

@@ -9,7 +9,7 @@ def main():
     """Run administrative tasks."""
     os.environ.setdefault("DJANGO_SETTINGS_MODULE", "settings")
     try:
-        from django.core.management import execute_from_command_line
+        from django.core.management import execute_from_command_line  # noqa: PLC0415
     except ImportError as exc:
         raise ImportError(  # noqa: TRY003
             "Couldn't import Django. Are you sure it's installed and "