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

flanker

 
 

Bibliotecă Python open source pentru parsarea emailurilor

Analizați adresele de email, validați adresele și parsați mesajele MIME prin API Python gratuit și open source.

Ce este flanker?

flanker este o bibliotecă open source pentru Python dezvoltată de Mailgun pentru parsarea adreselor de e-mail și a mesajelor MIME. Oferă instrumente robuste pentru validarea adreselor de e-mail, parsarea listelor complexe de adrese și extragerea datelor structurate din mesajele MIME. Concepută pentru utilizare în producție, flanker suportă atât Python 2.7, cât și Python 3.6+, făcând-o ideală pentru dezvoltatorii care construiesc aplicații cu volum mare de e-mailuri, cum ar fi conductele de procesare a poștei, integrările CRM și sistemele de notificare.

Biblioteca constă din două module de bază: `flanker.addresslib` pentru parsarea și validarea adreselor de e-mail, și `flanker.mime` pentru parsarea mesajelor MIME. Suportă moduri de parsare stricte și permisive, validarea înregistrărilor DNS/MX și raportarea detaliată a erorilor. Cu API-ul său curat și dependențe minime, flanker permite dezvoltatorilor să proceseze în mod fiabil datele de e-mail fără a se baza pe binare externe sau dependențe complexe. Utilizarea sa pe scară largă în infrastructura Mailgun asigură stabilitate și performanță în medii cu volum mare.

Previous Next

Începerea cu flanker

Pentru a începe cu flanker, trebuie mai întâi să aveți instalate antetele Python. Pe Ubuntu, rulați `sudo apt-get install python-dev`; pe Fedora, folosiți `sudo yum install python-devel`. Apoi instalați prin pip: `pip install flanker`. Alternativ, clonați depozitul [flanker GitHub](https://github.com/mailgun/flanker) și rulați `pip install -e .`. Biblioteca este ușoară, cu dependențe minime, și pregătită pentru utilizare în producție. Documentația detaliată și referințele API sunt disponibile în depozitul GitHub al proiectului.

Instalați flanker prin PIP sau 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 .

Analizați și validați adresele de email

flanker oferă instrumente puternice pentru parsarea și validarea adreselor de email. Puteți parsa o singură adresă cu numele afișat, valida împotriva înregistrărilor DNS/MX și verifica regulile gramaticale ESP. Biblioteca suportă moduri de parsare stricte și permisive și poate returna adrese parsate sau `None` pentru intrări invalide. De asemenea, gestionează liste de adrese, returnând separat adresele parsate și fragmentele neparsabile. Acest lucru îl face ideal pentru curățarea intrărilor utilizatorilor, validarea importurilor în masă și asigurarea integrității datelor în fluxurile de lucru bazate pe email.

Cum să analizați și să validați adresele de email prin 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']

Analizați mesajele MIME

modulul de parsare MIME al flanker (`flanker.mime`) permite dezvoltatorilor să analizeze mesajele de e‑mail brute în obiecte Python structurate. Poți extrage antetele, decoda corpurile, detecta tipurile de conținut și naviga cu ușurință prin structurile multipart. Biblioteca gestionează automat codificarea, conversia setului de caractere și părțile MIME imbricate. Cu predicate precum `is_multipart()` și `is_singlepart()`, poți inspecta programatic structura mesajului și procesa fiecare parte în consecință—ideal pentru construirea de clienți de e‑mail, sisteme de arhivare sau conducte de procesare automate.

Cum să parsezi mesajele MIME și să extragi anteturile și corpurile?

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

Extrageți anteturile și metadatele

flanker oferă acces extins la antetele de e‑mail și metadatele acestora prin API‑ul său de parsare MIME. Antetele sunt returnate ca un dicționar Unicode cu valori multiple, suportând căutări insensibile la majuscule și valori structurate (de exemplu, `Content-Type` analizat în tip și parametri). Poți recupera expeditorul, destinatarul, subiectul, data și antetele personalizate cu ușurință. Acest lucru este deosebit de util pentru indexarea e‑mailurilor, filtrarea spamului, auditul de conformitate și construirea de arhive de e‑mail prietenoase cu căutarea, unde parsarea precisă a antetelor este esențială.

Cum să extragi anteturile de e-mail și metadatele prin 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>

Gestionați mesajele multipart și atașamentele

flanker simplifică lucrul cu mesaje multipart complexe, inclusiv cele cu părţi imbricate şi atașamente. Poţi itera peste `msg.parts` pentru a accesa fiecare parte MIME, a inspecta tipul său de conţinut şi a decoda corpul. Biblioteca gestionează automat decodarea base64 şi quoted‑printable, conversia setului de caractere şi detectarea limitelor. Acest lucru face uşor să extragi versiunile text/plain şi text/html, să salvezi atașamentele sau să reconstruieşti mesajele pentru redirecţionare sau arhivare — ideal pentru clienţi de email, instrumente de backup şi sisteme de conformitate.

Cum să procesezi mesajele multipart și să extragi atașamentele?

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)}")
 Română