Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rafaeljesus/nsq-event-bus
A tiny wrapper around NSQ topic and channel :rocket:
https://github.com/rafaeljesus/nsq-event-bus
event-driven go message-bus microservices nsq
Last synced: about 1 month ago
JSON representation
A tiny wrapper around NSQ topic and channel :rocket:
- Host: GitHub
- URL: https://github.com/rafaeljesus/nsq-event-bus
- Owner: rafaeljesus
- License: mit
- Created: 2017-01-15T22:05:13.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-02-15T22:30:14.000Z (almost 7 years ago)
- Last Synced: 2024-07-31T20:52:19.089Z (4 months ago)
- Topics: event-driven, go, message-bus, microservices, nsq
- Language: Go
- Homepage:
- Size: 54.7 KB
- Stars: 78
- Watchers: 9
- Forks: 17
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - nsq-event-bus - A tiny wrapper around NSQ topic and channel. (Messaging / Search and Analytic Databases)
- zero-alloc-awesome-go - nsq-event-bus - A tiny wrapper around NSQ topic and channel. (Messaging / Search and Analytic Databases)
- awesome-go - nsq-event-bus - A tiny wrapper around NSQ topic and channel - ★ 39 (Messaging)
- awesome-go-extra - nsq-event-bus - 01-15T22:05:13Z|2018-02-15T22:30:14Z| (Messaging / Advanced Console UIs)
- awesome-go-zh - nsq-event-bus
README
## Event Bus NSQ
* A tiny wrapper around [go-nsq](https://github.com/nsqio/go-nsq) topic and channel.
* Protect nsq calls with [gobreaker](https://github.com/sony/gobreaker).
## Installation
```bash
go get -u github.com/rafaeljesus/nsq-event-bus
```
## Usage
The nsq-event-bus package exposes a interface for emitting and listening events.
### Emitter
```go
import "github.com/rafaeljesus/nsq-event-bus"
topic := "events"
emitter, err := bus.NewEmitter(bus.EmitterConfig{
Address: "localhost:4150",
MaxInFlight: 25,
})
e := event{}
if err = emitter.Emit(topic, &e); err != nil {
// handle failure to emit message
}
// emitting messages on a async fashion
if err = emitter.EmitAsync(topic, &e); err != nil {
// handle failure to emit message
}
```
### Listener
```go
import "github.com/rafaeljesus/nsq-event-bus"
if err = bus.On(bus.ListenerConfig{
Topic: "topic",
Channel: "test_on",
HandlerFunc: handler,
HandlerConcurrency: 4,
}); err != nil {
// handle failure to listen a message
}
func handler(message *Message) (reply interface{}, err error) {
e := event{}
if err = message.DecodePayload(&e); err != nil {
message.Finish()
return
}
if message.Attempts > MAX_DELIVERY_ATTEMPTS {
message.Finish()
return
}
err, _ = doWork(&e)
if err != nil {
message.Requeue(BACKOFF_TIME)
return
}
message.Finish()
return
}
```
### Request (Request/Reply)
```go
import "github.com/rafaeljesus/nsq-event-bus"
topic := "user_signup"
emitter, err = bus.NewEmitter(bus.EmitterConfig{})
e := event{Login: "rafa", Password: "ilhabela_is_the_place"}
if err = bus.Request(topic, &e, handler); err != nil {
// handle failure to listen a message
}
func handler(message *Message) (reply interface{}, err error) {
e := event{}
if err = message.DecodePayload(&e); err != nil {
message.Finish()
return
}
reply = &Reply{}
message.Finish()
return
}
```
## 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/nsq-event-bus)
[](https://goreportcard.com/report/github.com/rafaeljesus/nsq-event-bus)
[](https://godoc.org/github.com/rafaeljesus/nsq-event-bus)
---
> GitHub [@rafaeljesus](https://github.com/rafaeljesus) ·
> Medium [@_jesus_rafael](https://medium.com/@_jesus_rafael) ·
> Twitter [@_jesus_rafael](https://twitter.com/_jesus_rafael)