Context Cages¶

Cage gives you context-local mutable views over shared state.

Context Behavior¶

flowchart LR
    A["Original object"] --> B["ContextVar snapshot"]
    B --> C["Task A override"]
    B --> D["Task B override"]
    C --> E["Task A view"]
    D --> F["Task B view"]

Why It Matters¶

• Isolates mutable behavior across async tasks and nested contexts.
• Supports update merge functions for controlled state synchronization.
• Supports optional lock wrapper for thread-safe original updates.

Related¶

• Reference: cages
• Guide: testing with overrides