localqueue 1.1.0__tar.gz → 1.1.2__tar.gz

localqueue-1.1.2/.github/workflows/ci.yml

@@ -0,0 +1,245 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  python-quality:
+    name: Python lint and types
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.14'
+          cache: pip
+
+      - name: Install Python quality tools
+        run: |
+          python -m pip install --upgrade \
+            "pydantic>=2,<3" \
+            "ruff>=0.15,<1" \
+            "pyrefly>=1.1,<2"
+
+      - name: Run Ruff
+        run: |
+          ruff check .
+          ruff format --check .
+
+      - name: Run Pyrefly
+        env:
+          PYTHONPATH: python
+        run: pyrefly check --preset default --progress-bar no python/localqueue
+
+  secrets:
+    name: Secret scan
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          fetch-depth: 0
+
+      - name: Run Gitleaks
+        uses: gitleaks/gitleaks-action@ff98106e4c7b2bc287b24eaf42907196329070c7 # v2
+        env:
+          # The CLI result is the quality gate. Keep SARIF uploads opt-in so
+          # a transient Actions artifact quota cannot hide scan results.
+          GITLEAKS_ENABLE_UPLOAD_ARTIFACT: "false"
+          GITLEAKS_ENABLE_COMMENTS: "false"
+
+  rust-quality:
+    name: Rust format and Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # master
+        with:
+          toolchain: stable
+          components: rustfmt, clippy
+
+      - name: Cache Cargo dependencies
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('Cargo.toml', 'Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Check formatting
+        run: cargo fmt --all --check
+
+      - name: Run Clippy
+        run: cargo clippy --locked --all-targets --all-features -- -D warnings
+
+  rust-dependencies:
+    name: Rust dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Run cargo-deny
+        uses: EmbarkStudios/cargo-deny-action@3c6349835b2b7b196a839186cb8b78e02f7b5f25 # v2
+        with:
+          command: check
+
+  msrv:
+    name: Rust MSRV 1.83
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Install Rust 1.83
+        uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # master
+        with:
+          toolchain: '1.83'
+
+      - name: Check with MSRV
+        run: cargo check --locked
+
+  python-tests:
+    name: Python tests (${{ matrix.os }}, Python ${{ matrix.python }})
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python: '3.10'
+          - os: ubuntu-latest
+            python: '3.14'
+          - os: macos-15
+            python: '3.14'
+          - os: windows-latest
+            python: '3.14'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+
+      - name: Cache Cargo dependencies and build outputs
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-py${{ matrix.python }}-${{ hashFiles('Cargo.toml', 'Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-py${{ matrix.python }}-
+            ${{ runner.os }}-cargo-
+
+      - name: Build extension in a virtual environment
+        shell: bash
+        run: |
+          python -m venv .venv
+          if [ "$RUNNER_OS" = "Windows" ]; then
+            source .venv/Scripts/activate
+          else
+            source .venv/bin/activate
+          fi
+          python -m pip install --upgrade \
+            "maturin>=1.14,<2" \
+            "pytest>=8,<10" \
+            "pytest-cov>=7,<8" \
+            "pydantic>=2,<3"
+          maturin develop --locked
+
+      - name: Run tests
+        if: matrix.os != 'ubuntu-latest' || matrix.python != '3.14'
+        shell: bash
+        run: |
+          if [ "$RUNNER_OS" = "Windows" ]; then
+            source .venv/Scripts/activate
+          else
+            source .venv/bin/activate
+          fi
+          pytest -ra
+
+      - name: Run tests with branch coverage
+        if: matrix.os == 'ubuntu-latest' && matrix.python == '3.14'
+        shell: bash
+        run: |
+          source .venv/bin/activate
+          pytest -ra \
+            --cov=localqueue \
+            --cov-branch \
+            --cov-report=term-missing \
+            --cov-report=xml \
+            --cov-fail-under=80
+
+      - name: Upload coverage to Codecov
+        if: matrix.os == 'ubuntu-latest' && matrix.python == '3.14'
+        uses: codecov/codecov-action@0fb7174895f61a3b6b78fc075e0cd60383518dac # v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          fail_ci_if_error: false
+
+  wheel-smoke:
+    name: Build and smoke-test wheel
+    needs: [python-quality, secrets, rust-quality, rust-dependencies, python-tests]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.13'
+
+      - name: Install maturin
+        run: python -m pip install --upgrade "maturin>=1.14,<2"
+
+      - name: Build wheel
+        run: maturin build --release --locked -i python
+
+      - name: Install wheel
+        shell: bash
+        run: python -m pip install --force-reinstall target/wheels/*.whl
+
+      - name: Import package outside the checkout
+        shell: bash
+        run: |
+          cd "$RUNNER_TEMP"
+          python - <<'PY'
+          import tempfile
+
+          from localqueue import SimpleQueue
+
+          with tempfile.TemporaryDirectory() as path:
+              queue = SimpleQueue(path)
+              queue.put({"source": "wheel-smoke"})
+              job = queue.get(block=False)
+              assert job.data == {"source": "wheel-smoke"}
+              queue.ack(job)
+              assert queue.stats()["acked"] == 1
+              queue.close()
+          PY

localqueue-1.1.2/.github/workflows/docs.yml

@@ -0,0 +1,68 @@
+name: Documentation
+
+on:
+  pull_request:
+    paths:
+      - "docs/**"
+      - "zensical.toml"
+      - ".github/workflows/docs.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "zensical.toml"
+      - ".github/workflows/docs.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docs-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.14'
+          cache: pip
+
+      - name: Install Zensical
+        run: python -m pip install --upgrade "zensical>=0.0.51,<0.1"
+
+      - name: Build site
+        run: zensical build --clean
+
+      - name: Upload Pages artifact
+        if: github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
+        with:
+          path: site
+
+  deploy:
+    name: Deploy documentation
+    if: github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5

localqueue-1.1.2/.github/workflows/release.yml

@@ -0,0 +1,104 @@
+name: Create release tag
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: Calculate the next version without writing, tagging, or pushing
+        required: true
+        default: true
+        type: boolean
+
+permissions:
+  contents: write
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Calculate and tag release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out main with full history
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: main
+          fetch-depth: 0
+
+      - name: Confirm main is current
+        run: |
+          git fetch origin main --tags
+          test "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)"
+
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.14'
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # master
+        with:
+          toolchain: stable
+
+      - name: Install release and test tooling
+        run: |
+          python -m pip install --upgrade \
+            "python-semantic-release>=10.6,<11" \
+            "maturin>=1.14,<2" \
+            "pytest>=8,<10" \
+            "pydantic>=2,<3"
+
+      - name: Validate release history
+        run: |
+          current_version=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+          last_released=$(semantic-release version --print-last-released)
+          test "$current_version" = "$last_released" || {
+            echo "pyproject.toml is $current_version but Semantic Release sees $last_released." >&2
+            echo "Reconcile the published release tag with main before automating the next release." >&2
+            exit 1
+          }
+
+      - name: Calculate next version
+        id: version
+        run: |
+          current_version=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+          version=$(semantic-release version --print)
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "tag=v$version" >> "$GITHUB_OUTPUT"
+          if [[ "$version" == "$current_version" ]]; then
+            echo "release_needed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "release_needed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Report dry run
+        if: inputs.dry_run
+        run: |
+          if [[ "${{ steps.version.outputs.release_needed }}" == true ]]; then
+            echo "Next release would be ${{ steps.version.outputs.tag }}"
+          else
+            echo "No release is needed. ${{ steps.version.outputs.tag }} is current."
+          fi
+
+      - name: Create local release commit and tag
+        if: inputs.dry_run == false && steps.version.outputs.release_needed == 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: semantic-release version --no-push --no-vcs-release
+
+      - name: Validate versioned tree
+        if: inputs.dry_run == false && steps.version.outputs.release_needed == 'true'
+        run: |
+          python scripts/check_release_version.py --tag "${{ steps.version.outputs.tag }}"
+          cargo fmt --all --check
+          cargo check --locked
+          maturin build --release --locked -i python
+          python -m pip install --force-reinstall target/wheels/*.whl
+          pytest -ra
+
+      - name: Push release commit and tag atomically
+        if: inputs.dry_run == false && steps.version.outputs.release_needed == 'true'
+        run: |
+          git push --atomic origin HEAD:main "${{ steps.version.outputs.tag }}"

{localqueue-1.1.0 → localqueue-1.1.2}/.github/workflows/stress.yml

@@ -24,10 +24,10 @@ jobs:
     timeout-minutes: 40
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
         with:
           python-version: '3.13'
 
@@ -50,7 +50,7 @@ jobs:
 
       - name: Upload stress report
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: stress-report-${{ github.run_id }}
           path: stress-report.json