Enable Nexus and open a Rift

Prerequisite: world posture. Nexus hosts the public room surface. The two saved setup lessons give a complete activation path and separate the process-wide Nexus configuration from the configuration consumed by one Rift.

Configuration is not liveness

The Nexus factory returns a fresh, defaulted configuration. nexus.activate(config) installs and finalizes it. The lesson checks is_configured and is_activated separately, including after deactivation.

For a Rift, create a new configuration, choose its space type and name, then pass it to create_rift(...). That configuration is consumed: a second Rift needs a second configuration object. Registration and active state are distinct; the opening lesson explicitly marks the Rift active and inactive.

Choose the room for the job

Start with a static room for inspection. A newly opened Rift has no assigned frames. Opening a room and attaching it to an eligible target are separate operations. The inspection walkthrough connects the setup to a real target.

The Rift owns its room. Give the application ownership of the Rift's lifetime and clean it up when the inspection session ends.

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:
    nexus = md.Nexus()

    # A rift needs a live nexus underneath it - lesson 08's ladder.
    system_config = nexus.create_configuration()
    system_config.with_rift_creation_enabled(True)
    nexus.activate(system_config)
    assert nexus.is_activated is True
    print("nexus enabled; rift creation permitted")

    # The per-rift configuration is its own object with its own factory.
    # Note the shape is identical to every other config in melder: with_*
    # verbs that mutate and return self, ending in a terminator.
    rift_config = nexus.create_rift_configuration()
    assert isinstance(rift_config, md.RiftConfiguration)
    rift_config.with_space_type("static")
    rift_config.with_space_name("health")
    print("rift configuration staged: static room named 'health'")

    # create_rift finalizes the configuration on the way through - the same
    # courtesy Nexus.activate() extended in lesson 08, and still the opposite
    # of what Aether does.
    rift = nexus.create_rift(configuration=rift_config, rift_name="ops")
    assert isinstance(rift, md.Rift)
    print("rift opened:", rift.rift_name, "| id:", rift.id)

    # ONE CONFIGURATION, ONE RIFT. The object was consumed by the call.
    try:
        nexus.create_rift(configuration=rift_config, rift_name="ops-again")
        raise AssertionError("expected ValueError: configuration consumed")
    except ValueError as error:
        print("second use refused:", error)

    # THE TWO BITS, third appearance. Creation registered it; being
    # registered is not the same as being live.
    assert rift.is_registered is True
    print("after create - registered:", rift.is_registered,
          "active:", rift.is_active)

    rift.mark_active()
    assert rift.is_active is True
    print("after mark_active - registered:", rift.is_registered,
          "active:", rift.is_active)

    rift.mark_inactive()
    assert rift.is_active is False
    assert rift.is_registered is True, "liveness went; registration stayed"
    print("after mark_inactive - registered:", rift.is_registered,
          "active:", rift.is_active)

    # The rift owns a concrete room and a gate. The room's kind came from
    # the configuration; the gate is the entry control (lesson 10 uses it).
    assert rift.space is not None
    assert rift.rift_gate is not None
    print("room:", type(rift.space).__name__,
          "| gate:", type(rift.rift_gate).__name__)

    # Nexus is the registry - the rift can be found by id and by name.
    assert nexus.has_rift(rift.id) is True
    assert rift.id in nexus.list_rift_ids()
    print("registered with nexus; rift ids:", len(nexus.list_rift_ids()))

    print()
    print("one configuration, one rift - create_rift consumes it")
    print("presence and liveness are ALWAYS two bits, whatever they are named")

Runnable examples

Opening a rift — Advanced 09
Nexus enablement — Advanced 08
The room and its fixtures — Advanced 10
Static vs capability authority — Advanced 11

All advanced examples · Level contents · Full contents

Canonical page source