Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stanipetrosyan/go-eventbus
Event Bus package for Go
https://github.com/stanipetrosyan/go-eventbus
eventbus go golang hacktoberfest pubsub
Last synced: 4 months ago
JSON representation
Event Bus package for Go
- Host: GitHub
- URL: https://github.com/stanipetrosyan/go-eventbus
- Owner: stanipetrosyan
- License: mit
- Created: 2022-10-10T19:25:21.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-26T14:34:16.000Z (6 months ago)
- Last Synced: 2024-08-26T16:58:22.446Z (6 months ago)
- Topics: eventbus, go, golang, hacktoberfest, pubsub
- Language: Go
- Homepage:
- Size: 74.2 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - go-eventbus - Simple Event Bus package for Go. (Messaging / Search and Analytic Databases)
README
[](https://goreportcard.com/report/github.com/stanipetrosyan/go-eventbus)
[](https://codecov.io/gh/stanipetrosyan/go-eventbus)
[](https://pkg.go.dev/github.com/stanipetrosyan/go-eventbus)
# EventBus for Golang
## Description
This is a simple implementation of an event bus in golang. Actually support follwing pattern:
- [x] publish/subscribe
- [x] request/response
## Get Started
To start use eventbus in your project, you can run the following command.
```
go get github.com/stanipetrosyan/go-eventbus
```
And import
``` go
import (
goeventbus "github.com/stanipetrosyan/go-eventbus"
)
```
## Publish/Subscribe
Simple example of publish/subscribe pattern.
```go
eventbus = goeventbus.NewEventBus()
address := "topic"
options := goeventbus.NewMessageOptions().AddHeader("header", "value")
message := goeventbus.CreateMessage().SetBody("Hi Topic").SetOptions(options)
eventbus.Channel(address).Subscriber().Listen(func(dc goeventbus.Context) {
fmt.Printf("Message %s\n", dc.Result().Data)
})
eventbus.Channel(address).Publisher().Publish(message)
```
## Request/Response
Simple example of request/response pattern.
```go
eventbus = goeventbus.NewEventBus()
address := "topic"
message := goeventbus.CreateMessage().SetBody("Hi Topic")
eventbus.Channel(address).Subscriber().Listen(func(context goeventbus.Context) {
fmt.Printf("Message %s\n", context.Result().Extract())
context.Reply("Hello from subscriber")
})
eventbus.Channel(address).Publisher().Request(message, func(context goeventbus.Context) {
fmt.Printf("Message %s\n", context.Result().Extract())
})
```
## Message
For publishing, you need to create a Message object using this method.
```go
message := goeventbus.CreateMessage().SetBody("Hi Topic")
```
Each message can have some options:
```go
options := goeventbus.NewMessageOptions().AddHeader("header", "value")
message := goeventbus.CreateMessage()
message.SetOptions(options)
eventBus.Channel("address").Publisher().Publish(message)
```
## Processor
A processor works like a middleware, in fact forwards messages only if the predicate is satisfied. The method accepts a function with message and return must return a boolean.
```go
eventbus.Channel("topic1").Processor(func(message goeventbus.Message) bool {
return message.Options.Headers().Contains("header")
})
```
## Network Bus
A Network bus create a tcp connection between different services.
NetworkBus is a wrapper of local eventbus.
A simple server/client example is in `examples/networkbus` directory.