flanker

 
 

Biblioteca Python de código abierto para el análisis de correos

Analizar direcciones de correo, validar direcciones y analizar mensajes MIME mediante la API Python gratuita y de código abierto.

¿Qué es flanker?

flanker es una biblioteca de Python de código abierto desarrollada por Mailgun para analizar direcciones de correo electrónico y mensajes MIME. Proporciona herramientas robustas para validar direcciones de correo electrónico, analizar listas de direcciones complejas y extraer datos estructurados de mensajes MIME. Diseñada para uso en producción, flanker es compatible con Python 2.7 y Python 3.6+, lo que la hace ideal para desarrolladores que construyen aplicaciones intensivas en correo electrónico, como canalizaciones de procesamiento de correo, integraciones CRM y sistemas de notificaciones.

La biblioteca consta de dos módulos principales: `flanker.addresslib` para analizar y validar direcciones de correo electrónico, y `flanker.mime` para analizar mensajes MIME. Soporta modos de análisis estricto y flexible, validación de registros DNS/MX y reportes de errores detallados. Con su API limpia y dependencias mínimas, flanker permite a los desarrolladores procesar datos de correo de forma fiable sin depender de binarios externos o dependencias complejas. Su uso generalizado en la infraestructura de Mailgun garantiza estabilidad y rendimiento en entornos de alto volumen.

Previous Next

Primeros pasos con flanker

Para comenzar con flanker, primero necesitas tener instalados los encabezados de Python. En Ubuntu, ejecuta `sudo apt-get install python-dev`; en Fedora, usa `sudo yum install python-devel`. Luego instala vía pip: `pip install flanker`. Alternativamente, clona el repositorio [flanker GitHub](https://github.com/mailgun/flanker) y ejecuta `pip install -e .`. La biblioteca es ligera, con dependencias mínimas, y está lista para uso en producción. La documentación detallada y las referencias de la API están disponibles en el repositorio GitHub del proyecto.

Instalar flanker vía PIP o GitHub

# Ubuntu: install Python headers
sudo apt-get install python-dev

# Install via pip
pip install flanker

# Or clone and install from GitHub
git clone git@github.com:mailgun/flanker.git
cd flanker
pip install -e .

Analizar y validar direcciones de correo electrónico

flanker ofrece herramientas potentes para analizar y validar direcciones de correo electrónico. Puedes analizar una única dirección con nombre para mostrar, validar contra registros DNS/MX y comprobar las reglas gramaticales de los ESP. La biblioteca admite modos de análisis estricto y flexible, y puede devolver direcciones analizadas o `None` para entradas inválidas. También maneja listas de direcciones, devolviendo direcciones analizadas y fragmentos no analizables por separado. Esto lo hace ideal para limpiar la entrada de usuarios, validar importaciones masivas y garantizar la integridad de los datos en flujos de trabajo impulsados por correo electrónico.

¿Cómo analizar y validar direcciones de correo electrónico mediante Python?

from flanker.addresslib import address

# Parse single address with display name
addr = address.parse('John Doe <john@example.com>')
print(addr)  # John Doe <john@example.com>

# Validate with DNS/MX checks
valid = address.validate_address('john@mailgun.com')
print(valid)  # john@mailgun.com

# Parse list and separate valid/unparseable
parsed, failed = address.parse_list(['john@example.com, @invalid'], as_tuple=True)
print(parsed, failed)  # [john@example.com], ['@invalid']

Analizar mensajes MIME

El módulo de análisis MIME de flanker (`flanker.mime`) permite a los desarrolladores analizar mensajes de correo electrónico sin procesar en objetos estructurados de Python. Puedes extraer encabezados, decodificar cuerpos, detectar tipos de contenido y navegar por estructuras multipartes con facilidad. La biblioteca maneja la codificación, la conversión de juego de caracteres y las partes MIME anidadas automáticamente. Con predicados como `is_multipart()` y `is_singlepart()`, puedes inspeccionar programáticamente la estructura del mensaje y procesar cada parte en consecuencia—ideal para crear clientes de correo electrónico, sistemas de archivado o pipelines de procesamiento automatizado.

¿Cómo analizar mensajes MIME y extraer encabezados y cuerpos?

from flanker import mime

# Parse raw MIME message
msg = mime.from_string(raw_message)

# Extract headers
headers = msg.headers.items()

# Check content type
is_multipart = msg.content_type.is_multipart()

# Decode body (handles multipart automatically)
for part in msg.parts:
    print(f"Content-Type: {part.content_type}")
    print(f"Body: {part.body}")

Extraer encabezados y metadatos

flanker ofrece un acceso completo a los encabezados y metadatos de correo electrónico a través de su API de análisis MIME. Los encabezados se devuelven como un diccionario Unicode de múltiples valores, compatible con búsquedas sin distinción de mayúsculas y minúsculas y valores estructurados (p. ej., `Content-Type` analizado en tipo y parámetros). Puedes recuperar el remitente, el destinatario, el asunto, la fecha y los encabezados personalizados con facilidad. Esto es especialmente útil para la indexación de correos, filtrado de spam, auditoría de cumplimiento y la creación de archivos de correo amigables con la búsqueda donde el análisis preciso de los encabezados es crítico.

¿Cómo extraer encabezados y metadatos de correo electrónico mediante Python?

from flanker import mime

msg = mime.from_string(raw_message)

# Get all headers as list of tuples
for key, value in msg.headers.items():
    print(f"{key}: {value}")

# Access structured content-type
ctype = msg.content_type
print(f"Type: {ctype.type}, Boundary: {ctype.boundary}")

# Get raw header value
raw_from = msg.headers.get('From')
print(raw_from)  # Bob <bob@example.com>

Gestionar mensajes multipartes y archivos adjuntos

flanker simplifica el trabajo con mensajes multipartes complejos, incluidos aquellos con partes anidadas y adjuntos. Puedes iterar sobre `msg.parts` para acceder a cada parte MIME, inspeccionar su tipo de contenido y decodificar su cuerpo. La biblioteca maneja automáticamente la decodificación base64 y quoted‑printable, la conversión de juego de caracteres y la detección de límites. Esto hace que sea sencillo extraer versiones text/plain y text/html, guardar adjuntos o reconstruir mensajes para reenvío o archivado, ideal para clientes de correo electrónico, herramientas de respaldo y sistemas de cumplimiento.

¿Cómo procesar mensajes multipartes y extraer archivos adjuntos?

from flanker import mime

msg = mime.from_string(raw_message)

# Iterate over parts
for part in msg.parts:
    if part.content_type.is_text():
        print(f"Text part: {part.body}")
    elif part.content_type.is_attachment():
        filename = part.content_type.filename
        payload = part.body
        print(f"Attachment: {filename}, size: {len(payload)}")
 Español