Configure the world before it starts

Prerequisites: world boundaries and dynamic linking. A frame's posture decides which kinds of runtime operations its books may perform. Configure it before the first conjure settles the world.

The public-door lesson calls book.configure_aether_frame(system_state="dynamic", ...) before conjure. A second book in that named frame uses plain conjure(); the example then links the two roots to demonstrate inherited dynamic posture. Reconfiguration after freeze is shown as a refusal.

Keep the configuration objects distinct

Object	Responsibility
`SpellbookConfiguration`	Book policy, including disposal and scheduler choices
`AethericFrameConfiguration`	World posture and eligibility for runtime operations
`AetherConfiguration`	Root policy, including automatic logging setup

The configuration-object and root-builder lessons walk their complete setup sequences. Follow the terminator for the object you hold; constructing a configuration is not the same as activating the corresponding subsystem.

Continue to logging for the explicit post-boot attachment path.

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:
    # A named world, postured dynamic through the PUBLIC door -
    # before any conjure has settled anything.
    book = md.Spellbook(aetheric_frame="ops-world")
    book.bind(spell=OpsService, existence="unique")
    book.configure_aether_frame(system_state="dynamic", disposal=None,
                                disposal_method_names=None)

    # Plain conjures INHERIT the configured posture - no flags.
    root = book.conjure(name="ops-root")
    peer = md.Spellbook(aetheric_frame="ops-world").conjure(name="ops-peer")
    assert root.link(peer) is True
    print("configured world: plain conjures inherited dynamic and linked")

    # The mode is decided ONCE. After the first conjure froze the
    # posture, reconfiguring the world refuses.
    try:
        book.configure_aether_frame(system_state="automatic", disposal=None,
                                    disposal_method_names=None)
        print("post-freeze reconfigure unexpectedly succeeded")
    except Exception as err:
        print("post-freeze reconfigure refused:", type(err).__name__)

Runnable examples

Frame posture public door — Advanced 03
Frame posture cheatsheet — Advanced 05
Frame posture object — Advanced 06
Aether config two doors — Advanced 07

All advanced examples · Level contents · Full contents

Canonical page source