
flanker
Open Source Python-bibliotheek voor e-mailparsing
Parse e-mailadressen, valideer adressen & parse MIME-berichten via Open Source gratis Python-API.
Wat is flanker?
flanker is een open source Python-bibliotheek ontwikkeld door Mailgun voor het parseren van e-mailadressen en MIME-berichten. Het biedt robuuste tools voor het valideren van e-mailadressen, het parseren van complexe adressenlijsten en het extraheren van gestructureerde gegevens uit MIME-berichten. Ontworpen voor productiegebruik ondersteunt flanker zowel Python 2.7 als Python 3.6+, waardoor het ideaal is voor ontwikkelaars die e-mailintensieve toepassingen bouwen, zoals mailverwerkingspijplijnen, CRM-integraties en notificatiesystemen.
De bibliotheek bestaat uit twee kernmodules: `flanker.addresslib` voor het parseren en valideren van e-mailadressen, en `flanker.mime` voor het parseren van MIME-berichten. Het ondersteunt strikte en losse parseermodi, DNS/MX-recordvalidatie en gedetailleerde foutrapportage. Met zijn schone API en minimale afhankelijkheden stelt flanker ontwikkelaars in staat om e-mailgegevens betrouwbaar te verwerken zonder afhankelijk te zijn van externe binaries of complexe afhankelijkheden. Het brede gebruik in de infrastructuur van Mailgun zorgt voor stabiliteit en prestaties in omgevingen met een hoog volume.
Aan de slag met flanker
Om te beginnen met flanker, moet je eerst de Python-headers geïnstalleerd hebben. Op Ubuntu voer je `sudo apt-get install python-dev` uit; op Fedora gebruik je `sudo yum install python-devel`. Installeer vervolgens via pip: `pip install flanker`. Als alternatief kun je de [flanker GitHub](https://github.com/mailgun/flanker) repository klonen en `pip install -e .` uitvoeren. De bibliotheek is lichtgewicht, met minimale afhankelijkheden, en klaar voor productiegebruik. Gedetailleerde documentatie en API-referenties zijn beschikbaar in de GitHub-repository van het project.
Installeer flanker via PIP of 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 .
E-mailadressen parseren en valideren
flanker biedt krachtige tools voor het parseren en valideren van e-mailadressen. Je kunt een enkel adres met weergavenaam parseren, valideren tegen DNS/MX-records, en ESP-grammatica regels controleren. De bibliotheek ondersteunt strikte en losse parseermodi, en kan geparseerde adressen of `None` retourneren voor ongeldige invoer. Het verwerkt ook adressenlijsten, waarbij geparseerde adressen en niet-parseerbare fragmenten afzonderlijk worden geretourneerd. Dit maakt het ideaal voor het opschonen van gebruikersinvoer, het valideren van bulkimporten, en het waarborgen van gegevensintegriteit in e-mailgestuurde workflows.
Hoe e-mailadressen parseren en valideren 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']
MIME-berichten parseren
De MIME‑parsingmodule van flanker (`flanker.mime`) stelt ontwikkelaars in staat om ruwe e‑mailberichten te parseren naar gestructureerde Python‑objecten. U kunt headers extraheren, bodies decoderen, content‑types detecteren en multipart‑structuren moeiteloos doorlopen. De bibliotheek verwerkt codering, charset‑conversie en geneste MIME‑onderdelen automatisch. Met predicaten zoals `is_multipart()` en `is_singlepart()` kunt u programmatisch de berichtstructuur inspecteren en elk onderdeel dienovereenkomstig verwerken — ideaal voor het bouwen van e‑mailclients, archiveringssystemen of geautomatiseerde verwerkingspijplijnen.
Hoe MIME-berichten te parseren en headers & bodies te extraheren?
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}")
Headers en metadata extraheren
flanker biedt uitgebreide toegang tot e‑mailheaders en metadata via zijn MIME‑parsing‑API. Headers worden geretourneerd als een Unicode multi‑value dictionary, die case‑insensitieve zoekopdrachten en gestructureerde waarden ondersteunt (bijv. `Content-Type` geparseerd in type en parameters). U kunt afzender, ontvanger, onderwerp, datum en aangepaste headers moeiteloos ophalen. Dit is bijzonder nuttig voor e‑mailindexering, spamfiltering, compliance‑audits en het bouwen van zoekvriendelijke e‑mailarchieven waar nauwkeurige header‑parsing cruciaal is.
Hoe e-mailheaders en metadata te extraheren via 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>
Multipart-berichten en bijlagen verwerken
flanker vereenvoudigt het werken met complexe multipart‑berichten, inclusief die met geneste delen en bijlagen. Je kunt itereren over `msg.parts` om elk MIME‑deel te benaderen, het contenttype te inspecteren en de body te decoderen. De bibliotheek behandelt automatisch base64‑ en quoted‑printable‑decodering, charset‑conversie en grensdetectie. Dit maakt het eenvoudig om text/plain‑ en text/html‑versies te extraheren, bijlagen op te slaan, of berichten opnieuw op te bouwen voor doorsturen of archivering — ideaal voor e‑mailclients, back‑uptools en compliance‑systemen.
Hoe multipart-berichten te verwerken en bijlagen te extraheren?
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)}")
