pika · PyPI

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.

Python 2.6+ and 3.3+ are supported.
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 mileage will vary.
People may be using direct sockets, 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 can be found 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

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

Contributing

To contribute to pika, please make sure that any new features or changes to existing functionality include test coverage. Additionally, please format your code using yapf with google style prior to issuing your pull request.

Metadata

Release files for pika 0.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pika 0.10.0
File	Size	Uploaded
pika-0.10.0.tar.gz	82.6 kB	Sep 2, 2015	Details

Built distribution (wheel)

Table of built distributions (wheels) for pika 0.10.0
File	Interpreter	ABI	Platform	Reset
pika-0.10.0-py2.py3-none-any.whl 92.8 kB Sep 2, 2015	Python 3, Python 2	none	any	Details

Total release size: 175.5 kB

Release files / pika-0.10.0.tar.gz

Download URL	pika-0.10.0.tar.gz
Size	82.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`7277b4d12a99efa4058782614d84138983f9f89d690bdfcea66290d810806459`
BLAKE2b-256 checksum How to use checksums	`ee251517ce612d7cd0a426ea027275ba74165bbfd86a2daf4bce4839afac3deb`
Upload date	Sep 2, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / pika-0.10.0-py2.py3-none-any.whl

Download URL	pika-0.10.0-py2.py3-none-any.whl
Size	92.8 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`63131aaeec48a6c8f1db1fe657e1e74cf384c3927eb7d1725e31edae4220dea4`
BLAKE2b-256 checksum How to use checksums	`2612400cf0aca6b1ecf1f00dcd89b246e7a4c8558677304ba067167b8167e714`
Upload date	Sep 2, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No