Named conduits, ownership transfer, and severing

Prerequisite: links and permissions. Names make dynamic conduits discoverable through their frame's cloud. They also make a useful application vocabulary: platform, services, and workflows can identify independently owned parts of a system.

Find the owner

The cloud lessons show lookup of already-created named conduits. Choose a distinct name for each root in the same frame. A fresh root still comes from a fresh book; lookup does not create a second root for an existing book.

Transfer stewardship

transfer_spell_ownership(...) moves stewardship to the target conduit and returns a report. The saved lesson requests move_creations=True, inspects the report, and resolves from the new home. Read that report when diagnosing a transfer; sharing and moving ownership have different lifecycle consequences.

End the relationship

sever_link(...) removes the relationship and the contracts carried by it. The sever lesson attempts another borrower meld, then checks the owner's live object. This distinguishes the borrower's resolution rights from the owner's retained creation. Application references you already hold still need their own lifecycle policy.

Finish with the connected-subsystem walkthrough.

The workflow in code

These are the core steps from the saved example. Use its complete linked script for all class definitions and setup.

def main() -> None:
    source_book = dynamic_spellbook()
    spell_id = source_book.bind(spell=MigratingService, existence="unique")
    source = source_book.conjure(dynamic=True, name="old-home")
    target = dynamic_spellbook().conjure(dynamic=True, name="new-home")
    source.link(target)

    report = source.transfer_spell_ownership(
        spell=spell_id, target_conduit=target, move_creations=True,
    )

    # THE PREFLIGHT SUMMARY IS THE POINT. Ownership moving is not a silent
    # side effect - it hands back an auditable report of what it did.
    assert isinstance(report, dict) and report, report
    print("transfer report keys:", sorted(report))

    # THE NEW HOME CAN MELD IT.
    moved = target.meld(spell=MigratingService)
    assert isinstance(moved, MigratingService)
    print("new home melds it:", type(moved).__name__)

    # AND THE OLD HOME CANNOT. This is the assertion that makes it a
    # TRANSFER rather than a share - if the source could still meld it,
    # ownership would have been copied, not moved.
    try:
        source.meld(spell=MigratingService)
        raise AssertionError(
            "the source still melds it - that is sharing, not transfer"
        )
    except Exception as gone:
        print("old home refused -", type(gone).__name__, ":",
              str(gone)[:70])
        print("  stewardship MOVED. A copy would have left both able to")
        print("  meld, and then `ownership` would mean nothing")

Runnable examples

Transfer of ownership — Intermediate 23
Conduit cloud — Intermediate 24
Sever link — Intermediate 27
The frame conduit cloud — Intermediate 37

All intermediate examples · Level contents · Full contents

Canonical page source