Files
fn_registry/python/functions/infra/pdf_merge.md
T
egutierrez df424f2de0 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>
2026-04-13 02:02:51 +02:00

41 lines
1.5 KiB
Markdown

---
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`.