Polyconseil / aioamqp

AMQP implementation using asyncio
Other
280 stars 88 forks source link
amqp asyncio python3

aioamqp

.. image:: https://badge.fury.io/py/aioamqp.svg :target: http://badge.fury.io/py/aioamqp .. image:: https://travis-ci.org/Polyconseil/aioamqp.svg?branch=master :target: https://travis-ci.org/Polyconseil/aioamqp

.. image:: https://readthedocs.org/projects/aioamqp/badge/?version=latest :alt: Documentation Status :scale: 100% :target: https://aioamqp.readthedocs.org/en/latest/?badge=latest

aioamqp library is a pure-Python implementation of the AMQP 0.9.1 protocol_.

Built on top on Python's asynchronous I/O support introduced in PEP 3156_, it provides an API based on coroutines, making it easy to write highly concurrent applications.

Bug reports, patches and suggestions welcome! Just open an issue or send a pull request.

tests

To run the tests, you'll need to install the Python test dependencies::

pip install -r requirements_dev.txt

Tests require an instance of RabbitMQ. You can start a new instance using docker::

 docker run -d --log-driver=syslog -e RABBITMQ_NODENAME=my-rabbit --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management

Then you can run the tests with make test.

tests using docker-compose ^^^^^^^^^^^^^^^^^^^^^^^^^^ Start RabbitMQ using docker-compose up -d rabbitmq. When RabbitMQ has started, start the tests using docker-compose up --build aioamqp-test

.. _AMQP 0.9.1 protocol: https://www.rabbitmq.com/amqp-0-9-1-quickref.html .. _PEP 3156: http://www.python.org/dev/peps/pep-3156/ .. _issue: https://github.com/Polyconseil/aioamqp/issues/new .. _pull request: https://github.com/Polyconseil/aioamqp/compare/