Skip to content
/ pika Public
forked from pika/pika

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

License

Unknown and 2 other licenses found

Licenses found

Unknown
COPYING
GPL-2.0
LICENSE-GPL-2.0
Unknown
LICENSE-MPL-Pika
Notifications You must be signed in to change notification settings

atatsu/pika

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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.

  • 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
  • TornadoConnection - adapter for use with the Tornado IO Loop http://tornadoweb.org

License

Pika is licensed under the MPL, and may also be used under the terms of the GPL. The full license text is included with the source code for the package in the LICENSE-GPL-2.0 and LICENSE-MPL-Pika files. If you have any questions regarding licensing, please contact the RabbitMQ team at info@rabbitmq.com.

About

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

Resources

License

Unknown and 2 other licenses found

Licenses found

Unknown
COPYING
GPL-2.0
LICENSE-GPL-2.0
Unknown
LICENSE-MPL-Pika

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%