Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/woorui/aws-msg
AWS SQS Pub/Sub Primitives implemented by aws-sdk-go-v2
https://github.com/woorui/aws-msg
aws aws-sdk go-msg pubsub sqs sqs-queue
Last synced: 16 days ago
JSON representation
AWS SQS Pub/Sub Primitives implemented by aws-sdk-go-v2
- Host: GitHub
- URL: https://github.com/woorui/aws-msg
- Owner: woorui
- Created: 2022-02-16T07:05:14.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-09-14T02:39:13.000Z (over 2 years ago)
- Last Synced: 2024-11-12T14:28:19.341Z (3 months ago)
- Topics: aws, aws-sdk, go-msg, pubsub, sqs, sqs-queue
- Language: Go
- Homepage:
- Size: 64.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# aws-msg
[](https://codecov.io/gh/woorui/aws-msg)
## Overview
Package aws-msg implements pub/sub primitives outlined in package "github.com/zerofox-oss/go-msg".
It's built on top of "github.com/aws/aws-sdk-go-v2".
## Why use
1. Elegant pub/sub API from https://github.com/zerofox-oss/go-msg
2. Support multiple goroutinue to pull messages from SQS; The receive speed is significantly improved.
3. Support graceful shutdown.
4. Backpressure for handling SQS message.
## Install
```
go get github.com/woorui/aws-msg
```
## Examples
```go
package main
import (
"context"
"io/ioutil"
"log"
"os"
"time"
"github.com/aws/aws-sdk-go-v2/config"
"github.com/aws/aws-sdk-go-v2/credentials"
"github.com/aws/aws-sdk-go-v2/service/sqs"
sqsmsg "github.com/woorui/aws-msg/sqs"
"github.com/zerofox-oss/go-msg"
)
var (
region = "cn-northwest-1"
key = "QNWIOCMEROCVSL"
secret = "aswekdpa[veverjiwAmioeoqxkaij"
queueName = "the-queue-name"
)
var client *sqs.Client
func init() {
cfg, err := config.LoadDefaultConfig(
context.TODO(),
config.WithRegion(region),
config.WithCredentialsProvider(
credentials.NewStaticCredentialsProvider(key, secret, ""),
),
)
if err != nil {
log.Fatal(err)
}
client = sqs.NewFromConfig(cfg)
}
// ExampleServer dumps SQS message to ./messages.log for 5 seconds
func ExampleServer() {
server, err := sqsmsg.NewServer(queueName, client)
if err != nil {
log.Fatal(err)
}
go func() {
err = server.Serve(dumpToPath("./messages.log"))
if err != nil {
log.Fatal(err)
}
}()
time.Sleep(5 * time.Second)
server.Shutdown(context.TODO())
}
// ExampleTopic show how to send an SQS message
func ExampleTopic() {
ctx := context.Background()
topic, err := sqsmsg.NewTopic(ctx, queueName, client)
if err != nil {
log.Fatal(err)
}
userCtx := context.Background()
w := topic.NewWriter(userCtx)
if _, err = w.Write([]byte("hello world")); err != nil {
log.Fatal(err)
}
if err := w.Close(); err != nil {
log.Fatal(err)
}
}
// fileLog write sqs message to local file
// fileLog implement msg.Receiver
type fileLog struct {
f *os.File
}
func dumpToPath(path string) *fileLog {
f, err := os.OpenFile(path, os.O_APPEND|os.O_WRONLY, 0644)
if err != nil {
panic(err)
}
return &fileLog{f: f}
}
func (f *fileLog) Receive(c context.Context, m *msg.Message) error {
contents, _ := ioutil.ReadAll(m.Body)
f.f.Write([]byte{'\n'})
_, err := f.f.Write(contents)
return err
}
```
## Reference
https://github.com/zerofox-oss/go-msg
https://github.com/aws/aws-sdk-go-v2
https://github.com/zerofox-oss/go-aws-msg