Method execute

xqvm_py/executor.py:221–257

Execute a program to completion. Args: program: The program to execute input_data: Optional input data keyed by slot number step_limit: Maximum steps before raising RuntimeError (0 = unlimited) Returns: Output data keyed by s

(
        self,
        program: Program,
        input_data: dict[int, Any] | None = None,
        step_limit: int = 0,
    )

        }

    def execute(
        self,
        program: Program,
        input_data: dict[int, Any] | None = None,
        step_limit: int = 0,
    ) -> dict[int, Any]:
        """
        Execute a program to completion.

        Args:
            program: The program to execute
            input_data: Optional input data keyed by slot number
            step_limit: Maximum steps before raising RuntimeError (0 = unlimited)

        Returns:
            Output data keyed by slot number

        Raises:
            XQVMError: On execution errors
        """
        self.state.reset()
        self.program = program

        if input_data:
            for slot, value in input_data.items():
                self.state.set_input(slot, value)

        for target_id, pc in program.jump_targets.items():
            self.state.jc.define_target(target_id, pc)

        while not self.state.halted and self.state.pc < len(program):
            if step_limit > 0 and self.state.steps >= step_limit:
                raise RuntimeError(f"StepLimitExceeded: execution exceeded {step_limit} steps")
            self.state.steps += 1
            self.step()

        return dict(self.state.output)

    @property
    def steps(self) -> int: