feat: issue/0020 — generacion de PDFs en Python y Go

Añade 3 tipos Python (PDFDoc, PDFPage, PDFStyle) y 10 funciones Python
para construir PDFs con fpdf2 (builder fluent), fusionar PDFs con pypdf
y convertir HTML/Markdown a PDF via weasyprint (stub si no disponible).
Añade pdf_simple_report en Go como stub hasta que go-pdf/fpdf se integre.

- python/types/infra/: pdf_doc, pdf_page, pdf_style
- python/functions/infra/: pdf_create, pdf_add_page, pdf_add_text,
  pdf_add_table, pdf_add_image, pdf_add_header_footer, pdf_from_html,
  pdf_from_markdown, pdf_merge, pdf_save
- functions/infra/pdf_simple_report.go: stub Go con ReportSection/ReportTable
- 17 tests Python pasando (pytest)
- fpdf2 y pypdf añadidos via uv al venv Python

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-13 02:02:51 +02:00
parent 092f14eff0
commit df424f2de0
35 changed files with 1818 additions and 0 deletions
+44
View File
@@ -0,0 +1,44 @@
---
name: pdf_add_page
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def pdf_add_page(doc, orientation, width, height) -> PDFDoc"
description: "Añade una pagina nueva al documento PDF con orientacion y tamaño configurables. Sin dimensiones personalizadas usa A4 con la orientacion indicada."
tags: [pdf, page, layout, builder, infra]
uses_functions: []
uses_types: [pdf_doc_py_infra]
returns: [pdf_doc_py_infra]
returns_optional: false
error_type: "error_go_core"
imports: []
params:
- name: doc
desc: "PDFDoc inicializado con pdf_create"
- name: orientation
desc: "orientacion de la pagina: 'portrait' (vertical) o 'landscape' (horizontal)"
- name: width
desc: "ancho personalizado en mm; None usa A4 (210 mm)"
- name: height
desc: "alto personalizado en mm; None usa A4 (297 mm)"
output: "PDFDoc con la nueva pagina añadida; metadata de la pagina en doc.pages"
tested: true
tests: ["añadir pagina portrait A4", "añadir pagina landscape", "pagina con dimensiones personalizadas"]
test_file_path: "python/functions/infra/pdf_add_page_test.py"
file_path: "python/functions/infra/pdf_add_page.py"
---
## Ejemplo
```python
doc = pdf_create(title="Demo")
doc = pdf_add_page(doc) # A4 portrait
doc = pdf_add_page(doc, orientation="landscape") # A4 landscape
doc = pdf_add_page(doc, width=148, height=210) # A5 portrait
```
## Notas
Llama a `fpdf.add_page()` con el formato adecuado. El header/footer configurado en `pdf_add_header_footer` se aplica automaticamente en cada pagina nueva (via subclase FPDF). Las dimensiones reales post-add se registran en `doc.pages` con las medidas internas de fpdf2 (que incluye los margenes).