---
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, pendiente-usar]
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`.
