Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rafaeljesus/rabbus
A tiny wrapper over amqp exchanges and queues 🚌 ✨
https://github.com/rafaeljesus/rabbus
amqp event-driven eventbus golang microservices rabbitmq resilience
Last synced: 9 days ago
JSON representation
A tiny wrapper over amqp exchanges and queues 🚌 ✨
- Host: GitHub
- URL: https://github.com/rafaeljesus/rabbus
- Owner: rafaeljesus
- License: mit
- Created: 2017-05-07T08:51:11.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-07-23T10:48:01.000Z (over 5 years ago)
- Last Synced: 2024-07-31T20:52:19.063Z (3 months ago)
- Topics: amqp, event-driven, eventbus, golang, microservices, rabbitmq, resilience
- Language: Go
- Homepage:
- Size: 137 KB
- Stars: 97
- Watchers: 9
- Forks: 23
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - rabbus - A tiny wrapper over amqp exchanges and queues. (Messaging / Search and Analytic Databases)
- zero-alloc-awesome-go - rabbus - A tiny wrapper over amqp exchanges and queues. (Messaging / Search and Analytic Databases)
- awesome-go - rabbus - A tiny wrapper over amqp exchanges and queues - ★ 46 (Messaging)
- awesome-go-extra - rabbus - 05-07T08:51:11Z|2019-07-23T10:48:01Z| (Messaging / Advanced Console UIs)
- awesome-go-zh - rabbus
README
## Rabbus 🚌 ✨
* A tiny wrapper over [amqp](https://github.com/streadway/amqp) exchanges and queues.
* In memory retries with exponential backoff for sending messages.
* Protect producer calls with [circuit breaker](https://github.com/sony/gobreaker).
* Automatic reconnect to RabbitMQ broker when connection is lost.
* Go channel API.
## Installation
```bash
go get -u github.com/rafaeljesus/rabbus
```
## Usage
The rabbus package exposes an interface for emitting and listening RabbitMQ messages.
### Emit
```go
import (
"context"
"time"
"github.com/rafaeljesus/rabbus"
)
func main() {
timeout := time.After(time.Second * 3)
cbStateChangeFunc := func(name, from, to string) {
// do something when state is changed
}
r, err := rabbus.New(
rabbusDsn,
rabbus.Durable(true),
rabbus.Attempts(5),
rabbus.Sleep(time.Second*2),
rabbus.Threshold(3),
rabbus.OnStateChange(cbStateChangeFunc),
)
if err != nil {
// handle error
}
defer func(r Rabbus) {
if err := r.Close(); err != nil {
// handle error
}
}(r)
ctx, cancel := context.WithCancel(context.Background())
defer cancel()
go r.Run(ctx)
msg := rabbus.Message{
Exchange: "test_ex",
Kind: "topic",
Key: "test_key",
Payload: []byte(`foo`),
}
r.EmitAsync() <- msg
for {
select {
case <-r.EmitOk():
// message was sent
case <-r.EmitErr():
// failed to send message
case <-timeout:
// handle timeout error
}
}
}
```
### Listen
```go
import (
"context"
"encoding/json"
"time"
"github.com/rafaeljesus/rabbus"
)
func main() {
timeout := time.After(time.Second * 3)
cbStateChangeFunc := func(name, from, to string) {
// do something when state is changed
}
r, err := rabbus.New(
rabbusDsn,
rabbus.Durable(true),
rabbus.Attempts(5),
rabbus.Sleep(time.Second*2),
rabbus.Threshold(3),
rabbus.OnStateChange(cbStateChangeFunc),
)
if err != nil {
// handle error
}
defer func(r Rabbus) {
if err := r.Close(); err != nil {
// handle error
}
}(r)
ctx, cancel := context.WithCancel(context.Background())
defer cancel()
go r.Run(ctx)
messages, err := r.Listen(rabbus.ListenConfig{
Exchange: "events_ex",
Kind: "topic",
Key: "events_key",
Queue: "events_q",
DeclareArgs: rabbus.NewDeclareArgs().WithMessageTTL(15 * time.Minute).With("foo", "bar"),
BindArgs: rabbus.NewBindArgs().With("baz", "qux"),
})
if err != nil {
// handle errors during adding listener
}
defer close(messages)
go func(messages chan ConsumerMessage) {
for m := range messages {
m.Ack(false)
}
}(messages)
}
```
## Contributing
- Fork it
- Create your feature branch (`git checkout -b my-new-feature`)
- Commit your changes (`git commit -am 'Add some feature'`)
- Push to the branch (`git push origin my-new-feature`)
- Create new Pull Request
## Badges
[](https://circleci.com/gh/rafaeljesus/rabbus)
[](https://goreportcard.com/report/github.com/rafaeljesus/rabbus)
[](https://godoc.org/github.com/rafaeljesus/rabbus)
---
> GitHub [@rafaeljesus](https://github.com/rafaeljesus) ·
> Medium [@_jesus_rafael](https://medium.com/@_jesus_rafael) ·
> Twitter [@_jesus_rafael](https://twitter.com/_jesus_rafael)