openpyxl / python-docx / reportlab

Tres bibliotecas cubren la mayor parte de la automatización de documentos en Python: openpyxl para Excel, python-docx para Word y reportlab para la generación de PDF, comunes en flujos de trabajo de informes, exportaciones y cumplimiento.

Receta

from openpyxl import Workbook
 
wb = Workbook()
ws = wb.active
ws.title = "Summary"
ws.append(["sku", "qty", "revenue"])
ws.append(["ABC", 10, 199.90])
wb.save("report.xlsx")

Cuándo usar esto:

• Exportar resultados de consultas a Excel para finanzas/operaciones
• Documentos de Word estilo combinación de correspondencia a partir de datos de CRM
• Facturas, albaranes y certificados en formato PDF
• Tareas programadas de informes en Celery/cron

Ejemplo de Trabajo

from __future__ import annotations
 
from datetime import datetime, timezone
from io import BytesIO
 
from openpyxl import Workbook
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
 
 
def build_sales_xlsx(rows: list[tuple[str, int, float]]) -> bytes:
    wb = Workbook()
    ws = wb.active
    ws.title = "Sales"
    ws.append(["product", "units", "revenue"])
    for product, units, revenue in rows:
        ws.append([product, units, revenue])
    buf = BytesIO()
    wb.save(buf)
    return buf.getvalue()
 
 
def build_invoice_pdf(invoice_id: str, total: float) -> bytes:
    buf = BytesIO()
    c = canvas.Canvas(buf, pagesize=letter)
    c.setFont("Helvetica", 12)
    c.drawString(72, 720, f"Invoice {invoice_id}")
    c.drawString(72, 700, f"Total: ${total:,.2f}")
    c.drawString(72, 680, datetime.now(timezone.utc).isoformat())
    c.showPage()
    c.save()
    return buf.getvalue()
 
 
if __name__ == "__main__":
    xlsx = build_sales_xlsx([("widget", 3, 59.97)])
    pdf = build_invoice_pdf("INV-1001", 59.97)
    print(len(xlsx), len(pdf))

Lo que esto demuestra:

• Libros de trabajo en memoria a través de BytesIO para respuestas HTTP
• xlsx tabular simple sin la sobrecarga de pandas
• PDF mínimo con la API de lienzo de reportlab
• Marca de tiempo UTC en el PDF para pista de auditoría

Inmersión Profunda

Cómo Funciona

• openpyxl - OOXML xlsx; load_workbook para ediciones; data_only=True lee los valores de fórmula cacheados.
• python-docx - Manipula WordprocessingML; párrafos, tablas, estilos; fusión de plantillas reemplazando marcadores.
• reportlab - Lienzo PDF de bajo nivel más Platypus flowables para diseños complejos.

Selector de Bibliotecas

Notas de Python

from docx import Document
 
doc = Document("template.docx")
for p in doc.paragraphs:
    if "{{NAME}}" in p.text:
        p.text = p.text.replace("{{NAME}}", "Ada Lovelace")
buf = BytesIO()
doc.save(buf)

Trampas

• Cargar xlsx no confiable - Existen variantes de bombas XML y billion-laughs. Solución: límites de tamaño, escaneo de virus, análisis en un worker aislado.
• Fórmulas vs valores - load_workbook devuelve fórmulas por defecto. Solución: data_only=True para valores mostrados (obsoleto hasta que Excel se abra).
• Características no soportadas por python-docx - Las cabeceras/pies de página en plantillas complejas pueden fallar. Solución: simplificar la plantilla o usar plantillas docx mantenidas en Word.
• Licenciamiento de fuentes de reportlab - Incrusta solo fuentes licenciadas para PDFs comerciales. Solución: usa Helvetica incorporada o TTF licenciada.
• Memoria en exportaciones enormes - Crear un xlsx de un millón de filas en RAM causa OOM. Solución: CSV para datos grandes, o escrituras fragmentadas en modo write_only=True.
• Localización y fechas en Excel - Excel muestra formato local; almacena ISO en los datos de origen. Solución: formatos numéricos explícitos en openpyxl.

Alternativas

Preguntas Frecuentes

Relacionado

• Fundamentos de pandas - DataFrame a Excel
• celery - generación de informes asíncrona
• S3 - almacenamiento de documentos generados
• pendulum / arrow - fechas en informes

Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.