/bunny-mock

Simple Bunny/RabbitMQ mock class in Ruby. Useful for mocking Bunny usage in test code.

Primary LanguageRubyMIT LicenseMIT

Overview

Code Climate Build Status

This is a brain-dead-simple mock for the Bunny class provided by the bunny gem, which is a synchronous Ruby RabbitMQ client. If you want to mock out RabbitMQ in your tests and are currently using Bunny, this might be the tool for you.

BunnyMock does not mock all of the methods of Bunny. It currently only mocks the behavior I needed for my immediate needs, which is mainly creating and binding queues and exchanges, and publishing/subscribing messages.

Feel free to fork it to add more behavior mocking and send me a pull request.

Installation

The easiest way to use this is to drop bunny_mock.rb into your spec/support directory, or something like that. Just require bunny_mock and then use BunnyMock.new instead of Bunny.new(params).

Someday I might package this up as a gem.

Usage

Since this is intended as a simple way to help test your collaboration with Bunny/RabbitMQ, it does not really opereate as a real queue, but it does support receiving messages into a queue, and reading them out. The main thing to be aware of is that the BunnyMock::Queue#subscribe method does not block waiting for messages, consumes all queued messages, and returns when there are no more messages. This differs from the behavior of the real Bunny.

See the first "integration" test case in spec/lib/bunny_mock_spec.rb for a quick example of how to use BunnyMock.

Author

Scott W. Bradley - http://scottwb.com

Contributing

  • Fork the project.
  • Make your feature addtion or bug fix.
  • Add test for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (If you want to have your own version, that is fine, but bump version in a separate commit by itself so I can ignore it when I pull).
  • Send me a pull request. Bonus points for topic branches.

License

This code is licensed under Apache License 2.0