reportist/tests/test_render.py

146 lines
6.7 KiB
Python

import importlib.util
import json
from pathlib import Path
import shutil
import subprocess
import sys
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[1]
spec = importlib.util.spec_from_file_location("reportist_render", ROOT / "tests" / "support_render.py")
renderer = importlib.util.module_from_spec(spec)
spec.loader.exec_module(renderer)
TYPST = shutil.which("typst")
PDFINFO = shutil.which("pdfinfo")
PDFTOTEXT = shutil.which("pdftotext")
@unittest.skipUnless(TYPST, "Typst is not installed")
class RenderTests(unittest.TestCase):
def setUp(self):
self.temporary = tempfile.TemporaryDirectory()
self.work = Path(self.temporary.name)
def tearDown(self):
self.temporary.cleanup()
def assert_pdf(self, path):
self.assertTrue(path.read_bytes().startswith(b"%PDF-"))
self.assertGreater(path.stat().st_size, 1000)
def test_yaml_and_json_examples_render(self):
for example in ("example-report.yaml", "example-report.json"):
with self.subTest(example=example):
output = self.work / f"{example}.pdf"
renderer.render(ROOT / "examples" / example, output, TYPST)
self.assert_pdf(output)
def test_minimal_report_renders_without_optional_fields(self):
output = self.work / "minimal.pdf"
renderer.render(ROOT / "examples" / "minimal-report.json", output, TYPST)
self.assert_pdf(output)
def test_invalid_input_leaves_no_pdf(self):
report = self.work / "invalid.json"
report.write_text(json.dumps({"schema_version": 2}), encoding="utf-8")
output = self.work / "invalid.pdf"
with self.assertRaisesRegex(ValueError, "invalid report"):
renderer.render(report, output, TYPST)
self.assertFalse(output.exists())
def test_replaceable_branding_logo_renders(self):
(self.work / "assets").mkdir()
(self.work / "assets" / "logo.svg").write_text(
'<svg xmlns="http://www.w3.org/2000/svg" width="80" height="24">'
'<rect width="80" height="24" fill="#663399"/></svg>', encoding="utf-8")
report = {"schema_version": 1, "title": "Alternate Brand", "metadata": {
"Date": "2026-09-15", "Author": "Synthetic Author"}, "branding": {
"organization": "Unrelated Example", "logo": "assets/logo.svg",
"theme": {"accent": "#663399"}}}
input_path = self.work / "brand.json"
input_path.write_text(json.dumps(report), encoding="utf-8")
output = self.work / "brand.pdf"
renderer.render(input_path, output, TYPST)
self.assert_pdf(output)
def test_existing_output_requires_force_and_input_is_never_output(self):
input_path = ROOT / "examples" / "minimal-report.json"
output = self.work / "report.pdf"
output.write_bytes(b"existing")
with self.assertRaisesRegex(ValueError, "output exists"):
renderer.render(input_path, output, TYPST)
self.assertEqual(output.read_bytes(), b"existing")
renderer.render(input_path, output, TYPST, force=True)
self.assert_pdf(output)
with self.assertRaisesRegex(ValueError, "must differ"):
renderer.render(input_path, input_path, TYPST, force=True)
def test_logo_symlink_is_rejected(self):
outside = self.work / "outside.svg"
outside.write_text('<svg xmlns="http://www.w3.org/2000/svg"/>', encoding="utf-8")
report_dir = self.work / "report"
report_dir.mkdir()
(report_dir / "logo.svg").symlink_to(outside)
report = {"schema_version": 1, "title": "Unsafe asset", "metadata": {
"Date": "2026-09-15", "Author": "Synthetic Author"},
"branding": {"logo": "logo.svg"}}
input_path = report_dir / "report.json"
input_path.write_text(json.dumps(report), encoding="utf-8")
with self.assertRaisesRegex(ValueError, "symlinks"):
renderer.render(input_path, self.work / "unsafe.pdf", TYPST)
def test_cli_runs_outside_repository(self):
output = self.work / "outside-cwd.pdf"
result = subprocess.run([
"bash", str(ROOT / "tools" / "render.sh"),
str(ROOT / "examples" / "minimal-report.json"), "--output", str(output),
], cwd=self.work, text=True, capture_output=True)
self.assertEqual(result.returncode, 0, result.stderr)
self.assert_pdf(output)
@unittest.skipUnless(PDFINFO and PDFTOTEXT, "Poppler PDF inspection tools are not installed")
def test_long_content_paginates_without_losing_tail_content(self):
paragraphs = [
{"type": "text", "text": f"Pagination paragraph {index}: " +
"Synthetic content exercises wrapping and page flow. " * 8}
for index in range(1, 41)
]
paragraphs.append({"type": "callout", "kind": "success",
"title": "Completion marker", "text": "END-OF-LONG-REPORT"})
report = {"schema_version": 1, "title": "Long pagination exercise",
"metadata": {"Date": "2026-09-15", "Author": "Synthetic Author"},
"sections": [{"title": "Sustained content", "content": paragraphs}]}
input_path = self.work / "long.json"
input_path.write_text(json.dumps(report), encoding="utf-8")
output = self.work / "long.pdf"
renderer.render(input_path, output, TYPST)
self.assert_pdf(output)
info = subprocess.run([PDFINFO, str(output)], text=True, capture_output=True, check=True)
pages = next(int(line.split(":", 1)[1]) for line in info.stdout.splitlines()
if line.startswith("Pages:"))
self.assertGreaterEqual(pages, 4)
text_output = self.work / "long.txt"
subprocess.run([PDFTOTEXT, str(output), str(text_output)], check=True)
extracted = text_output.read_text(encoding="utf-8")
self.assertIn("Pagination paragraph 1", extracted)
self.assertIn("Pagination paragraph 40", extracted)
self.assertIn("END-OF-LONG-REPORT", extracted)
def test_standalone_component_copy_renders_example(self):
standalone = self.work / "standalone"
shutil.copytree(ROOT, standalone, ignore=shutil.ignore_patterns(
".git", ".ci-venv", "__pycache__", "*.pyc"))
output = self.work / "standalone.pdf"
result = subprocess.run([
"bash", str(standalone / "tools" / "render.sh"),
str(standalone / "examples" / "example-report.yaml"),
"--output", str(output), "--typst", TYPST,
], cwd=self.work, text=True, capture_output=True)
self.assertEqual(result.returncode, 0, result.stderr)
self.assert_pdf(output)
if __name__ == "__main__":
unittest.main()