https://github.com/matthewyoungjr/queuecraft
Modular job queue and worker system built with Go
https://github.com/matthewyoungjr/queuecraft
golang goose pgx pgx-v5 postgresql resend-email stdlib
Last synced: about 2 months ago
JSON representation
Modular job queue and worker system built with Go
- Host: GitHub
- URL: https://github.com/matthewyoungjr/queuecraft
- Owner: matthewyoungjr
- License: mit
- Created: 2025-07-17T05:03:10.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-29T14:53:38.000Z (11 months ago)
- Last Synced: 2025-10-05T13:05:49.320Z (8 months ago)
- Topics: golang, goose, pgx, pgx-v5, postgresql, resend-email, stdlib
- Language: Go
- Homepage:
- Size: 15.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# QueueCraft
QueueCraft is a lightweight, modular job queue and worker system built in Go. It helps you run background jobs (like sending emails or processing data) using a pool of workers — perfect for building reliable async workflows in your Go applications.
---
## 🚀 Features
- ⚡️ Fast and efficient worker pool (goroutines + channels)
- 🧱 PostgreSQL-backed persistent job storage (using Neon DB)
- 🧩 Uses pgx as the database driver
- 🔁 Built-in support for retries, job delays, and scheduling
- 🛠️ Custom job handler support (`send_email`, `generate_report`, etc.)
- 📜 Database migrations managed with Goose
- 🧪 Testable design with clean abstractions
- 🧹 Graceful shutdown and in-progress job recovery
---
## 📦 Tech Stack
- [Go](https://golang.org/)
- [pgx](https://github.com/jackc/pgx) as the PostgreSQL driver
- [Neon (PostgreSQL)](https://neon.tech/)
- [Goose](https://github.com/pressly/goose) for migrations
- [SQLC](https://sqlc.dev/) for type-safe SQL
- Go standard library
---
## 🛠️ Getting Started
### Prerequisites
- Go 1.20+
- A Neon PostgreSQL instance
- [Goose CLI](https://github.com/pressly/goose#installing) installed
- SQLC if you're using generated code