shmup/mud
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add step() method to ZCpu for async MUD integration

Browse source 
Extracts the run loop body into step() which executes one instruction
and returns True/False for continue/halt. run() now delegates to step().
This commit is contained in:
Jared Miller 2026-02-09 20:59:03 -05:00
parent fb8cbf7219
commit d218929f02
Signed by: shmup
GPG key ID: 22B5C6D66A38B06C
1 changed files with 24 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
src/mudlib/zmachine/zcpu.py
View file

@ -168,16 +168,11 @@ class ZCpu:
log(f"Jump to offset {branch_offset:+d}") log(f"Jump to offset {branch_offset:+d}")
self._opdecoder.program_counter += branch_offset - 2 self._opdecoder.program_counter += branch_offset - 2
def run(self): def step(self):
"""The Magic Function that takes little bits and bytes, twirls """Execute a single instruction. Returns True if execution should continue."""
them around, and brings the magic to your screen!"""
log("Execution started")
while True:
current_pc = self._opdecoder.program_counter current_pc = self._opdecoder.program_counter
log(f"Reading next opcode at address {current_pc:x}") log(f"Reading next opcode at address {current_pc:x}")
(opcode_class, opcode_number, operands) = ( (opcode_class, opcode_number, operands) = self._opdecoder.get_next_instruction()
self._opdecoder.get_next_instruction()
)
implemented, func = self._get_handler(opcode_class, opcode_number) implemented, func = self._get_handler(opcode_class, opcode_number)
log_disasm( log_disasm(
current_pc, current_pc,
@ -188,11 +183,19 @@ class ZCpu:
) )
if not implemented: if not implemented:
log(f"Unimplemented opcode {func.__name__}, halting execution") log(f"Unimplemented opcode {func.__name__}, halting execution")
break return False
# The returned function is unbound, so we must pass # The returned function is unbound, so we must pass
# self to it ourselves. # self to it ourselves.
func(self, *operands) func(self, *operands)
return True
def run(self):
"""The Magic Function that takes little bits and bytes, twirls
them around, and brings the magic to your screen!"""
log("Execution started")
while self.step():
pass
## ##
## Opcode implementation functions start here. ## Opcode implementation functions start here.