Skip to main content

Pika Python AMQP Client Library

Project description

Pika is a RabbitMQ (AMQP-0-9-1) client library for Python.

Version Status Coverage License Documentation Status

Introduction

Pika is a pure-Python implementation of the AMQP 0-9-1 protocol including RabbitMQ’s extensions.

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

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

  • AsyncioConnection - adapter for the Python3 AsyncIO event loop

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

Pull requests that add or change code without coverage will most likely be rejected.

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.11.0b1.tar.gz (95.3 kB view details)

Uploaded Source

Built Distribution

pika-0.11.0b1-py2.py3-none-any.whl (106.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file pika-0.11.0b1.tar.gz.

File metadata

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

File hashes

Hashes for pika-0.11.0b1.tar.gz
Algorithm Hash digest
SHA256 e425005910b54b2b232167a9bf906b7cf8ad0473f33049cff4a6e7d36b4a4ae2
MD5 25f8ac7866d70d20530eed33d85b5e1c
BLAKE2b-256 964cb3d640cd36f695c14f2334571f083f7a419e0694a94b4d714ef4ebed84c0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pika-0.11.0b1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8e98f4b4246f5d5388828325e1e8856f072eba20b92722f372e3fa34a032a6cc
MD5 8a9cbdb9423e7d4ae31b79a4a900fdb3
BLAKE2b-256 f11df6b178d7da4e14336545a79a329c49b7f837c9b36842a13566a5dacf3fe5

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