
flanker
Åpen kildekode Python-bibliotek for e-postanalyse
Analyser e-postadresser, valider adresser og analyser MIME-meldinger via åpen kildekode gratis Python-API.
Hva er flanker?
`flanker` er et åpen kildekode Python‑bibliotek utviklet av `Mailgun` for å analysere e‑postadresser og MIME‑meldinger. Det gir robuste verktøy for validering av e‑postadresser, parsing av komplekse adresselister og uthenting av strukturerte data fra MIME‑meldinger. Designet for produksjonsbruk støtter `flanker` både `Python 2.7` og `Python 3.6+`, noe som gjør det ideelt for utviklere som bygger e‑posttunge applikasjoner som e‑postbehandlings‑pipelines, CRM‑integrasjoner og varslingssystemer.
Biblioteket består av to kjerne‑moduler: `flanker.addresslib` for parsing og validering av e‑postadresser, og `flanker.mime` for parsing av MIME‑meldinger. Det støtter strenge og lempelige parse‑moduser, DNS/MX‑postvalidering og detaljert feilrapportering. Med sitt rene API og minimale avhengigheter gjør `flanker` det mulig for utviklere å pålitelig behandle e‑postdata uten å være avhengig av eksterne binærfiler eller komplekse avhengigheter. Dets omfattende bruk i Mailgun’s infrastruktur sikrer stabilitet og ytelse i miljøer med høyt volum.
Kom i gang med flanker
For å komme i gang med flanker, må du først ha Python‑headerne installert. På Ubuntu kjører du `sudo apt-get install python-dev`; på Fedora bruker du `sudo yum install python-devel`. Deretter installerer du via pip: `pip install flanker`. Alternativt kan du klone [flanker GitHub](https://github.com/mailgun/flanker)-repoet og kjøre `pip install -e .`. Biblioteket er lettvektig, med minimale avhengigheter, og klar for produksjonsbruk. Detaljert dokumentasjon og API‑referanser er tilgjengelige i prosjektets GitHub‑repo.
Installer flanker via PIP eller 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 og valider e‑postadresser
flanker tilbyr kraftige verktøy for parsning og validering av e‑postadresser. Du kan parsere en enkelt adresse med visningsnavn, validere mot DNS/MX‑poster, og sjekke ESP‑grammatikkregler. Biblioteket støtter strenge og lempelige parsingsmoduser, og kan returnere parsede adresser eller `None` for ugyldige innspill. Det håndterer også adresselister, og returnerer parsede adresser og uparsbare fragmenter separat. Dette gjør det ideelt for å rense brukerinput, validere masseimporter, og sikre dataintegritet i e‑post‑drevede arbeidsflyter.
Hvordan analysere og validere e‑postadresser 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 MIME‑meldinger
flankers MIME‑parsingmodul (`flanker.mime`) gjør det mulig for utviklere å analysere rå e‑postmeldinger til strukturerte Python‑objekter. Du kan hente ut overskrifter, dekode innhold, oppdage innholdstyper og navigere i multipart‑strukturer med letthet. Biblioteket håndterer koding, tegnsettkonvertering og nestede MIME‑deler automatisk. Med predikater som `is_multipart()` og `is_singlepart()`, kan du programmatisk inspisere meldingsstrukturen og behandle hver del deretter—ideelt for å bygge e‑postklienter, arkiveringssystemer eller automatiserte behandlings‑pipelines.
Hvordan analysere MIME-meldinger og hente ut overskrifter & innhold?
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}")
Utdra overskrifter og metadata
flanker gir rik tilgang til e‑post‑overskrifter og metadata gjennom sitt MIME‑parsing‑API. Overskrifter returneres som en Unicode‑flervalg‑ordbok, som støtter case‑insensitive oppslag og strukturerte verdier (f.eks. `Content-Type` analysert til type og parametere). Du kan hente avsender, mottaker, emne, dato og egendefinerte overskrifter med letthet. Dette er spesielt nyttig for e‑post‑indeksering, spam‑filtrering, samsvarsrevisjon og bygging av søkevennlige e‑postarkiver hvor nøyaktig overskriftsparsing er kritisk.
Hvordan hente ut e‑postoverskrifter og metadata 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>
Håndter multipart‑meldinger og vedlegg
flanker forenkler arbeidet med komplekse multipart-meldinger, inkludert de med nestede deler og vedlegg. Du kan iterere over `msg.parts` for å få tilgang til hver MIME-del, inspisere innholdstypen og dekode kroppen. Biblioteket håndterer automatisk base64- og quoted-printable-dekoding, tegnsettkonvertering og grensedeteksjon. Dette gjør det enkelt å hente ut text/plain- og text/html-versjoner, lagre vedlegg, eller bygge meldinger på nytt for videresending eller arkivering – ideelt for e‑postklienter, sikkerhetskopieringsverktøy og etterlevelsesystemer.
Hvordan behandle multipart‑meldinger og hente ut vedlegg?
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)}")
