
flanker
Bibliothèque Python open source pour l'analyse d'e-mails
Analyser les adresses e-mail, valider les adresses et analyser les messages MIME via une API Python gratuite et open source.
Qu'est-ce que flanker ?
flanker est une bibliothèque Python open source développée par Mailgun pour analyser les adresses e‑mail et les messages MIME. Elle fournit des outils robustes pour valider les adresses e‑mail, analyser des listes d’adresses complexes et extraire des données structurées à partir des messages MIME. Conçue pour une utilisation en production, flanker prend en charge à la fois Python 2.7 et Python 3.6+, ce qui la rend idéale pour les développeurs créant des applications fortement axées sur l’e‑mail telles que les pipelines de traitement du courrier, les intégrations CRM et les systèmes de notification.
La bibliothèque se compose de deux modules principaux : `flanker.addresslib` pour analyser et valider les adresses e‑mail, et `flanker.mime` pour analyser les messages MIME. Elle prend en charge les modes d’analyse stricts et souples, la validation des enregistrements DNS/MX et la génération de rapports d’erreurs détaillés. Grâce à son API claire et à ses dépendances minimales, flanker permet aux développeurs de traiter les données e‑mail de manière fiable sans dépendre de binaires externes ou de dépendances complexes. Son utilisation répandue dans l’infrastructure de Mailgun garantit stabilité et performances dans des environnements à fort volume.
Premiers pas avec flanker
Pour commencer avec flanker, vous devez d'abord installer les en‑têtes Python. Sous Ubuntu, exécutez `sudo apt-get install python-dev` ; sous Fedora, utilisez `sudo yum install python-devel`. Ensuite, installez via pip : `pip install flanker`. Vous pouvez également cloner le dépôt [flanker GitHub](https://github.com/mailgun/flanker) et exécuter `pip install -e .`. La bibliothèque est légère, avec des dépendances minimales, et prête à être utilisée en production. Une documentation détaillée et des références API sont disponibles dans le dépôt GitHub du projet.
Installer flanker via PIP ou 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 .
Analyser et valider les adresses e‑mail
flanker fournit des outils puissants pour analyser et valider les adresses e‑mail. Vous pouvez analyser une adresse unique avec un nom d’affichage, valider contre les enregistrements DNS/MX et vérifier les règles grammaticales des ESP. La bibliothèque prend en charge les modes d’analyse stricts et souples, et peut renvoyer les adresses analysées ou `None` pour les entrées invalides. Elle gère également les listes d’adresses, renvoyant séparément les adresses analysées et les fragments non analysables. Cela la rend idéale pour nettoyer les saisies utilisateur, valider les importations en masse et garantir l’intégrité des données dans les flux de travail basés sur les e‑mail.
Comment analyser et valider les adresses e‑mail via 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']
Analyser les messages MIME
Le module d'analyse MIME de flanker (`flanker.mime`) permet aux développeurs d'analyser des messages électroniques bruts en objets Python structurés. Vous pouvez extraire les en-têtes, décoder les corps, détecter les types de contenu et naviguer facilement dans les structures multiparties. La bibliothèque gère automatiquement l'encodage, la conversion de jeu de caractères et les parties MIME imbriquées. Avec des prédicats comme `is_multipart()` et `is_singlepart()`, vous pouvez inspecter programmétiquement la structure du message et traiter chaque partie en conséquence—idéal pour créer des clients de messagerie, des systèmes d'archivage ou des pipelines de traitement automatisés.
Comment analyser les messages MIME et extraire les en‑têtes et le corps ?
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}")
Extraire les en‑têtes et les métadonnées
flanker offre un accès complet aux en-têtes et aux métadonnées des e‑mails via son API d'analyse MIME. Les en-têtes sont renvoyés sous forme de dictionnaire multi‑valeurs Unicode, prenant en charge les recherches insensibles à la casse et les valeurs structurées (par exemple, `Content-Type` analysé en type et paramètres). Vous pouvez récupérer l'expéditeur, le destinataire, l'objet, la date et les en-têtes personnalisés facilement. Cela est particulièrement utile pour l'indexation des e‑mails, le filtrage du spam, l'audit de conformité et la création d'archives d'e‑mail optimisées pour la recherche où une analyse précise des en-têtes est cruciale.
Comment extraire les en‑têtes d’e‑mail et les métadonnées avec 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>
Gérer les messages multiparties et les pièces jointes
flanker simplifie le travail avec des messages multiparties complexes, y compris ceux contenant des parties imbriquées et des pièces jointes. Vous pouvez itérer sur `msg.parts` pour accéder à chaque partie MIME, inspecter son type de contenu et décoder son corps. La bibliothèque gère automatiquement le décodage base64 et quoted‑printable, la conversion du jeu de caractères et la détection des limites. Cela rend simple l'extraction des versions text/plain et text/html, l'enregistrement des pièces jointes, ou la reconstruction des messages pour le transfert ou l'archivage — idéal pour les clients de messagerie, les outils de sauvegarde et les systèmes de conformité.
Comment traiter les messages multipart et extraire les pièces jointes ?
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)}")
