NOTICE

This module is presently in a difficult-to-maintain state, and caution should be used in using it.

• The OpenSSL version used by the librabbitmq-c library is end-of-life
• The code duplication in this module makes it very difficult to keep up with C library updates

There is a GitHub Discussion here regarding paths forward, and if you use this module then your input is requested.

It is important that if you use this module, that you mitigate these risks to your satisfaction, or to that of your organization.

Install

cpanm Net::AMQP::RabbitMQ

or

cpan Net::AMQP::RabbitMQ

Documentation

https://metacpan.org/pod/Net::AMQP::RabbitMQ

or once installed perldoc Net::AMQP::RabbitMQ

Tests

There are several environment variables you can set that influence the tests.

https://metacpan.org/pod/Net::AMQP::RabbitMQ#RUNNING-THE-TEST-SUITE

For developers/authors

Once you have cloned the repo, you will need to download the submodules.

git submodule init
git submodule update

There is a vagrant development environment available, with a local rabbitmq installation and ssl enabled.

The test environment variables have been set to use this install

vagrant up
vagrant ssh
cd /vagrant
make distclean; perl Makefile.PL; make

#run all tests with test debugging
NARDEBUG=1 prove -I blib/lib -I blib/arch -v t/

#run all tests in ssl mode
MQSSL=1 prove -I blib/lib -I blib/arch -v t/

To build a release

perl Makefile.PL
make manifest
make dist

Special note for macOS

You need pkg-config working, especially for openssl. There are so many different ways to install dependencies, and so many different paths for them, it is becoming very difficult to guess where they will be.

As a result, we're shifting to using pkg-config for this. Please make sure that if you're running into any problems of missing symbols or misplaced files, that you check this first.

OpenSSL Compatibility

So far we have been testing with OpenSSL 1.1. We appear to be good there, but OpenSSL 3 is not supported at this time.