aiocometd 0.3.0

CometD client for asyncio

aiocometd

aiocometd is a CometD client built using asyncio, implementing the Bayeux protocol.

CometD is a scalable WebSocket and HTTP based event and message routing bus. CometD makes use of WebSocket and HTTP push technologies known as Comet to provide low-latency data from the server to browsers and client applications.

Features

• Supported transports:

  • long-polling

  • websocket

• Automatic reconnection after network failures

• Extensions

Usage

import asyncio

from aiocometd import Client

async def chat():
    nickname = "John"

    # connect to the server
    async with Client("http://example.com/cometd") as client:

            # subscribe to channels to receive chat messages and
            # notifications about new members
            await client.subscribe("/chat/demo")
            await client.subscribe("/members/demo")

            # send initial message
            await client.publish("/chat/demo", {
                "user": nickname,
                "membership": "join",
                "chat": nickname + " has joined"
            })
            # add the user to the chat room's members
            await client.publish("/service/members", {
                "user": nickname,
                "room": "/chat/demo"
            })

            # listen for incoming messages
            async for message in client:
                if message["channel"] == "/chat/demo":
                    data = message["data"]
                    print(f"{data['user']}: {data['chat']}")

if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    loop.run_until_complete(chat())

Changelog

0.3.0 (2018-05-04)

• Enable the usage of third party JSON libraries

• Fix detection and recovery from network failures

0.2.3 (2018-04-24)

• Fix RST rendering issues

0.2.2 (2018-04-24)

• Fix documentation typos

• Improve examples

• Reorganise documentation

0.2.1 (2018-04-21)

• Add PyPI badge to README

0.2.0 (2018-04-21)

• Supported transports:

  • long-polling

  • websocket

• Automatic reconnection after network failures

• Extensions