Implementace prevodu HTML na PDF

Sluzba prijme adresu HTML dokumentu nebo HTML v tele requestu a vrati PDF.
Navrzena pro dokumenty o stovkach az tisicich stranek.

Rendering:
- WeasyPrint jako vychozi engine, spravne CSS Paged Media, nizka pametova
  narocnost, bez JavaScriptu
- Chromium pres Playwright pro dokumenty dokreslovane skripty
- rezim auto s detekci skriptu a fallbackem pri selhani WeasyPrintu

Velke dokumenty:
- deleni na casti na strukturalnich hranicich, rez nikdy uvnitr tabulky
  nebo odstavce
- dvoupruchodovy render obsahu se skutecnymi cisly stranek, pozice nadpisu
  se ctou z kotev hlasenych u kazde stranky
- cislovani stranek bud pres CSS countery, nebo pres cislovaci vrstvu
  nastampovanou na hotove PDF, rozmer stranky se cte z vysledneho souboru
- Chromium se restartuje po N jobech, nikdy vsak behem beziciho renderu

API:
- POST /convert synchronne, POST /jobs asynchronne se sledovanim stavu,
  stahovanim vysledku, rusenim a volitelnym callbackem
- GET /health s overenim dostupnosti obou enginu a stavem fronty
- OpenAPI respektuje prefix reverse proxy pres root_path

Bezpecnost a provoz:
- SSRF kontrola po DNS resolvu, na kazdem presmerovani a u vsech pozadavku
  prohlizece
- nedostupne assety render nezastavi, ale hlasi se v odpovedi i v logu
- fronta s omezenym poctem workeru, rozpracovane joby se pri ukonceni
  oznaci jako failed, nezmizi potichu
- strukturovane JSON logovani s job_id
- vsechny limity vypnute ve vychozim stavu

Dockerfile je dvoufazovy, obsahuje zavislosti WeasyPrintu, Chromium
a fonty s ceskou diakritikou.

Autentizace zamerne neni implementovana, zpusob predavani neni domluveny.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
JiriUhlir
2026-08-27 14:50:10 +02:00
co-authored by Claude Opus 5
parent e3cc8f418b
commit 156289fe2d
48 changed files with 4043 additions and 24 deletions
+42
View File
@@ -0,0 +1,42 @@
"""Behaviour when an asset cannot be loaded.
A missing image must not abort the render, but it must never disappear
silently either.
"""
from __future__ import annotations
import pytest
pytest.importorskip("weasyprint")
from app.config import Settings # noqa: E402
from app.engines.weasy import WeasyPrintEngine # noqa: E402
from app.models import ConvertRequest, Source # noqa: E402
from app.services.pipeline import ConversionPipeline # noqa: E402
pytestmark = pytest.mark.asyncio
HTML_WITH_BLOCKED_IMAGE = """
<!DOCTYPE html><html><head><meta charset="utf-8"></head>
<body>
<h1>Dokument s nedostupnym obrazkem</h1>
<p>Text pokracuje i kdyz se obrazek nenacte.</p>
<img src="http://127.0.0.1:9/neexistuje.png" alt="chybi">
</body></html>
"""
async def test_blocked_asset_is_reported_and_render_continues(tmp_path) -> None:
pipeline = ConversionPipeline({"weasyprint": WeasyPrintEngine()}, Settings())
request = ConvertRequest(
source=Source(html=HTML_WITH_BLOCKED_IMAGE),
engine="weasyprint",
)
result = await pipeline.run(request, tmp_path)
assert result.page_count >= 1
assert result.path.exists()
assert result.missing_assets, "nedostupny asset musi byt hlaseny v odpovedi"
assert "127.0.0.1" in result.missing_assets[0].url