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:
@@ -0,0 +1,40 @@
|
||||
---
|
||||
name: pdf_merge
|
||||
kind: function
|
||||
lang: py
|
||||
domain: infra
|
||||
version: "1.0.0"
|
||||
purity: impure
|
||||
signature: "def pdf_merge(pdf_paths, output_path) -> str"
|
||||
description: "Fusiona una lista de archivos PDF en un unico PDF combinado usando pypdf. Mantiene el orden de la lista. Lanza FileNotFoundError si alguno de los archivos no existe."
|
||||
tags: [pdf, merge, combine, pypdf, infra]
|
||||
uses_functions: []
|
||||
uses_types: []
|
||||
returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: [pypdf]
|
||||
params:
|
||||
- name: pdf_paths
|
||||
desc: "lista de rutas a los archivos PDF a fusionar, en el orden deseado"
|
||||
- name: output_path
|
||||
desc: "ruta del archivo PDF combinado a generar"
|
||||
output: "output_path con todos los PDFs fusionados en orden"
|
||||
tested: true
|
||||
tests: ["fusionar dos PDFs", "error si archivo no existe", "error si lista vacia"]
|
||||
test_file_path: "python/functions/infra/pdf_merge_test.py"
|
||||
file_path: "python/functions/infra/pdf_merge.py"
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```python
|
||||
# Fusionar capitulos en un documento unico
|
||||
paths = ["cap1.pdf", "cap2.pdf", "cap3.pdf", "apendice.pdf"]
|
||||
output = pdf_merge(paths, "documento_completo.pdf")
|
||||
print(f"PDF generado: {output}")
|
||||
```
|
||||
|
||||
## Notas
|
||||
|
||||
Usa `pypdf` (sucesor de PyPDF2). El merge copia pagina a pagina — preserva contenido pero puede perder algunos metadatos avanzados (formularios interactivos, bookmarks anidados). Para PDFs protegidos con contrasena, pypdf necesita que se pase la password en el `PdfReader`. La lista debe tener al menos un elemento o lanza `ValueError`.
|
||||
Reference in New Issue
Block a user