Horsies
PostgreSQL-backed background task queue and workflow engine for Python.
Full Documentation | PyPI | GitHub
Why Postgres
Every guarantee horsies makes is a Postgres primitive, not a client-side convention:
- Claiming: one server-side function under
FOR UPDATE SKIP LOCKED; a claim-generation fence rejects stale attempts, including a worker re-claiming its own requeued task. - Finalization: row lock → immutable attempt-history append → state transition, one transaction.
- Recovery: all state is rows and timestamps; the reaper reconstructs and repairs after a worker dies mid-flight — nothing in-flight exists only in a broker's memory.
- Workflows: fan-in, completion, and subworkflow cascades are multi-row transitions under a documented lock order.
- Dispatch: LISTEN/NOTIFY push — no polling.
- Inspection: history is plain tables — SQL,
EXPLAIN, your existing backups; Syce reads the same rows.
Measured hot-path latencies: performance.
Monitoring
Horsies includes Syce, a terminal-based UI for monitoring your cluster in real-time.
Testing & Correctness
3,200+ test functions across unit, real-Postgres integration, e2e
worker-process, and PgBouncer contract suites — a 2.2:1 test-to-source line
ratio, weighted toward failure paths: crash recovery, claim fencing,
cancel/completion races, rolling upgrades, and EXPLAIN ANALYZE plan
assertions pinning the hot-path statements to their indexes. The
claim/finalize semantics are additionally cross-validated against an
independent Rust reimplementation of the engine.
Pre-1.0 is an API-contract statement, not an engine-maturity statement: breaking API changes may still land in minor releases and are documented in the changelog.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file horsies-0.5.0.tar.gz.
File metadata
- Download URL: horsies-0.5.0.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
29c575c202cda9839303b140dd195d79adb07fb8c36196ed8d250d9afe1e9cf3
|
|
| MD5 |
17b5a56d0dfb9361e944d1c0265d2bcb
|
|
| BLAKE2b-256 |
a48f7b78c17e66ef1fe484eaa79fe851f32534f495d02db3c153eb3b31fdac5f
|
Provenance
The following attestation bundles were made for horsies-0.5.0.tar.gz:
Publisher:
release.yml on suleymanozkeskin/horsies
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
horsies-0.5.0.tar.gz -
Subject digest:
29c575c202cda9839303b140dd195d79adb07fb8c36196ed8d250d9afe1e9cf3 - Sigstore transparency entry: 2407477970
- Sigstore integration time:
-
Permalink:
suleymanozkeskin/horsies@7b7c8c6397bac124651f90ceb6d5c5058d07e256 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/suleymanozkeskin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7b7c8c6397bac124651f90ceb6d5c5058d07e256 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file horsies-0.5.0-py3-none-any.whl.
File metadata
- Download URL: horsies-0.5.0-py3-none-any.whl
- Upload date:
- Size: 1.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4a42aa07bd5d2a0e1984f9ee1446f2438960fd83052b1e24ba4b8b22b42c5b10
|
|
| MD5 |
834b0917d67b81b182e78426519cc897
|
|
| BLAKE2b-256 |
c5f25d4356f1d6373fa245a8a40b6f14c5ab0f319f64c2646186e5ff87f35812
|
Provenance
The following attestation bundles were made for horsies-0.5.0-py3-none-any.whl:
Publisher:
release.yml on suleymanozkeskin/horsies
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
horsies-0.5.0-py3-none-any.whl -
Subject digest:
4a42aa07bd5d2a0e1984f9ee1446f2438960fd83052b1e24ba4b8b22b42c5b10 - Sigstore transparency entry: 2407477990
- Sigstore integration time:
-
Permalink:
suleymanozkeskin/horsies@7b7c8c6397bac124651f90ceb6d5c5058d07e256 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/suleymanozkeskin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7b7c8c6397bac124651f90ceb6d5c5058d07e256 -
Trigger Event:
workflow_dispatch
-
Statement type:
