0.0
No release in over 3 years
Low commit activity in last 3 years
Simply and easily add AMQP messaging capabilities to your services
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.16
= 0.2.3.beta5
~> 12.0
~> 3.0
~> 1.2
~> 0.60
= 0.7.0.beta7

Runtime

 Project Readme

CottonTail

CircleCI Depfu Code Climate

CottonTail provides a simple DSL for consuming messages from a RabbitMQ server.

This gem is in early development. The API will be unstable until the 1.0.0 release.

Installation

Add this line to your application's Gemfile:

gem 'cotton-tail'

And then execute:

$ bundle

Or install it yourself as:

$ gem install cotton-tail

Usage

Quick Start

You can look at the file examples/app.rb to see an example of what a CottonTail App definition looks like.

To run the example locally you need to have a rabbitmq instance running. The included docker-compose file can be used to start up a local instance of rabbitmq.

docker-compose up

Once the rabbitmq service has completed startup (takes a few seconds) you can start the example app.

bundle exec examples/app.rb

You should see

Waiting for messages ...

We've included bash scripts to publish messages for the example app. Execute them in another terminal window to see output in the app window.

examples/messages/say.hello, examples/messages/say.goodbye, etc...

Development

After checking out the repo, install docker. Then, run docker-compose up to spin up a local instance of rabbitmq. Run rake spec:all to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/jamesBrennan/cotton-tail.