Guía de Procesamiento de PDFs
Resumen
Esta guía cubre operaciones esenciales para el procesamiento de PDFs utilizando bibliotecas Python y herramientas de línea de comandos. Para características avanzadas, bibliotecas JavaScript y ejemplos detallados, consulta reference.md. Si necesitas rellenar un formulario PDF, lee forms.md y sigue sus instrucciones.
Inicio Rápido
from pypdf import PdfReader, PdfWriter
# Leer un PDF
reader = PdfReader("documento.pdf")
print(f"Páginas: {len(reader.pages)}")
# Extraer texto
text = ""
for page in reader.pages:
text += page.extract_text()
Bibliotecas Python
pypdf - Operaciones Básicas
Combinar 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("combinado.pdf", "wb") as output:
writer.write(output)
Dividir PDF
reader = PdfReader("input.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)
Extraer Metadatos
reader = PdfReader("documento.pdf")
meta = reader.metadata
print(f"Título: {meta.title}")
print(f"Autor: {meta.author}")
print(f"Asunto: {meta.subject}")
print(f"Creador: {meta.creator}")
Rotar Páginas
reader = PdfReader("input.pdf")
writer = PdfWriter()
page = reader.pages[0]
page.rotate(90) # Rotar 90 grados en sentido horario
writer.add_page(page)
with open("rotado.pdf", "wb") as output:
writer.write(output)
pdfplumber - Extracción de Texto y Tablas
Extraer Texto con Diseño
import pdfplumber
with pdfplumber.open("documento.pdf") as pdf:
for page in pdf.pages:
text = page.extract_text()
print(text)
Extraer Tablas
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"Tabla {j+1} en página {i+1}:")
for row in table:
print(row)
Extracción Avanzada de Tablas
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 que la tabla no esté vacía
df = pd.DataFrame(table[1:], columns=table[0])
all_tables.append(df)
# Combinar todas las tablas
if all_tables:
combined_df = pd.concat(all_tables, ignore_index=True)
combined_df.to_excel("tablas_extraidas.xlsx", index=False)
reportlab - Crear PDFs
Creación Básica de PDF
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
c = canvas.Canvas("hola.pdf", pagesize=letter)
width, height = letter
# Añadir texto
c.drawString(100, height - 100, "¡Hola Mundo!")
c.drawString(100, height - 120, "Este es un PDF creado con reportlab")
# Añadir una línea
c.line(100, height - 140, 400, height - 140)
# Guardar
c.save()
Crear PDF con Múltiples Páginas
from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
from reportlab.lib.styles import getSampleStyleSheet
doc = SimpleDocTemplate("informe.pdf", pagesize=letter)
styles = getSampleStyleSheet()
story = []
# Añadir contenido
title = Paragraph("Título del Informe", styles['Title'])
story.append(title)
story.append(Spacer(1, 12))
body = Paragraph("Este es el cuerpo del informe. " * 20, styles['Normal'])
story.append(body)
story.append(PageBreak())
# Página 2
story.append(Paragraph("Página 2", styles['Heading1']))
story.append(Paragraph("Contenido de la página 2", styles['Normal']))
# Construir PDF
doc.build(story)
Herramientas de Línea de Comandos
pdftotext (poppler-utils)
# Extraer texto
pdftotext input.pdf output.txt
# Extraer texto conservando el diseño
pdftotext -layout input.pdf output.txt
# Extraer páginas específicas
pdftotext -f 1 -l 5 input.pdf output.txt # Páginas 1-5
qpdf
# Combinar PDFs
qpdf --empty --pages archivo1.pdf archivo2.pdf -- combinado.pdf
# Dividir páginas
qpdf input.pdf --pages . 1-5 -- paginas1-5.pdf
qpdf input.pdf --pages . 6-10 -- paginas6-10.pdf
# Rotar páginas
qpdf input.pdf output.pdf --rotate=+90:1 # Rotar página 1 90 grados
# Eliminar contraseña
qpdf --password=micontraseña --decrypt encriptado.pdf desencriptado.pdf
pdftk (si está disponible)
# Combinar
pdftk archivo1.pdf archivo2.pdf cat output combinado.pdf
# Dividir
pdftk input.pdf burst
# Rotar
pdftk input.pdf rotate 1east output rotado.pdf
Tareas Comunes
Extraer Texto de PDFs Escaneados
# Requiere: pip install pytesseract pdf2image
import pytesseract
from pdf2image import convert_from_path
# Convertir PDF a imágenes
images = convert_from_path('escaneado.pdf')
# OCR por página
text = ""
for i, image in enumerate(images):
text += f"Página {i+1}:\n"
text += pytesseract.image_to_string(image)
text += "\n\n"
print(text)
Añadir Marca de Agua
from pypdf import PdfReader, PdfWriter
# Crear marca de agua (o cargar existente)
watermark = PdfReader("marca_de_agua.pdf").pages[0]
# Aplicar a todas las páginas
reader = PdfReader("documento.pdf")
writer = PdfWriter()
for page in reader.pages:
page.merge_page(watermark)
writer.add_page(page)
with open("marcado.pdf", "wb") as output:
writer.write(output)
Extraer Imágenes
# Usando pdfimages (poppler-utils)
pdfimages -j input.pdf prefijo_salida
# Esto extrae todas las imágenes como prefijo_salida-000.jpg, prefijo_salida-001.jpg, etc.
Protección por Contraseña
from pypdf import PdfReader, PdfWriter
reader = PdfReader("input.pdf")
writer = PdfWriter()
for page in reader.pages:
writer.add_page(page)
# Añadir contraseña
writer.encrypt("contraseña_usuario", "contraseña_propietario")
with open("encriptado.pdf", "wb") as output:
writer.write(output)
Referencia Rápida
| Tarea | Mejor Herramienta | Comando/Código |
|---|---|---|
| Combinar PDFs | pypdf | writer.add_page(page) |
| Dividir PDFs | pypdf | Una página por archivo |
| Extraer texto | pdfplumber | page.extract_text() |
| Extraer tablas | pdfplumber | page.extract_tables() |
| Crear PDFs | reportlab | Canvas o Platypus |
| Combinar por línea de comandos | qpdf | qpdf --empty --pages ... |
| OCR de PDFs escaneados | pytesseract | Convertir a imagen primero |
| Rellenar formularios PDF | pdf-lib o pypdf (ver forms.md) | Ver forms.md |
Próximos Pasos
- Para uso avanzado de pypdfium2, consulta
reference.md - Para bibliotecas JavaScript (pdf-lib), consulta
reference.md - Si necesitas rellenar un formulario PDF, sigue las instrucciones en
forms.md - Para guías de resolución de problemas, consulta
reference.md