
flanker
Libreria Python Open Source per l'Analisi delle Email
Analizza Indirizzi Email, Convalida Indirizzi e Analizza Messaggi MIME tramite API Python Gratuita Open Source.
Cos'è flanker?
flanker è una libreria Python open source sviluppata da Mailgun per l'analisi degli indirizzi email e dei messaggi MIME. Fornisce strumenti solidi per la convalida degli indirizzi email, l'analisi di elenchi di indirizzi complessi e l'estrazione di dati strutturati dai messaggi MIME. Progettata per l'uso in produzione, flanker supporta sia Python 2.7 sia Python 3.6+, rendendola ideale per gli sviluppatori che creano applicazioni con un alto volume di email, come pipeline di elaborazione della posta, integrazioni CRM e sistemi di notifica.
La libreria è composta da due moduli principali: `flanker.addresslib` per l'analisi e la convalida degli indirizzi email, e `flanker.mime` per l'analisi dei messaggi MIME. Supporta modalità di analisi rigorose e permissive, la convalida dei record DNS/MX e una segnalazione dettagliata degli errori. Con la sua API pulita e dipendenze minime, flanker consente agli sviluppatori di elaborare in modo affidabile i dati email senza fare affidamento su binari esterni o dipendenze complesse. Il suo ampio utilizzo nell'infrastruttura di Mailgun garantisce stabilità e prestazioni in ambienti ad alto volume.
Iniziare con flanker
Per iniziare con flanker, è necessario installare prima le intestazioni di Python. Su Ubuntu, esegui `sudo apt-get install python-dev`; su Fedora, usa `sudo yum install python-devel`. Quindi installa tramite pip: `pip install flanker`. In alternativa, clona il repository [flanker GitHub](https://github.com/mailgun/flanker) e esegui `pip install -e .`. La libreria è leggera, con dipendenze minime, ed è pronta per l'uso in produzione. Documentazione dettagliata e riferimenti API sono disponibili nel repository GitHub del progetto.
Installa flanker tramite 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 .
Analizza e valida gli indirizzi email
flanker fornisce potenti strumenti per l'analisi e la convalida degli indirizzi email. È possibile analizzare un singolo indirizzo con nome visualizzato, convalidare rispetto ai record DNS/MX e verificare le regole grammaticali ESP. La libreria supporta modalità di analisi rigide e permissive, e può restituire gli indirizzi analizzati o `None` per input non validi. Gestisce anche le liste di indirizzi, restituendo separatamente gli indirizzi analizzati e i frammenti non analizzabili. Questo la rende ideale per pulire l'input degli utenti, convalidare importazioni di massa e garantire l'integrità dei dati nei flussi di lavoro basati su email.
Come analizzare e validare gli indirizzi email con 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']
Analizza i messaggi MIME
Il modulo di parsing MIME di flanker (`flanker.mime`) consente agli sviluppatori di analizzare messaggi email grezzi in oggetti Python strutturati. È possibile estrarre le intestazioni, decodificare i corpi, rilevare i tipi di contenuto e navigare facilmente nelle strutture multipart. La libreria gestisce automaticamente la codifica, la conversione del set di caratteri e le parti MIME annidate. Con predicati come `is_multipart()` e `is_singlepart()`, è possibile ispezionare programmaticamente la struttura del messaggio e processare ogni parte di conseguenza—ideale per creare client email, sistemi di archiviazione o pipeline di elaborazione automatizzata.
Come analizzare i messaggi MIME ed estrarre intestazioni e corpi?
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}")
Estrai intestazioni e metadati
flanker offre un accesso completo alle intestazioni email e ai metadati tramite la sua API di parsing MIME. Le intestazioni vengono restituite come un dizionario Unicode a valori multipli, supportando ricerche case-insensitive e valori strutturati (ad esempio, `Content-Type` analizzato in tipo e parametri). È possibile recuperare mittente, destinatario, oggetto, data e intestazioni personalizzate con facilità. Questo è particolarmente utile per l'indicizzazione delle email, il filtraggio dello spam, la verifica di conformità e la creazione di archivi email ottimizzati per la ricerca, dove il parsing preciso delle intestazioni è fondamentale.
Come estrarre le intestazioni email e i metadati tramite 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>
Gestisci messaggi multipart e allegati
flanker semplifica la gestione di messaggi multipart complessi, inclusi quelli con parti nidificate e allegati. È possibile iterare su `msg.parts` per accedere a ciascuna parte MIME, ispezionare il suo tipo di contenuto e decodificare il corpo. La libreria gestisce automaticamente la decodifica base64 e quoted‑printable, la conversione del set di caratteri e il rilevamento dei confini. Questo rende semplice estrarre le versioni text/plain e text/html, salvare gli allegati o ricostruire i messaggi per l'inoltro o l'archiviazione—ideale per client di posta elettronica, strumenti di backup e sistemi di conformità.
Come elaborare i messaggi multipart e estrarre gli allegati?
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)}")
