Wrapper for the PIKA for asyncio and humans.
Project description
Wrapper for the PIKA for asyncio and humans. See examples and the tutorial in documentation.
If you are newcomer in the RabbitMQ let’s start the adopted official RabbitMQ tutorial
Features
Completely asynchronous API.
Object oriented API.
Auto-reconnects with complete state recovery with connect_robust (e.g. declared queues or exchanges, consuming state and bindings).
Python 3.4+ compatible (include 3.6).
Installation
pip install aio-pikaUsage example
import asyncio
from aio_pika import connect_robust, Message
async def main(loop):
connection = await connect_robust("amqp://guest:guest@127.0.0.1/", loop=loop)
queue_name = "test_queue"
routing_key = "test_queue"
# Creating channel
channel = await connection.channel()
# Declaring exchange
exchange = await channel.declare_exchange('direct', auto_delete=True)
# Declaring queue
queue = await channel.declare_queue(queue_name, auto_delete=True)
# Binding queue
await queue.bind(exchange, routing_key)
await exchange.publish(
Message(
bytes('Hello', 'utf-8'),
content_type='text/plain',
headers={'foo': 'bar'}
),
routing_key
)
# Receiving message
incoming_message = await queue.get(timeout=5)
# Confirm message
incoming_message.ack()
await queue.unbind(exchange, routing_key)
await queue.delete()
await connection.close()
if __name__ == "__main__":
loop = asyncio.get_event_loop()
loop.run_until_complete(main(loop))See another examples and the tutorial in documentation.
For contributors
You feel free to create pull request, but you should describe your cases and add some examples.
The changes should follow simple rules:
When your changes breaks public API you must increase the major version.
When your changes is safe for public API (e.g. added an argument with default value)
You have to add test cases (see tests/ folder)
You must add docstrings
You feel free to add yourself to “thank’s to” section
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file aio-pika-1.2.0.tar.gz.
File metadata
- Download URL: aio-pika-1.2.0.tar.gz
- Upload date:
- Size: 20.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0a6abb0f8bd16c0e8febc1c55902f8567b498c454939da9b3d8115a79f641337 |
|
| MD5 | 4ff4689ce437b6a6f98d1fe26f828fc3 |
|
| BLAKE2b-256 | 2066d8f531f64f078053a7f5d93d85faf9da1a02e61fee7ef58bc1c7109a0d03 |
File details
Details for the file aio_pika-1.2.0-py3-none-any.whl.
File metadata
- Download URL: aio_pika-1.2.0-py3-none-any.whl
- Upload date:
- Size: 29.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c88369aa5860388bf49dd0706aedb8e7d89e30fccb5e01fedf4abd4ffbbc5f9f |
|
| MD5 | 8b9ea3b97b2d578c7b1f3c98e7e46043 |
|
| BLAKE2b-256 | f7a6ff814644c8a295f2fe5ba82e5e9b1a8e41911f7bd91c172eb1a87a7cb999 |
