fn_registry/python/functions/infra/pdf_save.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_save	function	py	infra	1.0.0	impure	def pdf_save(doc, output_path) -> str | bytes	Serializa el documento PDF a disco o retorna los bytes en memoria. Si output_path es None retorna bytes para transmision directa (HTTP response, almacenamiento en BD). Si se especifica, escribe el archivo y retorna el path.	pdf save output builder infra pendiente-usar		pdf_doc_py_infra		false	error_go_core		name desc doc PDFDoc con al menos una pagina y contenido añadido name desc output_path ruta del archivo PDF a crear en disco; None retorna bytes del PDF en memoria	output_path (str) si se escribio a disco, o bytes del PDF si output_path es None	true	guardar PDF a archivo retornar bytes del PDF PDF valido comienza con %PDF	python/functions/infra/pdf_save_test.py	python/functions/infra/pdf_save.py

Ejemplo

# Guardar a disco
path = pdf_save(doc, "reporte.pdf")
print(f"PDF guardado en: {path}")

# Obtener bytes (para HTTP response o guardar en BD)
pdf_bytes = pdf_save(doc)
assert pdf_bytes[:4] == b"%PDF"

# En un endpoint web (ejemplo conceptual)
return Response(pdf_save(doc), content_type="application/pdf")

Notas

Llama a fpdf2.output(). Si el documento usa alias_nb_pages() (activado por pdf_add_header_footer con page_numbers=True), fpdf2 reemplaza el alias con el total real de paginas al serializar. Para retornar bytes, output() retorna un bytearray que se convierte a bytes para compatibilidad con APIs que esperan bytes.