Function program_from_xqasm

xqvm_py/program.py:163–180

Parse ``.xqasm`` source via the Rust xqasm crate and wrap the result. This is the single entry point xqvm-py uses to turn assembly text into an executable ``Program``. The actual parsing + assembly is done by ``xqffi.asm.parse_xqasm`` (a pyo3 binding to Rust ``xqasm``); this helper

(source: str, name: str = "")

def program_from_xqasm(source: str, name: str = "") -> Program:
    """Parse ``.xqasm`` source via the Rust xqasm crate and wrap the result.

    This is the single entry point xqvm-py uses to turn assembly text
    into an executable ``Program``. The actual parsing + assembly is
    done by ``xqffi.asm.parse_xqasm`` (a pyo3 binding to Rust
    ``xqasm``); this helper just adapts the wire dict into the Python
    dataclass layout the executor expects.

    The ``program_from_xqasm`` / ``Instruction`` / ``Program`` trio
    replaces what used to be ``xqvm.assembler.assemble(src).program``
    — xqvm-py no longer ships its own assembler.
    """
    from xqffi.asm import parse_xqasm

    wire = parse_xqasm(source)
    instructions = [Instruction(Opcode.from_code(code), tuple(ops), int(pc)) for code, ops, pc in wire["instructions"]]
    return Program(instructions=instructions, name=name, jump_targets=_build_jump_targets(instructions))