Files
MeanField/reports/build_report.py

68 lines
2.8 KiB
Python
Raw Normal View History

#!/usr/bin/env python3
"""Build the handoff's Markdown with Pandoc and its PDF with LaTeX.
The LaTeX is authoritative. Generated Markdown is deliberately not post-edited,
so a reader can regenerate both delivery formats from the same research record.
"""
from pathlib import Path
import argparse
import hashlib
import json
import shutil
import subprocess
import sys
import time
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--markdown-only', action='store_true')
args = parser.parse_args()
reports = Path(__file__).resolve().parent
stem = 'MeanField_research_handoff_2026-09-20'
source = reports / (stem + '.tex')
build = reports.parent / 'working/report_builds/research_handoff'
build.mkdir(parents=True, exist_ok=True)
commands = [[
'pandoc', '--from=latex', '--to=gfm-tex_math_gfm+tex_math_dollars', '--standalone',
'--toc', '--toc-depth=2', '--lua-filter=pandoc_tables.lua',
'--wrap=none', '--output=' + stem + '.md', source.name,
], [sys.executable, 'check_report_conversion.py',
'--output', str(build / 'conversion_audit.json')]]
if not args.markdown_only:
commands.append([
'latexmk', '-pdf', '-interaction=nonstopmode', '-halt-on-error',
'-outdir=' + str(build), source.name,
])
record = {'source_sha256': hashlib.sha256(source.read_bytes()).hexdigest(),
'commands': [], 'outputs': {}}
for index, command in enumerate(commands):
executable = shutil.which(command[0])
if executable is None:
raise SystemExit(f'Required program is unavailable: {command[0]}')
command[0] = executable
start = time.monotonic()
log = build / f'build_{index}.log'
with log.open('w') as stream:
result = subprocess.run(command, cwd=reports, stdout=stream,
stderr=subprocess.STDOUT)
record['commands'].append({'command': command, 'returncode': result.returncode,
'seconds': time.monotonic() - start})
(build / 'build_manifest.json').write_text(json.dumps(record, indent=2) + '\n')
if result.returncode:
raise SystemExit(f'Report build failed; inspect {log}')
if not args.markdown_only:
shutil.copy2(build / (stem + '.pdf'), reports / (stem + '.pdf'))
for suffix in ['.tex', '.md'] + ([] if args.markdown_only else ['.pdf']):
path = reports / (stem + suffix)
record['outputs'][path.name] = {
'sha256': hashlib.sha256(path.read_bytes()).hexdigest(),
'bytes': path.stat().st_size,
}
(build / 'build_manifest.json').write_text(json.dumps(record, indent=2) + '\n')
print('Generated ' + ', '.join(record['outputs']))
if __name__ == '__main__':
main()