Initial commit

Multiple scheduler instances executed the same scheduled task multiple times
instead of once. Tests confirmed task executed 20+ times with just 2 instances.

Missing `heartbeat = NOW()` in build_fetch_schedule_query() UPDATE clause.
This broke multi-instance safety - other instances saw old heartbeat, thought
the task was stale (crashed instance), and re-picked it.

Add `heartbeat = NOW()` to UPDATE SET clause, matching the pattern already
correctly implemented in build_dequeue_query().

- fix: Add heartbeat = NOW() to scheduler query (qb.py:720)
- test: Add 12 critical tests
  - test_issue_536_minimal.py (3 tests - no DB needed)
  - test_issue_536_critical.py (8 tests - comprehensive)
  - test_scheduler.py (3 integration tests added)

All tests pass: 12/12 ✅

Fixes #536

fix(#536): Fix croniter time mocking and consolidate redundant tests

Changes:
1. Fix croniter to use mocked time in schedulers
   - croniter(expr) was using real system time while helpers.utc_now() was mocked
   - This caused negative next_in() values, making tasks always appear due
   - Solution: Pass start_time=helpers.utc_now() to croniter
   - File: pgqueuer/core/executors.py:285

2. Tighten test_multi_instance_single_task_execution assertion
   - Changed from <= 3 to <= 2 executions (more precise)
   - Added detailed diagnostic messages
   - File: test/test_scheduler.py:360-374

3. Consolidate redundant Issue #536 tests
   - Deleted test_issue_536_critical.py (326 lines)
     - Had duplicate tests of heartbeat_in_query and consistency checks
     - Had 4 documentation-only tests that didn't verify functionality
   - Removed test_query_structure_has_heartbeat_update from test_scheduler.py
     - Duplicate of test_issue_536_minimal.py::test_issue_536_heartbeat_in_query
   - Result: 14 tests → 5 tests, 839 lines → 481 lines

Final test suite:
  ✓ test_issue_536_minimal.py (3 SQL validation tests, no DB needed)

Author: janbjorge

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint & type-check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: ruff check
+        run: uv run ruff check .
+
+      - name: mypy
+        run: uv run mypy .
+
+  test:
+    name: Test (Python 3.12)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra s3 --extra gcs --extra dev
+
+      - name: pytest
+        run: uv run pytest tests/ -v

.github/workflows/release.yml

@@ -0,0 +1,73 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  lint:
+    name: Lint & type-check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: ruff check
+        run: uv run ruff check .
+
+      - name: mypy
+        run: uv run mypy .
+
+  test:
+    name: Test (Python 3.12)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra s3 --extra gcs --extra dev
+
+      - name: pytest
+        run: uv run pytest tests/ -v
+
+  publish:
+    name: Build & publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    environment: pypi
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# uv
+.uv/
+
+# pytest
+.pytest_cache/
+.coverage
+htmlcov/
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# macOS
+.DS_Store
+
+# Editors
+.idea/
+.vscode/
+*.swp
+*.swo