Skip to main content

Pika Python AMQP Client Library

Project description

Version Downloads Status Coverage License Documentation 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.

  • 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pika-0.10.0.tar.gz (82.6 kB view details)

Uploaded Source

Built Distribution

pika-0.10.0-py2.py3-none-any.whl (92.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pika-0.10.0.tar.gz.

File metadata

  • Download URL: pika-0.10.0.tar.gz
  • Upload date:
  • Size: 82.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pika-0.10.0.tar.gz
Algorithm Hash digest
SHA256 7277b4d12a99efa4058782614d84138983f9f89d690bdfcea66290d810806459
MD5 db5025bc5abfb0f78573616ee846df31
BLAKE2b-256 ee251517ce612d7cd0a426ea027275ba74165bbfd86a2daf4bce4839afac3deb

See more details on using hashes here.

File details

Details for the file pika-0.10.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pika-0.10.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 63131aaeec48a6c8f1db1fe657e1e74cf384c3927eb7d1725e31edae4220dea4
MD5 b0d484c8e249b3ca571a5e497f0a3c8c
BLAKE2b-256 2612400cf0aca6b1ecf1f00dcd89b246e7a4c8558677304ba067167b8167e714

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page