README.md

Bunny, a Ruby RabbitMQ Client

Bunny is a synchronous RabbitMQ client that focuses on ease of use. With the next
0.9 release (currently in master), it is feature complete, supports all RabbitMQ 3.0
features and is free of many limitations of earlier versions.

Supported Ruby Versions

Supported RabbitMQ Versions

Bunny 0.8.x and later versions only support RabbitMQ 2.x and 3.x.
Bunny 0.7.x and earlier versions support RabbitMQ 1.x and 2.x.

Changes in Bunny 0.9

Bunny is a very old library with a lot of missing functionality. It also implements an older version of the spec
and may or may not work with future RabbitMQ versions. As such, Bunny needed serious internal changes.
We (the maintainers) make our best to keep the new version as backwards compatible as possible but within reason.

IRC

News & Announcements on Twitter

To subscribe for announcements of releases, important changes and so on, please follow @rubyamqp on Twitter.

Reporting Issues

If you find a bug, poor default, missing feature or find any part of the API inconvenient, please file an issue on GitHub.
When filing an issue, please specify which Bunny and RabbitMQ versions you are using, provide recent RabbitMQ log file contents if possible,
and try to explain what behavior you expected and why. Bonus points for contributing failing test cases.

Other Ruby RabbitMQ Clients

Other widely used Ruby RabbitMQ clients are Hot Bunnies (JRuby-only) and amqp gem.
Both are mature libraries and require RabbitMQ 2.x or 3.x.

Contributing

First, clone the repository and run

bundle install --binstubs

then set up RabbitMQ vhosts with

./bin/ci/before_build.sh

(if needed, set RABBITMQCTL env variable to point to rabbitmqctl you want to use)

and then run tests with

./bin/rspec -cfs spec

After that create a branch and make your changes on it. Once you are done with your changes and all tests pass, submit a pull request
on GitHub.