Test: Isolate generated docs and settings fixtures

This commit is contained in:
Gabriel Brown
2026-08-26 22:59:28 -04:00
parent 68b6664111
commit 3839183401
3 changed files with 73 additions and 24 deletions
@@ -264,7 +264,14 @@ def main():
parser = argparse.ArgumentParser()
parser.add_argument("--check", action="store_true")
parser.add_argument("--stdout", action="store_true")
parser.add_argument("--output", type=pathlib.Path, default=OUTPUT)
args = parser.parse_args()
output = (args.output if args.output.is_absolute()
else (pathlib.Path.cwd() / args.output).resolve())
try:
displayed_output = output.relative_to(ROOT)
except ValueError:
displayed_output = output
try:
rendered = render(read_entries(), read_routes(), read_titles())
@@ -279,19 +286,19 @@ def main():
return 0
if args.check:
if not OUTPUT.exists():
print("panama-settings-docs: docs/settings.md has never been generated",
if not output.exists():
print(f"panama-settings-docs: {displayed_output} has never been generated",
file=sys.stderr)
return 1
if OUTPUT.read_text() != rendered:
print("panama-settings-docs: docs/settings.md is stale; re-run this "
if output.read_text() != rendered:
print(f"panama-settings-docs: {displayed_output} is stale; re-run this "
"script and commit the result", file=sys.stderr)
return 1
return 0
OUTPUT.parent.mkdir(parents=True, exist_ok=True)
OUTPUT.write_text(rendered)
print(f"wrote {OUTPUT.relative_to(ROOT)}")
output.parent.mkdir(parents=True, exist_ok=True)
output.write_text(rendered)
print(f"wrote {displayed_output}")
return 0