Files
horizon-airdef/tools/profile_client_startup.py
T
2026-10-17 01:03:21 +01:00

50 lines
2.1 KiB
Python

#!/usr/bin/env python3
"""Measure the resource-dependent Behaviours::load portion of client startup.
Build the behaviour_load_profile example in the checkout to be measured first:
cargo build --release -p horizon-world --example behaviour_load_profile
Run the profiler from the repository root with the matching example binary.
This measures behaviour loading, not time to first rendered frame.
"""
import argparse
import json
import re
import statistics
import subprocess
from pathlib import Path
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--binary", type=Path, default=Path("target/release/examples/behaviour_load_profile"))
parser.add_argument("--resources", type=Path, default=Path(".local/horizon-client/26.3"))
parser.add_argument("--repeats", type=int, default=5)
parser.add_argument("--output", type=Path)
args = parser.parse_args()
if args.repeats < 1:
parser.error("--repeats must be at least one")
samples = []
for _ in range(args.repeats):
run = subprocess.run([str(args.binary.resolve()), str(args.resources.resolve())],
text=True, capture_output=True, check=True)
values = {key: float(value) for key, value in
re.findall(r"^(registry_ms|behaviours_[0-2]_ms)=([\d.]+)$", run.stderr, re.M)}
if len(values) != 4:
raise RuntimeError(f"incomplete profile output: {run.stderr}")
samples.append(values)
summary = {key: {"median_ms": round(statistics.median(row[key] for row in samples), 3),
"samples_ms": [row[key] for row in samples]}
for key in samples[0]}
result = {"scope": "behaviour loader only; not full client startup",
"binary": str(args.binary), "resources": str(args.resources), "repeats": args.repeats,
"metrics": summary}
print(json.dumps(result, indent=2))
if args.output:
args.output.parent.mkdir(parents=True, exist_ok=True)
args.output.write_text(json.dumps(result, indent=2) + "\n")
if __name__ == "__main__":
main()