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

Add smoke test script for running Zork 1 through hybrid interpreter

Browse source 
Loads zork1.z3, creates ZMachine with TrivialZUI, and runs
interactively with graceful error handling for unimplemented opcodes.
This commit is contained in:
Jared Miller 2026-02-09 20:59:07 -05:00
parent d218929f02
commit e0e2e84dc2
Signed by: shmup
GPG key ID: 22B5C6D66A38B06C
1 changed files with 103 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

103
scripts/run_zork1.py Executable file
View file

@ -0,0 +1,103 @@
#!/usr/bin/env -S uv run --script
"""Smoke test for hybrid z-machine interpreter with Zork 1."""
import sys
import traceback
from pathlib import Path
def main():
# Add src to path so we can import mudlib
project_root = Path(__file__).parent.parent
sys.path.insert(0, str(project_root / "src"))
from mudlib.zmachine import ZMachine
from mudlib.zmachine.trivialzui import create_zui
from mudlib.zmachine.zcpu import (
ZCpuError,
ZCpuNotImplemented,
ZCpuQuit,
ZCpuRestart,
)
print("=" * 60)
print("Z-Machine Interpreter Test: Zork 1")
print("=" * 60)
print()
print("Loading story file: content/stories/zork1.z3")
story_path = project_root / "content" / "stories" / "zork1.z3"
if not story_path.exists():
print(f"ERROR: Story file not found at {story_path}")
sys.exit(1)
with open(story_path, "rb") as f:
story_bytes = f.read()
print(f"Loaded {len(story_bytes)} bytes")
print()
print("Creating ZUI and ZMachine instance...")
ui = create_zui()
zmachine = ZMachine(story_bytes, ui, debugmode=False)
print("Starting interpreter...")
print("(Press Ctrl+C to exit)")
print()
print("-" * 60)
print()
try:
zmachine.run()
print()
print("-" * 60)
print("Interpreter exited normally.")
except ZCpuQuit:
print()
print("-" * 60)
print("Game quit via QUIT opcode.")
except ZCpuRestart:
print()
print("-" * 60)
print("Game requested restart via RESTART opcode.")
print("(Restart not implemented in this test script)")
except ZCpuNotImplemented as e:
print()
print("-" * 60)
print("FAILED: Unimplemented opcode encountered")
print(f"Error: {e}")
print()
traceback.print_exc()
sys.exit(1)
except ZCpuError as e:
print()
print("-" * 60)
print("FAILED: Z-Machine CPU error")
print(f"Error: {e}")
print()
traceback.print_exc()
sys.exit(1)
except KeyboardInterrupt:
print()
print()
print("-" * 60)
print("Interrupted by user (Ctrl+C)")
except Exception as e:
print()
print("-" * 60)
print("FAILED: Unexpected error")
print(f"Error: {e}")
print()
traceback.print_exc()
sys.exit(1)
if __name__ == "__main__":
main()