/ 
Crixa-0.07
River stage zero No dependents
/ Crixa

NAME

Crixa - A Cleaner API for Net::AMQP::RabbitMQ

VERSION

version 0.07

SYNOPSIS

use Crixa;

my $mq       = Crixa->connect( host => 'localhost' );
my $channel  = $mq->channel;
my $exchange = $channel->exchange( name => 'hello' );

sub send {
    $exchange->publish('Hello World');
}

my $queue = $exchange->queue( name => 'hello' );

sub receive {
    $queue->handle_message( sub { say $_->body } );
}

DESCRIPTION

All the world will be your enemy, Prince of a Thousand enemies. And when
they catch you, they will kill you. But first they must catch you; digger,
listener, runner, Prince with the swift warning. Be cunning, and full of
tricks, and your people will never be destroyed. -- Richard Adams

This module provides a more natural API over Net::AMQP::RabbitMQ, with separate objects for channels, exchanges, and queues.

WARNING

Crixa is still in development and the API may change in the future!

METHODS

This class provides the following methods:

Crixa->connect(...)

Creates a new connection to a RabbitMQ server. It takes a hash or hashref of named parameters.

host => $hostname

The hostname to connect to. Required.

port => $post

An optional port.

user => $user

An optional username.

password => $password

An optional password.

$crixa->new_channel

Returns a new Crixa::Channel object.

You can use the channel to create exchanges and queues.

$crixa->disconnect

Disconnect from the server. This is called implicitly by DEMOLISH so normally there should be no need to do this explicitly.

$crixa->host

Returns the port passed to the constructor, if nay.

$crixa->user

Returns the user passed to the constructor, if any.

$crixa->password

Returns the password passed to the constructor, if any.

SUPPORT

Please report all issues with this code using the GitHub issue tracker at https://github.com/Tamarou/Crixa/issues.

SEE ALSO

This module uses Net::AMQP::RabbitMQ under the hood, though it does not expose everything provided by its API.

The best documentation we've found on RabbitMQ (and AMQP) concepts is the Bunny documentation at http://rubybunny.info/articles/guides.html. We strongly recommend browsing this to get a better understanding of how RabbitMQ works, what different options for exchanges, queues, and messages mean, and more.

AUTHORS

  • Chris Prather <chris@prather.org>

  • Dave Rolsky <autarch@urth.org>

CONTRIBUTOR

Torsten Raudssus <torsten@raudss.us>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Chris Prather.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.