Add maintainer release flow

.github/workflows/ci.yml

@@ -25,7 +25,9 @@ jobs:
       - name: Install Python dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install "Django==${{ matrix.django-version }}" -e .[dev]
+          # django-rspack is a sibling package and is not published yet.
+          python -m pip install "django-rspack @ git+https://github.com/shakacode/django-rspack.git@7b09b8baf8d23c822978fcb472672a811927f5e5"
+          python -m pip install "Django==${{ matrix.django-version }}" -e '.[dev]'
 
       - name: Ruff
         run: ruff check .
@@ -53,7 +55,9 @@ jobs:
       - name: Install Python dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install -e .[dev]
+          # django-rspack is a sibling package and is not published yet.
+          python -m pip install "django-rspack @ git+https://github.com/shakacode/django-rspack.git@7b09b8baf8d23c822978fcb472672a811927f5e5"
+          python -m pip install -e '.[dev]'
 
       - name: Install example dependencies
         working-directory: example

.github/workflows/release.yml

@@ -0,0 +1,196 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: Package index to publish to
+        required: true
+        default: testpypi
+        type: choice
+        options:
+          - testpypi
+          - pypi
+      version:
+        description: Optional version to validate against package metadata (for example 0.1.0a1)
+        required: false
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  unit:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.13"]
+        django-version: ["4.2.*", "5.1.*"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          # django-rspack is a sibling package and is not published yet.
+          python -m pip install "django-rspack @ git+https://github.com/shakacode/django-rspack.git@7b09b8baf8d23c822978fcb472672a811927f5e5"
+          python -m pip install "Django==${{ matrix.django-version }}" -e '.[dev]'
+
+      - name: Ruff
+        run: ruff check .
+
+      - name: Pytest
+        run: pytest
+
+  example-e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: example/package-lock.json
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          # django-rspack is a sibling package and is not published yet.
+          python -m pip install "django-rspack @ git+https://github.com/shakacode/django-rspack.git@7b09b8baf8d23c822978fcb472672a811927f5e5"
+          python -m pip install -e '.[dev]'
+
+      - name: Install example dependencies
+        working-directory: example
+        run: npm ci
+
+      - name: Install Playwright browser
+        working-directory: example
+        run: npx playwright install --with-deps chromium
+
+      - name: Make example scripts executable
+        run: chmod +x example/bin/dev example/bin/prod example/bin/test-ci
+
+      - name: Run example smoke and Playwright suite
+        working-directory: example
+        run: ./bin/test-ci
+
+  build:
+    needs:
+      - unit
+      - example-e2e
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - id: version
+        name: Read package version
+        shell: bash
+        run: |
+          python - <<'PY' > "$RUNNER_TEMP/package-version"
+          from pathlib import Path
+          import re
+
+          text = Path("src/react_on_django/__about__.py").read_text(encoding="utf-8")
+          match = re.search(r'^__version__ = "([^"]+)"$', text, re.M)
+          if not match:
+              raise SystemExit("Could not find __version__ in src/react_on_django/__about__.py")
+          print(match.group(1))
+          PY
+          version="$(cat "$RUNNER_TEMP/package-version")"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+      - name: Validate release version
+        shell: bash
+        env:
+          PACKAGE_VERSION: ${{ steps.version.outputs.version }}
+          INPUT_VERSION: ${{ inputs.version }}
+        run: |
+          if [[ -n "${INPUT_VERSION}" && "${INPUT_VERSION}" != "${PACKAGE_VERSION}" ]]; then
+            echo "Requested version ${INPUT_VERSION} does not match package version ${PACKAGE_VERSION}."
+            exit 1
+          fi
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distribution metadata
+        run: twine check dist/*
+
+      - name: Store distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-testpypi:
+    if: inputs.repository == 'testpypi'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/react-on-django
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    if: inputs.repository == 'pypi'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/react-on-django
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

CHANGELOG.md

@@ -1,2 +1,5 @@
 # Changelog
 
+All notable changes to this project should be documented in this file.
+
+## [Unreleased]

Makefile

@@ -0,0 +1,10 @@
+.PHONY: release release-dry-run
+
+PYTHON ?= python
+_truthy = $(filter 1 true yes y on TRUE YES Y ON,$(strip $(1)))
+
+release:
+	$(PYTHON) scripts/release.py $(if $(VERSION),--version $(VERSION),) $(if $(REPOSITORY),--repository $(REPOSITORY),) $(if $(call _truthy,$(YES)),--yes,) $(if $(call _truthy,$(SKIP_CHECKS)),--skip-checks,) $(if $(call _truthy,$(SKIP_PUSH)),--skip-push,)
+
+release-dry-run:
+	$(PYTHON) scripts/release.py --dry-run $(if $(VERSION),--version $(VERSION),) $(if $(REPOSITORY),--repository $(REPOSITORY),) $(if $(call _truthy,$(YES)),--yes,) $(if $(call _truthy,$(SKIP_CHECKS)),--skip-checks,)