MQ - A package for consuming SQS message queues
The goal of this project is to provide tooling to utilize SQS effectively in Go.
Features
- Familiar
net/httpHandler interface. - Retry with expontial backoff via visibility timeouts and dead letter queues.
- Router Handler for multiplexing messages over a single queue.
- Server with configurable concurrency and graceful shutdown.
- Automatic batch fetching and deletion.
- Publisher for batch sending.
- Opentracing support
Documentation
https://godoc.org/github.com/remind101/mq-go
QuickStart
func main() {
queueURL := "https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue"
h := mq.HandlerFunc(func(m *mq.Message) error {
fmt.Printf("Received message: %s", aws.StringValue(m.SQSMessage.Body))
// Returning no error signifies the message was processed successfully.
// The Server will queue the message for deletion.
return nil
})
// Configure mq.Server
s := mq.NewServer(queueURL, h)
// Start a loop to receive SQS messages and pass them to the Handler.
s.Start()
defer s.Shutdown(context.Background())
// Start a publisher
p := mq.NewPublisher(queueURL)
p.Start()
defer p.Shutdown(context.Background())
// Publish messages (will be batched).
p.Publish(&sqs.SendMessageBatchRequestEntry{
MessageBody: aws.String("Hello"),
})
p.Publish(&sqs.SendMessageBatchRequestEntry{
MessageBody: aws.String("World!"),
})
}