Changelog¶

potatoq uses calendar versioning: YY.N is the Nth release of the year (26.1, 26.2, … 27.1). Alphas are pre-releases of the upcoming number (26.1a1, 26.1a2, then 26.1). Each section lists the merged pull requests by category, plus everyone who contributed to that release.

Notes under Unreleased are written by hand and become the "Highlights" of the next release. Everything else is generated from pull request titles by scripts/release.py when a release is prepared (see RELEASING.md).

Unreleased¶

26.1a4 - 2026-10-13¶

Changes¶

• Dramatiq guide: max_retries defaults to 10 now
• Supervisor: don't spin a core when the schedule is off or while shutting down

Full Changelog: https://github.com/anze3db/potatoq/compare/26.1a3...26.1a4

Contributors¶

Thank you to everyone who contributed to this release: @anze3db

26.1a3 - 2026-10-13¶

Changes¶

• release --push waits for CI and the Release workflow, then reports the outcome
• SQLite broker: refuse SQLite older than 3.35 with a clear error
• Document the minimum PostgreSQL, Redis/Valkey, RabbitMQ and SQLite versions; test them in CI
• Tests: restore the shared worker app's configuration after each test
• drain() skips ahead to countdowns and retries on Postgres and Redis too
• Keep the banner's labels when a project has its own logging setup
• Docs: retries are opt-in, said plainly; a Migrating section with a Dramatiq guide
• Docs: the same Requirements notice on every broker page
• Docs home: the install command is a code block, not a pill
• Docs home: crashes are requeued, exceptions are retried only on request
• Defaults tables: what happens on an exception sits right below what happens on a crash
• task_autoretry_for: retry every task on these exceptions, in one setting
• Docs: retrying every task, how many times, backoff and jitter
• Retry up to 10 times by default, about 50 minutes, instead of 3
• Defaults tables: a task that raises is dead-lettered, said in the same row
• Django tasks: refresh() of a task that's just finishing no longer raises

Full Changelog: https://github.com/anze3db/potatoq/compare/26.1a2...26.1a3

Contributors¶

Thank you to everyone who contributed to this release: @anze3db

26.1a2 - 2026-10-09¶

Highlights¶

• potatoq --version (also -V) prints the potatoq and Python versions.
• Tests can no longer queue tasks into the development database: with the Django database as broker, .delay() writes through Django's connection, so it follows the test database and a test without django_db fails with pytest-django's error.
• potatoq.testing.due() and tick() test periodic task schedules.
• potatoq/worker is a regular package (it had no __init__.py).
• SIGHUP reloads the worker in place, like gunicorn: running tasks finish, then the same process starts again with the new code (systemctl reload with ExecReload). Before, it killed the worker on the spot.
• Signal handling: the worker's signal handlers only record the signal and its main loop acts on it, so two SIGTERMs at once (systemd and uv run each send one) no longer log "Shutting down" and send worker_shutting_down twice. potatoq beat stops cleanly on SIGTERM, and a child process whose supervisor died exits without a BrokenPipeError traceback.
• A SIGTERM that reached a just-forked worker process before it had installed its own signal handlers was lost, so stopping the worker shortly after a crash or a process recycle waited out the whole 25 s shutdown timeout. Signals are now blocked across fork() until the child is ready.

Changes¶

• Release on the push to main that merging a release PR creates: a merged PR's run has ref refs/pull/N/merge, which the main-only pypi environment rejects
• potatoq --version
• Tests can't queue tasks into the development database; potatoq.testing.due/tick
• Docs home: benchmark table shows enqueue and process throughput for both potatoq and Celery
• SIGHUP reloads the worker in place
• Signal handlers only record the signal; the supervisor's main loop acts on it
• Block signals across fork() so a new child can't lose a SIGTERM; run tests in parallel
• CI: keep RabbitMQ scheduler-leader tests on one xdist worker; run CPU-timing tests alone
• Release from a local commit, published only after CI passes
• Threads: don't leave Python 3.11's async-exception flag raised after every task
• CI: measure coverage on every Python version and combine it
• SQLAlchemy: track every sessionmaker passed to install()
• Tests: wait for RabbitMQ scheduler leadership before checking periodic dedup
• Add a Justfile for tests, coverage, lint, docs, benchmarks and releases
• just release previews the next alpha; --no-dry-run commits it

Full Changelog: https://github.com/anze3db/potatoq/compare/26.1a1...26.1a2

Contributors¶

Thank you to everyone who contributed to this release: @anze3db

26.1a1 - 2026-10-09¶

Highlights¶

The first release of potatoq: a Celery-compatible task queue with production-ready defaults. This is an alpha release in limited production use: use it in production at your own risk, and expect APIs and defaults to change while potatoq matures.

• Celery-compatible API: Potatoq (also importable as Celery), @app.task, @shared_task, delay/apply_async, AsyncResult, chain/group/chord, signals, beat_schedule and crontab, plus CELERY_* settings.
• Four native brokers: PostgreSQL (SKIP LOCKED, LISTEN/NOTIFY, transactional enqueue), Redis/Valkey (Lua scripts, leases), RabbitMQ (quorum queues, publisher confirms, TTL delay cascade) and SQLite (WAL, data_version wake-ups), plus memory:// for tests.
• Safe defaults: ack after completion, requeue on worker crash with a poison-message limit, one task per idle process, broker-side ETAs, 30-minute time limits, exponential retry backoff, a dead-letter store, process recycling and a 25-second graceful shutdown.
• Prefork workers with optional --threads, enforcing time limits even with threads, and support for free-threaded Python.
• Scheduler in every worker, deduplicated through the broker: no separate beat.
• Integrations: Django (zero config, the database as broker, enqueue on commit, django.tasks backend), Flask, FastAPI and SQLAlchemy.
• async def tasks, potatoq.testing.drain(), and a potatoq CLI with status, queues, dead and inspect.
• Python 3.11–3.15, including free-threaded builds, on Linux and macOS (Windows isn't supported).
• Fully typed (mypy clean, ships py.typed), 100% test coverage, MIT licensed.

Full Changelog: https://github.com/anze3db/potatoq/commits/26.1a1

Contributors¶

Thank you to everyone who contributed to this release: @anze3db