Repository navigation
🚀 GopherQueue v0.1.0 Initial Release
We are thrilled to announce the initial open-source release of GopherQueue v0.1.0!
GopherQueue is a high-performance, distributed background job processing library and worker engine for Go. Designed for dual-mode operation (embedded Go packages or standalone microservice daemons), GopherQueue brings atomic Redis job guarantees, native rate-limiting integration with distlimit, an expressive middleware engine, and a zero-dependency embedded web dashboard.
✨ Key Features & Highlights
- 🔄 Dual-Mode Architecture: Run as an embedded Go package directly inside your monolith/microservice or deploy as a standalone worker/dashboard daemon (
cmd/gopherq-server,cmd/gopherq-dashboard). - 🛡️ Native
distlimitRate-Limiting Synergy: Integrated adapter withgithub.com/balramadan/distlimit. Rate-limited jobs are gracefully deferred to the delayed queue without consuming retry budgets. - ⚡ At-Least-Once Atomic Delivery (
BLMOVE): Powered by RedisBLMOVEoperations and crash reclaimers to guarantee zero job loss during unexpected worker crashes. - 🔗 HTTP-Style Middleware Pipeline: Chi-like middleware chaining (
server.Use(...)) supporting structured logging (log/slog), panic recovery, and rate limiting. - 🖥️ Embedded Zero-Dependency Vue 3 Web Dashboard: Serves real-time Server-Sent Events (SSE) telemetry and an interactive job browser directly from the Go binary via
go:embed.
📦 Quickstart
Installation
go get github.com/balramadan/gopherqueueStandalone Dashboard Execution
Launch the Web Dashboard GUI with zero setup:
go run github.com/balramadan/gopherqueue/cmd/gopherq-dashboard@latestOpen http://localhost:8080 to inspect real-time metrics, active SSE connection status, and job payloads.
📄 Documentation & Links
- GoDoc Reference: pkg.go.dev/github.com/balramadan/gopherqueue
- Contributing Guide: CONTRIBUTING.md
- Code of Conduct: CODE_OF_CONDUCT.md
❤️ Acknowledgments
Special thanks to all contributors and early adopters who helped shape GopherQueue v0.1.0! Feedback and issues are welcome on GitHub Issues.
What's Changed
- fix: dependabot go package ecosystem and CI to use go version file by @balramadan in #1
- chore(ci): bump actions/setup-go from 6 to 7 by @dependabot[bot] in #2
- chore(ci): bump actions/checkout from 6 to 7 by @dependabot[bot] in #3
- chore(deps-web): bump @types/node from 24.13.3 to 26.1.2 in /web by @dependabot[bot] in #4
- chore(deps-web): bump prettier from 3.9.5 to 3.9.6 in /web by @dependabot[bot] in #5
- chore(deps-web): bump typescript from 6.0.3 to 7.0.2 in /web by @dependabot[bot] in #6
New Contributors
- @balramadan made their first contribution in #1
- @dependabot[bot] made their first contribution in #2
Full Changelog: https://github.com/balramadan/gopherqueue/commits/v0.1.0