fn_registry/python/functions/infra/pdf_merge.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
pdf_merge	function	py	infra	1.0.0	impure	def pdf_merge(pdf_paths, output_path) -> str	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.	pdf merge combine pypdf infra pendiente-usar				false	error_go_core	pypdf	name desc pdf_paths lista de rutas a los archivos PDF a fusionar, en el orden deseado name desc output_path ruta del archivo PDF combinado a generar	output_path con todos los PDFs fusionados en orden	true	fusionar dos PDFs error si archivo no existe error si lista vacia	python/functions/infra/pdf_merge_test.py	python/functions/infra/pdf_merge.py

Ejemplo

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