pauldix / bunny

Another synchronous Ruby AMQP client

Home Page:http://wiki.github.com/celldee/bunny

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Bunny: A synchronous Ruby AMQP client

GitHub repo: github.com/celldee/bunny

Rubyforge: rubyforge.org/projects/bunny-amqp

Twitter: twitter.com/bunny_amqp

Google Group: groups.google.com/group/bunny-amqp

Blog: bunnyamqp.wordpress.com

DESCRIPTION:

Bunny is an AMQP (Advanced Message Queuing Protocol) client, written in Ruby, that is intended to allow you to interact with AMQP-compliant message brokers/servers such as RabbitMQ in a synchronous fashion.

It is based on a great deal of useful code from amqp by Aman Gupta and Carrot by Amos Elliston.

You can use Bunny to -

  • Create and delete exchanges

  • Create and delete queues

  • Publish and consume messages

Bunny is known to work with RabbitMQ versions 1.5.4 and above with version 0-8 of the AMQP specification.

INSTALL:

Rubyforge: gem install bunny

Gemcutter: gem install bunny

GitHub: Current gem is not available.

QUICK START:

require 'bunny'

b = Bunny.new(:logging => true)

# start a communication session with the amqp server
b.start

# declare a queue
q = b.queue('test1')

# publish a message to the queue
q.publish('Hello everybody!')

# get message from the queue
msg = q.pop[:payload]

puts 'This is the message: ' + msg + "\n\n"

# close the connection
b.stop

EVEN QUICKER START

require 'bunny'

# Create a direct queue named 'my_testq'
Bunny.run { |c| c.queue('my_testq') }

OTHER:

Please see the examples directory for additional usage information.

About

Another synchronous Ruby AMQP client

http://wiki.github.com/celldee/bunny

License:MIT License