Limero is a CouchDB-like message broker. You can create and delete queues, send and receive messages using HTTP requests. Everything is simple and fast. You can just relax 🛋️
Clone repository and go to the project folder
git clone https://github.com/sotchenkov/limero
cd limeroYou can use the docker container:
docker build -t limero .
docker run -p 7920:7920 -d limeroOr run it using Go:
go mod download
go run ./cmd/limero/main.goOr pull and run from the Docker Hub:
docker run -p 7920:7920 -d lexso/limeroLimero is now ready to use ✨
First, create a queue:
curl -LX PUT "https://127.0.0.1:7920/queue?name=helloworld"
{
"ok": true,
"info": "The queue has been created",
"name": "helloworld",
"presize": 1
} Now you can send a message to the queue:
curl --request POST \
--url 'https://localhost:7920/msg?qname=helloworld' \
--header 'Content-Type: application/json' \
--data '{"value": "this is a new message!"}'
{"ok":true}⏎ The key for messages is always "value"
And now we will receive a message from the queue:
curl -LX GET "https://127.0.0.1:7920/msg?qname=helloworld"
{"value":"this is a new message!"}⏎To view all the documentation, open the address under the "docs" key in the browser:
curl -LX GET "https://127.0.0.1:7920/"
{
"limero": "Welcome!",
"version": "0.1",
"license": "MIT license",
"author": "Alexey Sotchenkov",
"docs": "localhost:7920/swagger/"
} By opening the url in the browser, you can view the full swagger documentation
You can allocate the queue size in advance if you know the average number of messages that will be in the queue. This will increase the queue performance ⚡
curl -LX PUT "https://127.0.0.1:7920/queue?name=helloworld&size=100"
{
"ok": true,
"info": "The queue has been created",
"name": "helloworld",
"presize": 100
} Limero is an MIT licensed open source project. The fastest way to get something fixed is to open a PR.
I will be glad of your help 💙