43887931cc
This commit includes the complete implementation of the GlyphRunner system:
SUBSYSTEMS CREATED:
1. xic_extensions (5 modules)
- gsz3_decompressor: Compression/decompression with checksum validation
- segment_runtime: Multi-segment execution with namespace merging
- execution_tracer: Execution tracing with event capture
- profiler: Lightweight segment profiling (duration, memory, counts)
- compressed_engine: High-level orchestration (simulate/execute modes)
2. gx_compiler (5 modules)
- segmenter: Deterministic source code segmentation
- compressor: GSZ3 compression wrapper
- manifest_builder: XIC/GX manifest generation
- gx_packer: Binary .gx file format (XIC header + manifest + payload)
- compiler: High-level compilation pipeline
3. runtime_executor (6 modules)
- gx_loader: .gx file loading and parsing
- execution_plan: Execution plan building from manifest
- context: Runtime execution context management
- runner: Core execution engine with tracing/profiling
- events: Runtime event system and event bus
- integration: High-level API (run_gx_with_summary)
4. gx_cli (5 modules)
- commands: Command implementations (compile, run, inspect, summary)
- parser: argparse-based argument parsing
- dispatcher: Command routing and execution
- main: CLI entry point with exception handling
5. codex_lineage (6 modules)
- lineage_model: Data structures (EpochInfo, ContributorInfo, etc.)
- epoch_mapper: Version string parsing (v1, v2.5-beta, etc.)
- contributor_index: In-memory contributor registry
- lineage_resolver: Manifest → CodexEntry resolution
- grammar_hooks: Human-readable report generation
- inspector: High-level .gx file inspection utility
INTEGRATION TESTS (7 test files)
- test_compile: Compilation pipeline tests
- test_run: Execution verification tests
- test_inspect: Inspection and manifest tests
- test_summary: Summary generation tests
- test_errors: Error handling and graceful failure
- test_determinism: Reproducibility and determinism
- run_all_tests: Master test runner
ARCHITECTURE HIGHLIGHTS:
✓ Zero circular imports
✓ Pure functions where possible
✓ Explicit error handling
✓ No global side effects
✓ Only stdlib dependencies
✓ Deterministic output
✓ Production-ready code
PIPELINE:
sample.py → [gx_compiler] → sample.gx (960 bytes, XIC format)
→ [runtime_executor] → Execution (6 segments)
→ [codex_lineage] → Human-readable lineage report
CLI COMMANDS:
gx compile <source.py> [-o output.gx]
gx run <file.gx>
gx inspect <file.gx>
gx summary <file.gx>
VERIFICATION:
✓ All 5 subsystems created and tested
✓ Full pipeline: compile → inspect → execute
✓ Codex lineage fully integrated with gx_cli
✓ 25+ integration test cases
✓ End-to-end testing successful
✓ No external dependencies beyond Python stdlib
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
135 lines
3.3 KiB
Python
135 lines
3.3 KiB
Python
#!/usr/bin/env python3
|
|
import sys
|
|
import io
|
|
import contextlib
|
|
from pathlib import Path
|
|
|
|
sys.path.insert(0, str(Path.cwd()))
|
|
|
|
from gx_cli.main import main
|
|
|
|
|
|
def test_inspect_basic():
|
|
"""Test inspecting a .gx file"""
|
|
gx_path = Path("/tmp/test_inspect_basic.gx")
|
|
|
|
# Compile
|
|
compile_code = main(["compile", "/home/dave/sample_code.py", "-o", str(gx_path)])
|
|
if compile_code != 0:
|
|
print("FAIL: compilation failed")
|
|
return False
|
|
|
|
# Inspect
|
|
f = io.StringIO()
|
|
with contextlib.redirect_stdout(f):
|
|
exit_code = main(["inspect", str(gx_path)])
|
|
|
|
output = f.getvalue()
|
|
|
|
if exit_code != 0:
|
|
print("FAIL: inspect returned non-zero")
|
|
return False
|
|
|
|
# Verify output contains expected sections
|
|
if "[Manifest]" not in output:
|
|
print("FAIL: missing [Manifest] section")
|
|
return False
|
|
|
|
if "[Segments]" not in output:
|
|
print("FAIL: missing [Segments] section")
|
|
return False
|
|
|
|
if "[Payload]" not in output:
|
|
print("FAIL: missing [Payload] section")
|
|
return False
|
|
|
|
print("PASS: Inspect shows manifest, segments, and payload")
|
|
return True
|
|
|
|
|
|
def test_inspect_manifest_fields():
|
|
"""Test that manifest contains expected fields"""
|
|
gx_path = Path("/tmp/test_manifest_fields.gx")
|
|
|
|
# Compile
|
|
main(["compile", "/home/dave/sample_code.py", "-o", str(gx_path)])
|
|
|
|
# Inspect and capture output
|
|
f = io.StringIO()
|
|
with contextlib.redirect_stdout(f):
|
|
main(["inspect", str(gx_path)])
|
|
|
|
output = f.getvalue()
|
|
|
|
# Check for key manifest fields
|
|
required_fields = ["version", "origin", "source_file", "source_type", "compression_model", "contributor"]
|
|
for field in required_fields:
|
|
if field not in output:
|
|
print(f"FAIL: missing manifest field: {field}")
|
|
return False
|
|
|
|
print("PASS: Manifest contains all required fields")
|
|
return True
|
|
|
|
|
|
def test_inspect_segments():
|
|
"""Test that segments are listed correctly"""
|
|
gx_path = Path("/tmp/test_segments.gx")
|
|
|
|
# Compile
|
|
main(["compile", "/home/dave/sample_code.py", "-o", str(gx_path)])
|
|
|
|
# Inspect
|
|
f = io.StringIO()
|
|
with contextlib.redirect_stdout(f):
|
|
main(["inspect", str(gx_path)])
|
|
|
|
output = f.getvalue()
|
|
|
|
# Should have segment entries
|
|
if "seg_0:" not in output:
|
|
print("FAIL: segment seg_0 not found")
|
|
return False
|
|
|
|
# Should show line ranges
|
|
if "lines" not in output:
|
|
print("FAIL: segment line ranges not shown")
|
|
return False
|
|
|
|
print("PASS: Segments listed with line ranges")
|
|
return True
|
|
|
|
|
|
def main_test():
|
|
print("[TEST SUITE] test_inspect.py")
|
|
print()
|
|
|
|
tests = [
|
|
("Basic inspect", test_inspect_basic),
|
|
("Manifest fields", test_inspect_manifest_fields),
|
|
("Segments listing", test_inspect_segments),
|
|
]
|
|
|
|
passed = 0
|
|
failed = 0
|
|
|
|
for name, test_func in tests:
|
|
print(f"Running: {name}...", end=" ")
|
|
try:
|
|
if test_func():
|
|
passed += 1
|
|
else:
|
|
failed += 1
|
|
except Exception as e:
|
|
print(f"FAIL: {e}")
|
|
failed += 1
|
|
|
|
print()
|
|
print(f"Results: {passed} passed, {failed} failed")
|
|
|
|
return 0 if failed == 0 else 1
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main_test())
|