---
name: pdf_from_html
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def pdf_from_html(html_string, output_path, page_size, css) -> str"
description: "Convierte un HTML string a PDF usando weasyprint con soporte completo de CSS layout. Retorna error claro si weasyprint no esta instalado (requiere dependencias de sistema: pango, cairo)."
tags: [pdf, html, weasyprint, conversion, infra]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [weasyprint]
params:
- name: html_string
desc: "contenido HTML completo como string, incluyendo head y body"
- name: output_path
desc: "ruta del archivo PDF a generar"
- name: page_size
desc: "tamaño de pagina CSS: A4, letter, A3. Por defecto A4"
- name: css
desc: "CSS adicional como string para aplicar sobre el HTML, puede incluir fuentes y layouts"
output: "output_path con el PDF guardado en disco"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/infra/pdf_from_html.py"
---
## Ejemplo
```python
html = """
Reporte
"""
css = "body { font-family: sans-serif; } h1 { color: #333; }"
output = pdf_from_html(html, "reporte.pdf", css=css)
```
## Instalacion de dependencias
```bash
# Python
pip install weasyprint
# Linux (Ubuntu/Debian)
sudo apt install libpango-1.0-0 libcairo2 libgdk-pixbuf-2.0-0
# macOS
brew install pango cairo gdk-pixbuf
```
## Notas
Stub activo: si `weasyprint` no esta instalado, lanza `RuntimeError` con instrucciones de instalacion claras. Para la mayoria de reportes simples, preferir el builder fpdf2 (`pdf_create` + `pdf_add_text` + `pdf_add_table`) que no requiere dependencias de sistema. weasyprint es util para HTML complejo con CSS avanzado (columnas, grid, fuentes web, estilos corporativos).