wsocket-io 0.1.0

wSocket Realtime Pub/Sub SDK for Python

wSocket Python SDK

Official Python SDK for wSocket — Realtime Pub/Sub over WebSockets.

Installation

pip install wsocket-io

Quick Start

import asyncio
from wsocket import create_client

async def main():
    client = create_client("wss://your-server.com", "your-api-key")
    await client.connect()

    chat = client.channel("chat:general")

    @chat.on_message
    def handle(data, meta):
        print(f"[{meta.channel}] {data}")

    chat.subscribe()
    chat.publish({"text": "Hello from Python!"})

    await asyncio.sleep(5)
    await client.disconnect()

asyncio.run(main())

Features

• Pub/Sub — Subscribe and publish to channels in real-time
• Presence — Track who is online in a channel
• History — Retrieve past messages
• Connection Recovery — Automatic reconnection with message replay
• Async/Await — Built on asyncio and websockets

Presence

chat = client.channel("chat:general")

@chat.presence.on_enter
def user_joined(member):
    print(f"Joined: {member.client_id}")

@chat.presence.on_leave
def user_left(member):
    print(f"Left: {member.client_id}")

chat.presence.enter({"name": "Alice"})
members = chat.presence.get()

History

@chat.on_history
def handle_history(result):
    for msg in result.messages:
        print(f"[{msg['timestamp']}] {msg['data']}")

chat.history(limit=50)

Requirements

• Python >= 3.9
• websockets >= 12.0

Development

pip install -e ".[dev]"
pytest

License

MIT