transports 0.3.0

Generic communication library

transports

Move typed models across any wire.

Define a model once — as a pydantic model, a stdlib dataclass, or a msgspec struct — host it, and its mutations stream to peers as incremental patches (not whole-model resends), over a WebSocket, in JSON or MessagePack. A Rust core (model representation, diff/patch, codecs, framing) compiles to Python (PyO3) and JavaScript (wasm), so both ends share one implementation.

import transports
from pydantic import BaseModel

class Device(BaseModel):
    name: str
    on: bool = False

session = transports.Session()
lamp = Device(name="lamp")
session.host(lamp)

lamp.on = True                       # just mutate the model...
for model_id, patch in session.drain():
    print(patch)
    # {'rev': 1, 'ops': [{'Set': {'path': [{'Key': 'on'}], 'value': {'Bool': True}}}]}

Install

pip install transports
pip install "transports[connections]"   # adds the WebSocket server/client adapters

What you get

• Reactive models — mutate a field, get the minimal patch. No manual diffing or send().
• Three model kinds, one contract — pydantic, dataclass, and msgspec all bridge to the same core.
• One core, two languages — Python and JavaScript share the Rust diff/patch and codecs, so a patch produced on one side applies on the other.
• Live sync over WebSocket — host a model on a server and mirror it in the browser; mutate it in Python and the page updates. See Connections.
• JSON or MessagePack — swap the wire format without touching your models. See Codecs.

Documentation

Quickstart · Concepts · Model bridges · Connections · Codecs · API reference