1. Prodotti
  2.   E-mail
  3.   Python
  4.   flanker

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.

Previous Next

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)}")
 Italiano