Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

AMQP 0-9-1 client library for Python

This branch is 0 commits ahead and 0 commits behind master

Dont test this in PyPy due to sort order issue

PyPy is ordering the dict iteration different than cpython causing the test to fail
latest commit 43904ff29f
Gavin M. Roy gmr authored
Octocat-spinner-32 docs
Octocat-spinner-32 examples
Octocat-spinner-32 pika Don't leave __repr__ sorting up to chance February 17, 2014
Octocat-spinner-32 tests
Octocat-spinner-32 utils Use dict.keys & items instead of iterkeys & iteritems June 10, 2013
Octocat-spinner-32 .gitignore Fixes issue #279 February 12, 2013
Octocat-spinner-32 .travis.yml Add integration test to travis and fix invocation February 17, 2014
Octocat-spinner-32 LICENSE
Octocat-spinner-32 Makefile
Octocat-spinner-32 README.md
Octocat-spinner-32 integration.cfg
Octocat-spinner-32 setup.py
README.md

Pika, an AMQP 0-9-1 client library for Python

PyPI version Downloads Build Status

Introduction

Pika is a pure-Python implementation of the AMQP 0-9-1 protocol that tries to stay fairly independent of the underlying network support library.

  • Currently supports Python 2.6 and Python 2.7 only. 3.2+ support planned.

  • Since threads aren't appropriate to every situation, it doesn't require threads. It takes care not to forbid them, either. The same goes for greenlets, callbacks, continuations and generators. It is not necessarily thread-safe however, and your milage will vary.

  • People may be using direct sockets, asyncore, plain old select(), or any of the wide variety of ways of getting network events to and from a python application. Pika tries to stay compatible with all of these, and to make adapting it to a new environment as simple as possible.

Documentation

Pika's documentation is now at https://pika.readthedocs.org

Example

Here is the most simple example of use, sending a message with the BlockingConnection adapter:

import pika
connection = pika.BlockingConnection()
channel = connection.channel()
channel.basic_publish(exchange='example',
                      routing_key='test',
                      body='Test Message')
connection.close()

And an example of writing a blocking consumer:

import pika
connection = pika.BlockingConnection()
channel = connection.channel()

for method_frame, properties, body in channel.consume('test'):

    # Display the message parts and ack the message
    print method_frame, properties, body
    channel.basic_ack(method_frame.delivery_tag)

    # Escape out of the loop after 10 messages
    if method_frame.delivery_tag == 10:
        break

# Cancel the consumer and return any pending messages
requeued_messages = channel.cancel()
print 'Requeued %i messages' % requeued_messages
connection.close()

Pika provides the following adapters

  • AsyncoreConnection - based off the standard Python library asyncore
  • BlockingConnection - enables blocking, synchronous operation on top of library for simple uses
  • SelectConnection - fast asynchronous adapter
  • TwistedConnection - adapter for use with the Twisted asynchronous package http://twistedmatrix.com/
  • TornadoConnection - adapter for use with the Tornado IO Loop http://tornadoweb.org
  • LibevConnection - adapter for use with the libev event loop http://libev.schmorp.de

License

Pika is licensed under the MPLv2. If you have any questions regarding licensing, please contact the RabbitMQ team at info@rabbitmq.com.

Something went wrong with that request. Please try again.