openpyxl / python-docx / reportlab

Três bibliotecas cobrem a maior parte da automação de documentos em Python: openpyxl para Excel, python-docx para Word e reportlab para geração de PDF - comum em fluxos de trabalho de relatórios, exportações e conformidade.

Receita

from openpyxl import Workbook
 
wb = Workbook()
ws = wb.active
ws.title = "Resumo"
ws.append(["sku", "qtde", "receita"])
ws.append(["ABC", 10, 199.90])
wb.save("relatorio.xlsx")

Quando usar isso:

• Exportar resultados de consulta para Excel para finanças/operações
• Documentos Word no estilo mala direta a partir de dados do CRM
• Faturas, notas de embalagem e certificados como PDF
• Tarefas de relatório agendadas em Celery/cron

Exemplo de Trabalho

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 = "Vendas"
    ws.append(["produto", "unidades", "receita"])
    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"Fatura {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))

O que isso demonstra:

• Workbooks em memória via BytesIO para respostas HTTP
• Planilha xlsx tabular simples sem a sobrecarga do pandas
• PDF mínimo com a API de canvas do reportlab
• Timestamp UTC no PDF para trilha de auditoria

Mergulho Profundo

Como Funciona

• openpyxl - OOXML xlsx; load_workbook para edições; data_only=True lê valores de fórmula em cache.
• python-docx - Manipula WordprocessingML; parágrafos, tabelas, estilos; mesclagem de modelo substituindo placeholders.
• reportlab - Canvas PDF de baixo nível mais Platypus flowables para layouts complexos.

Escolha da Biblioteca

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)

Armadilhas

• Carregar xlsx não confiável - Existem variantes de XML bombs e billion-laughs. Correção: limites de tamanho, verificação de vírus, análise em worker de sandbox.
• Fórmulas vs valores - load_workbook retorna fórmulas por padrão. Correção: data_only=True para valores exibidos (desatualizados até o Excel abrir).
• Recursos não suportados pelo python-docx - Cabeçalhos/rodapés em modelos complexos podem falhar. Correção: simplifique o modelo ou use modelos docx mantidos no Word.
• Licenciamento de fontes do reportlab - Incorpore apenas fontes licenciadas para PDFs comerciais. Correção: use Helvetica embutido ou TTF licenciado.
• Memória em grandes exportações - Construir um xlsx de um milhão de linhas na RAM causa OOM. Correção: CSV para dados grandes, ou gravações em blocos com o modo write_only=True.
• Localização e datas no Excel - O Excel exibe o formato local; armazene ISO nos dados de origem. Correção: formatos de número explícitos em openpyxl.

Alternativas

FAQs

Relacionados

• Noções Básicas de pandas - DataFrame para Excel
• celery - geração de relatórios assíncrona
• S3 - armazenamento de documentos gerados
• pendulum / arrow - datas em relatórios

Versões da Stack: Esta página foi escrita para Python 3.14.0 (estável 3.14, manutenção 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+ e uv 0.6+.