aiopg-listen 0.0.2

Helps to use PostgreSQL listen/notify with aiopg

aiopg-listen

This library simplifies usage of listen/notify with aiopg:

1. Handles lost of a connection
2. Simplifies processing notifications from multiple channels
3. Setups a timeout for receiving a notification
4. Allows to receive all notifications/only last notification depends on ListenPolicy.

import asyncio
import aiopg
import aiopg_listen


async def handle_notifications(notification: aiopg_listen.NotificationOrTimeout) -> None:
    print(f"{notification} has been received")


consumer = aiopg_listen.NotificationListener(aiopg_listen.connect_func())
consume_task = asyncio.create_task(
    consumer.run(
        {"channel": handle_notifications},
        policy=aiopg_listen.ListenPolicy.LAST,
        notification_timeout=1
    )
)

async with aiopg.connect() as connection, connection.cursor() as cursor:
    for i in range(42):
        await cursor.execute(f"NOTIFY simple, '{i}'")

v0.0.2 (2021-07-25)

• Add aiopg_listen.connect_func to simplify initialization #5
• Rename consumer to listener #6
• Do not crash if handler fails #7

v0.0.1 (2021-07-25)

• A first version