Files
JiriUhlirandClaude Opus 5 156289fe2d 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>
2026-08-27 14:50:10 +02:00

38 lines
1.3 KiB
Python

"""Building of the page stylesheet."""
from __future__ import annotations
from app.models import PageNumbers, PageSettings
from app.pdf.styles import build_page_css, css_content_value, page_size_value
def test_named_format_keeps_orientation() -> None:
assert page_size_value(PageSettings(format="A4", orientation="landscape")) == "A4 landscape"
def test_explicit_dimensions_are_used_as_is() -> None:
assert page_size_value(PageSettings(format="210mm 297mm")) == "210mm 297mm"
def test_content_uses_counters_when_the_total_is_unknown() -> None:
assert css_content_value("{page} / {pages}", None) == 'counter(page) " / " counter(pages)'
def test_content_uses_a_literal_when_the_total_is_known() -> None:
assert css_content_value("Strana {page} z {pages}", 120) == '"Strana " counter(page) " z " "120"'
def test_page_numbers_are_absent_when_disabled() -> None:
css = build_page_css(PageSettings(), PageNumbers(enabled=False))
assert "@bottom-center" not in css
def test_page_numbers_land_in_the_requested_box() -> None:
css = build_page_css(PageSettings(), PageNumbers(enabled=True, position="top-right"))
assert "@top-right" in css
def test_bookmarks_can_be_switched_off() -> None:
css = build_page_css(PageSettings(), None, outline=False)
assert "bookmark-level: none" in css