tractor/docs/guide/index.rst

Guides

Task-focused walkthroughs of every major tractor subsystem, each built around real, test-suite verified example scripts from the repo's examples/ dir (we never copy-paste code into docs; what you read is what CI runs).

Roughly in "first date to long term relationship" order,

• spawning — actor nurseries, daemons + one-shot workers, process lifetimes.
• rpc — portals: calling into another process like it's a local await.
• context — the cross-actor task-pair primitive at the heart of modern tractor.
• streaming — one-way and bidirectional msg streams between actors.
• cancellation — supervision, error boxing + propagation, teardown discipline.
• debugging — the multi-process native REPL debugger; our flagship DX feature B)
• discovery — the registrar, finding actors by name, service patterns.
• clustering — quick flat process clusters via one async with.
• parallelism — worker pools without pools; a concurrent.futures re-think.
• asyncio — "infected asyncio" mode: SC-supervise asyncio tasks from trio.
• msging — typed IPC payloads, the wire msg-spec and custom codecs.
• testing — running + monitoring the test suite (and testing your own actor apps).

spawning rpc context streaming cancellation debugging discovery clustering parallelism asyncio msging testing