https://github.com/celery/librabbitmq

Python bindings to librabbitmq-c
https://github.com/celery/librabbitmq

amqp amqp-client amqp0-9-1 c library python

Last synced: about 1 month ago
JSON representation

Python bindings to librabbitmq-c

• Host: GitHub
• URL: https://github.com/celery/librabbitmq
• Owner: celery
• License: gpl-2.0
• Created: 2010-06-13T07:36:17.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2022-12-14T13:13:20.000Z (over 1 year ago)
• Last Synced: 2024-05-19T17:32:06.702Z (4 months ago)
• Topics: amqp, amqp-client, amqp0-9-1, c, library, python
• Language: C
• Homepage:
• Size: 2.53 MB
• Stars: 203
• Watchers: 18
• Forks: 92
• Open Issues: 26
• Metadata Files:
  • Readme: README.rst
  • Changelog: Changelog
  • License: LICENSE-GPL-2.0

Awesome Lists containing this project

README

        
================================================================

 librabbitmq - Python AMQP Client using the rabbitmq-c library.

================================================================

:Version: 2.0.0

:Download: http://pypi.python.org/pypi/librabbitmq/

:Code: http://github.com/celery/librabbitmq/

:Keywords: rabbitmq, amqp, messaging, librabbitmq, rabbitmq-c, python,

           kombu, celery

.. contents::

    :local:

Python bindings to the RabbitMQ C-library `rabbitmq-c`_.

Supported by Kombu and Celery.

.. _`rabbitmq-c`: https://github.com/alanxz/rabbitmq-c

Installation

============

Install via pip::

    $ pip install librabbitmq

or, install via easy_install::

    $ easy_install librabbitmq

Downloading and installing from source

--------------------------------------

Download the latest version from

    http://pypi.python.org/pypi/librabbitmq/

Then install it by doing the following,::

    $ tar xvfz librabbitmq-0.0.0.tar.gz

    $ cd librabbitmq-0.0.0

    $ python setup.py build

    # python setup.py install # as root

Using the development version

-----------------------------

You can clone the repository by doing the following::

    $ git clone git://github.com/celery/librabbitmq.git

Then install it by doing the following::

    $ cd librabbitmq

    $ make install        # or make develop

Examples

========

Using with Kombu::

    >>> from kombu import Connection

    >>> x = Connection("librabbitmq://")

Stand-alone::

    >>> from librabbitmq import Connection

    >>> conn = Connection(host="localhost", userid="guest",

    ...                   password="guest", virtual_host="/")

    >>> channel = conn.channel()

    >>> channel.exchange_declare(exchange, type, ...)

    >>> channel.queue_declare(queue, ...)

    >>> channel.queue_bind(queue, exchange, routing_key)

Producing

---------

::

    >>> channel.basic_publish(body, exchange, routing_key, ...)

Consuming

---------

::

    >>> def dump_message(message):

    ...     print("Body:'%s', Properties:'%s', DeliveryInfo:'%s'" % (

    ...         message.body, message.properties, message.delivery_info))

    ...     message.ack()

    >>> channel.basic_consume(queue, ..., callback=dump_message)

    >>> while True:

    ...    connection.drain_events()

Poll

----

::

    >>> message = channel.basic_get(queue, ...)

    >>> if message:

    ...     dump_message(message)

    ...     print("Body:'%s' Properties:'%s' DeliveryInfo:'%s'" % (

    ...         message.body, message.properties, message.delivery_info))

Other

-----

::

    >>> channel.queue_unbind(queue, ...)

    >>> channel.close()

    >>> connection.close()

License

=======

This software is licensed under the ``Mozilla Public License``.

See the ``LICENSE-MPL-RabbitMQ`` file in the top distribution directory

for the full license text.

.. # vim: syntax=rst expandtab tabstop=4 shiftwidth=4 shiftround