Guia de Processamento de PDF
Visão Geral
Este guia cobre operações essenciais de processamento de PDF usando bibliotecas Python e ferramentas de linha de comando. Para funcionalidades avançadas, bibliotecas JavaScript e exemplos detalhados, consulte REFERENCE.md. Se você precisar preencher um formulário PDF, leia FORMS.md e siga suas instruções.
Início Rápido
from pypdf import PdfReader, PdfWriter
# Ler um PDF
reader = PdfReader("documento.pdf")
print(f"Páginas: {len(reader.pages)}")
# Extrair texto
texto = ""
for page in reader.pages:
texto += page.extract_text()
Bibliotecas Python
pypdf - Operações Básicas
Mesclar PDFs
from pypdf import PdfWriter, PdfReader
writer = PdfWriter()
for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
reader = PdfReader(pdf_file)
for page in reader.pages:
writer.add_page(page)
with open("mesclado.pdf", "wb") as output:
writer.write(output)
Dividir PDF
reader = PdfReader("entrada.pdf")
for i, page in enumerate(reader.pages):
writer = PdfWriter()
writer.add_page(page)
with open(f"pagina_{i+1}.pdf", "wb") as output:
writer.write(output)
Extrair Metadados
reader = PdfReader("documento.pdf")
meta = reader.metadata
print(f"Título: {meta.title}")
print(f"Autor: {meta.author}")
print(f"Assunto: {meta.subject}")
print(f"Criador: {meta.creator}")
Girar Páginas
reader = PdfReader("entrada.pdf")
writer = PdfWriter()
page = reader.pages[0]
page.rotate(90) # Girar 90 graus no sentido horário
writer.add_page(page)
with open("girado.pdf", "wb") as output:
writer.write(output)
pdfplumber - Extração de Texto e Tabelas
Extrair Texto com Layout
import pdfplumber
with pdfplumber.open("documento.pdf") as pdf:
for page in pdf.pages:
texto = page.extract_text()
print(texto)
Extrair Tabelas
with pdfplumber.open("documento.pdf") as pdf:
for i, page in enumerate(pdf.pages):
tables = page.extract_tables()
for j, table in enumerate(tables):
print(f"Tabela {j+1} na página {i+1}:")
for row in table:
print(row)
Extração Avançada de Tabelas
import pandas as pd
with pdfplumber.open("documento.pdf") as pdf:
all_tables = []
for page in pdf.pages:
tables = page.extract_tables()
for table in tables:
if table: # Verificar se a tabela não está vazia
df = pd.DataFrame(table[1:], columns=table[0])
all_tables.append(df)
# Combinar todas as tabelas
if all_tables:
combined_df = pd.concat(all_tables, ignore_index=True)
combined_df.to_excel("tabelas_extraidas.xlsx", index=False)
reportlab - Criar PDFs
Criação Básica de PDF
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
c = canvas.Canvas("ola.pdf", pagesize=letter)
width, height = letter
# Adicionar texto
c.drawString(100, height - 100, "Olá Mundo!")
c.drawString(100, height - 120, "Este é um PDF criado com reportlab")
# Adicionar uma linha
c.line(100, height - 140, 400, height - 140)
# Salvar
c.save()
Criar PDF com Múltiplas Páginas
from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
from reportlab.lib.styles import getSampleStyleSheet
doc = SimpleDocTemplate("relatorio.pdf", pagesize=letter)
styles = getSampleStyleSheet()
story = []
# Adicionar conteúdo
title = Paragraph("Título do Relatório", styles['Title'])
story.append(title)
story.append(Spacer(1, 12))
body = Paragraph("Este é o corpo do relatório. " * 20, styles['Normal'])
story.append(body)
story.append(PageBreak())
# Página 2
story.append(Paragraph("Página 2", styles['Heading1']))
story.append(Paragraph("Conteúdo para a página 2", styles['Normal']))
# Construir PDF
doc.build(story)
Subscritos e Sobrescritos
IMPORTANTE: Nunca use caracteres Unicode de subscrito/sobrescrito (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) em PDFs do ReportLab. As fontes internas não incluem esses glifos, fazendo com que sejam renderizados como caixas pretas sólidas.
Em vez disso, use as tags de marcação XML do ReportLab em objetos Paragraph:
from reportlab.platypus import Paragraph
from reportlab.lib.styles import getSampleStyleSheet
styles = getSampleStyleSheet()
# Subscritos: use a tag <sub>
chemica = Paragraph("H<sub>2</sub>O", styles['Normal'])
# Sobrescritos: use a tag <super>
quadrado = Paragraph("x<super>2</super> + y<super>2</super>", styles['Normal'])
Para texto desenhado em canvas (não objetos Paragraph), ajuste manualmente o tamanho e a posição da fonte em vez de usar subscritos/sobrescritos Unicode.
Ferramentas de Linha de Comando
pdftotext (poppler-utils)
# Extrair texto
pdftotext entrada.pdf saida.txt
# Extrair texto preservando layout
pdftotext -layout entrada.pdf saida.txt
# Extrair páginas específicas
pdftotext -f 1 -l 5 entrada.pdf saida.txt # Páginas 1-5
qpdf
# Mesclar PDFs
qpdf --empty --pages arquivo1.pdf arquivo2.pdf -- mesclado.pdf
# Dividir páginas
qpdf entrada.pdf --pages . 1-5 -- paginas1-5.pdf
qpdf entrada.pdf --pages . 6-10 -- paginas6-10.pdf
# Girar páginas
qpdf entrada.pdf saida.pdf --rotate=+90:1 # Girar página 1 em 90 graus
# Remover senha
qpdf --password=minhasenha --decrypt criptografado.pdf descriptografado.pdf
pdftk (se disponível)
# Mesclar
pdftk arquivo1.pdf arquivo2.pdf cat output mesclado.pdf
# Dividir
pdftk entrada.pdf burst
# Girar
pdftk entrada.pdf rotate 1east output girado.pdf
Tarefas Comuns
Extrair Texto de PDFs Escaneados
# Requer: pip install pytesseract pdf2image
import pytesseract
from pdf2image import convert_from_path
# Converter PDF para imagens
images = convert_from_path('escaneado.pdf')
# OCR em cada página
texto = ""
for i, image in enumerate(images):
texto += f"Página {i+1}:\n"
texto += pytesseract.image_to_string(image)
texto += "\n\n"
print(texto)
Adicionar Marca d'Água
from pypdf import PdfReader, PdfWriter
# Criar marca d'água (ou carregar existente)
watermark = PdfReader("marca_dagua.pdf").pages[0]
# Aplicar a todas as páginas
reader = PdfReader("documento.pdf")
writer = PdfWriter()
for page in reader.pages:
page.merge_page(watermark)
writer.add_page(page)
with open("com_marca_dagua.pdf", "wb") as output:
writer.write(output)
Extrair Imagens
# Usando pdfimages (poppler-utils)
pdfimages -j entrada.pdf prefixo_saida
# Isso extrai todas as imagens como prefixo_saida-000.jpg, prefixo_saida-001.jpg, etc.
Proteção com Senha
from pypdf import PdfReader, PdfWriter
reader = PdfReader("entrada.pdf")
writer = PdfWriter()
for page in reader.pages:
writer.add_page(page)
# Adicionar senha
writer.encrypt("senha_usuario", "senha_dono")
with open("criptografado.pdf", "wb") as output:
writer.write(output)
Referência Rápida
| Tarefa | Melhor Ferramenta | Comando/Código |
|---|---|---|
| Mesclar PDFs | pypdf | writer.add_page(page) |
| Dividir PDFs | pypdf | Uma página por arquivo |
| Extrair texto | pdfplumber | page.extract_text() |
| Extrair tabelas | pdfplumber | page.extract_tables() |
| Criar PDFs | reportlab | Canvas ou Platypus |
| Mesclar via linha de comando | qpdf | qpdf --empty --pages ... |
| OCR em PDFs escaneados | pytesseract | Converter para imagem primeiro |
| Preencher formulários PDF | pdf-lib ou pypdf (veja FORMS.md) | Veja FORMS.md |
Próximos Passos
- Para uso avançado do pypdfium2, consulte REFERENCE.md
- Para bibliotecas JavaScript (pdf-lib), consulte REFERENCE.md
- Se precisar preencher um formulário PDF, siga as instruções em FORMS.md
- Para guias de solução de problemas, consulte REFERENCE.md