Skip to main content

Wrapper for the PIKA for asyncio and humans.

Project description

ReadTheDocs Coveralls Travis CI Latest Version https://img.shields.io/pypi/wheel/aio-pika.svg https://img.shields.io/pypi/pyversions/aio-pika.svg https://img.shields.io/pypi/l/aio-pika.svg

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

Installation

pip install aio-pika

Usage example

import asyncio
from aio_pika import connect, Message


async def main(loop):
    connection = await connect("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

Project details


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

aio-pika-0.18.0.tar.gz (17.0 kB view details)

Uploaded Source

Built Distribution

aio_pika-0.18.0-py3-none-any.whl (25.5 kB view details)

Uploaded Python 3

File details

Details for the file aio-pika-0.18.0.tar.gz.

File metadata

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

File hashes

Hashes for aio-pika-0.18.0.tar.gz
Algorithm Hash digest
SHA256 d680cb8b5ead0c172f6cdd76a66bb3268a7dee12cc3161f019b4c849c9b1eef7
MD5 87b9f4d4bd3dd5bb2a0dd0fad64458a1
BLAKE2b-256 54300a84da77820422253cfe94a09a03df1da386cb13a0c9336535ea8e5092a5

See more details on using hashes here.

File details

Details for the file aio_pika-0.18.0-py3-none-any.whl.

File metadata

File hashes

Hashes for aio_pika-0.18.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ec652d4c2fd39d7a12ebd796b3d5cfdf3bdfb4882f30d1b1a1895e999be473d3
MD5 4b8a79b20e0260d8933e8493a06122eb
BLAKE2b-256 be27730b6ff9352b34a6b90b25bee7e1fd3ac2f9ed308f1096c818e7ae866ec9

See more details on using hashes here.

Supported by

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