1. Produkte
  2.   Email
  3.   Python
  4.   flanker

flanker

 
 

Open-Source-Python-Bibliothek für das Parsen von E-Mails

E-Mail-Adressen parsen, Adressen validieren & MIME-Nachrichten über Open-Source kostenlose Python-API parsen.

Was ist flanker?

flanker ist eine Open‑Source‑Python‑Bibliothek, die von Mailgun zur Analyse von E‑Mail‑Adressen und MIME‑Nachrichten entwickelt wurde. Sie bietet robuste Werkzeuge zur Validierung von E‑Mail‑Adressen, zum Parsen komplexer Adresslisten und zum Extrahieren strukturierter Daten aus MIME‑Nachrichten. Für den Produktionseinsatz konzipiert, unterstützt flanker sowohl Python 2.7 als auch Python 3.6+, was es ideal für Entwickler macht, die e‑mail‑intensive Anwendungen wie Mail‑Verarbeitungspipelines, CRM‑Integrationen und Benachrichtigungssysteme bauen.

Die Bibliothek besteht aus zwei Kernmodulen: `flanker.addresslib` zum Parsen und Validieren von E‑Mail‑Adressen und `flanker.mime` zum Parsen von MIME‑Nachrichten. Sie unterstützt strenge und lockere Parsing‑Modi, DNS/MX‑Record‑Validierung und detaillierte Fehlermeldungen. Mit ihrer sauberen API und minimalen Abhängigkeiten ermöglicht flanker Entwicklern, E‑Mail‑Daten zuverlässig zu verarbeiten, ohne auf externe Binärdateien oder komplexe Abhängigkeiten angewiesen zu sein. Ihre weit verbreitete Nutzung in der Infrastruktur von Mailgun sorgt für Stabilität und Leistung in Hochvolumen‑Umgebungen.

Previous Next

Erste Schritte mit flanker

Um mit flanker zu beginnen, müssen zunächst die Python‑Header installiert sein. Unter Ubuntu führen Sie `sudo apt-get install python-dev` aus; unter Fedora verwenden Sie `sudo yum install python-devel`. Installieren Sie dann über pip: `pip install flanker`. Alternativ klonen Sie das [flanker GitHub](https://github.com/mailgun/flanker)‑Repository und führen `pip install -e .` aus. Die Bibliothek ist leichtgewichtig, hat minimale Abhängigkeiten und ist bereit für den Produktionseinsatz. Detaillierte Dokumentation und API‑Referenzen sind im GitHub‑Repository des Projekts verfügbar.

flanker über PIP oder GitHub installieren

# 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 .

E-Mail-Adressen analysieren und validieren

flanker bietet leistungsstarke Werkzeuge zum Parsen und Validieren von E‑Mail‑Adressen. Sie können eine einzelne Adresse mit Anzeigenamen parsen, gegen DNS/MX‑Einträge validieren und ESP‑Grammatikregeln prüfen. Die Bibliothek unterstützt strenge und lockere Pars‑Modi und kann geparste Adressen oder `None` für ungültige Eingaben zurückgeben. Sie verarbeitet auch Adresslisten und gibt geparste Adressen sowie nicht parsbare Fragmente getrennt zurück. Das macht sie ideal zum Bereinigen von Benutzereingaben, Validieren von Massenimporten und zur Sicherstellung der Datenintegrität in e‑mail‑basierten Workflows.

Wie analysiert und validiert man E-Mail-Adressen mit 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']

MIME-Nachrichten analysieren

Das MIME‑Parsing‑Modul von flanker (`flanker.mime`) ermöglicht Entwicklern, rohe E‑Mail‑Nachrichten in strukturierte Python‑Objekte zu parsen. Sie können Header extrahieren, Bodies dekodieren, Inhaltstypen erkennen und Multipart‑Strukturen mühelos navigieren. Die Bibliothek übernimmt automatisch die Kodierung, Zeichensatzkonvertierung und verschachtelte MIME‑Teile. Mit Prädikaten wie `is_multipart()` und `is_singlepart()` können Sie programmgesteuert die Nachrichtenstruktur untersuchen und jeden Teil entsprechend verarbeiten – ideal zum Erstellen von E‑Mail‑Clients, Archivierungssystemen oder automatisierten Verarbeitungspipelines.

Wie man MIME-Nachrichten analysiert und Header & Body extrahiert?

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

Header und Metadaten extrahieren

flanker bietet über seine MIME‑Parsing‑API umfangreichen Zugriff auf E‑Mail‑Header und Metadaten. Header werden als Unicode‑Mehrwert‑Dictionary zurückgegeben, das fallunabhängige Lookups und strukturierte Werte unterstützt (z. B. wird `Content-Type` in Typ und Parameter zerlegt). Sie können Absender, Empfänger, Betreff, Datum und benutzerdefinierte Header mühelos abrufen. Das ist besonders nützlich für die E‑Mail‑Indexierung, Spam‑Filterung, Compliance‑Audits und den Aufbau suchfreundlicher E‑Mail‑Archive, bei denen eine präzise Header‑Analyse entscheidend ist.

Wie man E‑Mail‑Header und Metadaten mit Python extrahiert?

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>

Multipart-Nachrichten und Anhänge verarbeiten

flanker vereinfacht die Arbeit mit komplexen Multipart-Nachrichten, einschließlich solcher mit verschachtelten Teilen und Anhängen. Sie können über `msg.parts` iterieren, um jeden MIME-Teil zuzugreifen, dessen Content-Type zu prüfen und den Body zu dekodieren. Die Bibliothek übernimmt automatisch die Dekodierung von Base64 und quoted-printable, die Zeichensatzkonvertierung und die Erkennung von Boundaries. Das macht es einfach, text/plain- und text/html-Versionen zu extrahieren, Anhänge zu speichern oder Nachrichten zum Weiterleiten oder Archivieren neu zu erstellen – ideal für E-Mail-Clients, Backup-Tools und Compliance-Systeme.

Wie man Multipart‑Nachrichten verarbeitet und Anhänge extrahiert?

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