146 lines
6.7 KiB
Python
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()
|