Skip to content

Add the jobqueue exactly-once demo#4

Merged
dhruvl merged 9 commits into
mainfrom
jobqueue-demo
Jul 18, 2026
Merged

Add the jobqueue exactly-once demo#4
dhruvl merged 9 commits into
mainfrom
jobqueue-demo

Conversation

@dhruvl

@dhruvl dhruvl commented Jul 18, 2026

Copy link
Copy Markdown
Owner

A demo distributed system under examples/jobqueue/: an exactly-once job scheduler written in plain stdlib asyncio (one broker, stateless workers, submitting clients), tested end to end with simloop. Time-based leases with heartbeat renewal, per-job fencing tokens checked at broker and store, idempotency-key submit dedupe, exponential-backoff requeue, and a dead-letter state.

The suite runs entirely under seeded simulation: seven fault scenarios (25-50 seeds each), an ablation matrix that removes each safeguard and lets seed exploration find the resulting violation, two defense-in-depth 'stays safe alone' proofs, and a 300-seed chaos campaign of randomized partitions, a worker crash, and poison jobs. Every failure replays from a seed. The bug table lives in examples/jobqueue/README.md.

Product code is stdlib-only (a subprocess test enforces it); simloop rides in the tests only. mypy strict clean and the full suite green on 3.12 and 3.13; the wheel excludes the demo.

@dhruvl
dhruvl merged commit b8fcac3 into main Jul 18, 2026
4 checks passed
@dhruvl
dhruvl deleted the jobqueue-demo branch July 18, 2026 18:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant