Skip to content

reddec/pika

 
 

Repository files navigation

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

Version Downloads Status Coverage License

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:

And an example of writing a blocking consumer:

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.

About

Pure Python RabbitMQ/AMQP 0-9-1 client library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%