🐇 QueueBunny

QueueBunny is a lightweight RPC connector from RabbitMQ to your command line applications.

✨ Features

• Easy mapping AMQP of messages to shell commands
• Returning response in a simple JSON format
• Works well with Cottontail!
• No need to adapt existing tools to RabbitMQ

📦 Project Structure

src                  # Source Code
config.yml           # Route configuration
package.json         # Project dependencies and scripts
tsconfig.json        # TypeScript config
README.md            # You're here!

🚀 Getting Started

1. Install from NPM

npm install -g @bramedg/queuebunny

2. Set environment variables

export AMQP_URL="amqp://guest:guest@localhost"

5. Start QueueBunny

queuebunny echo.test "echo {{body.valueToEcho}}"

6. Create a tap queue for the response

• Bind to exchange: amq.topic
• Bind to routing key: response.key

📡 Example Request

reply_to: response.key
exchange: amq.topic

Message Body:
{
  "valueToEcho": "Hello World"
}

Assuming everything is set up properly, you'll get a response to your tap queue:

  { 
    "status": "success",
    "output": "Hello World" 
  }

Producer Mode

If you want to continually stream output to a queue, use the ---producer switch. The routing key will become the target routing key. As there is no input, the command line template will need to be a plain command without template arguments.

📜 License

MIT © 2025 Daniel Brame