
flanker
Öppen källkod Python-bibliotek för e-postanalys
Analysera e-postadresser, validera adresser & analysera MIME-meddelanden via öppen källkod gratis Python-API.
Vad är flanker?
flanker är ett open source‑Python‑bibliotek utvecklat av Mailgun för att parsra e‑postadresser och MIME‑meddelanden. Det erbjuder robusta verktyg för validering av e‑postadresser, parsning av komplexa adresslistor och extrahering av strukturerad data från MIME‑meddelanden. Designat för produktionsbruk stödjer flanker både Python 2.7 och Python 3.6+, vilket gör det idealiskt för utvecklare som bygger e‑posttunga applikationer såsom e‑postprocesseringspipelines, CRM‑integrationer och notifikationssystem.
Biblioteket består av två kärnmoduler: `flanker.addresslib` för parsning och validering av e‑postadresser, och `flanker.mime` för parsning av MIME‑meddelanden. Det stödjer strikta och flexibla parsningslägen, DNS/MX‑postvalidering och detaljerad felrapportering. Med sitt rena API och minimala beroenden gör flanker det möjligt för utvecklare att på ett pålitligt sätt bearbeta e‑postdata utan att förlita sig på externa binärer eller komplexa beroenden. Dess omfattande användning i Mailguns infrastruktur säkerställer stabilitet och prestanda i högvolymmiljöer.
Komma igång med flanker
För att komma igång med flanker måste du först ha Python‑huvuden installerade. På Ubuntu kör du `sudo apt-get install python-dev`; på Fedora använder du `sudo yum install python-devel`. Installera sedan via pip: `pip install flanker`. Alternativt klonar du [flanker GitHub](https://github.com/mailgun/flanker) repo och kör `pip install -e .`. Biblioteket är lättviktigt, med minimala beroenden, och klart för produktionsbruk. Detaljerad dokumentation och API‑referenser finns i projektets GitHub‑arkiv.
Installera 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 .
Analysera och validera e‑postadresser
flanker tillhandahåller kraftfulla verktyg för att parsra och validera e‑postadresser. Du kan parsra en enskild adress med visningsnamn, validera mot DNS/MX‑poster och kontrollera ESP‑grammatikregler. Biblioteket stödjer både strikt och tolerant parsning, och kan returnera parsade adresser eller `None` för ogiltiga inmatningar. Det hanterar också adresslistor och returnerar parsade adresser och oparsbara fragment separat. Detta gör det idealiskt för att rensa användarinmatning, validera massimporter och säkerställa dataintegritet i e‑postdrivna arbetsflöden.
Hur analyserar och validerar man 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']
Analysera MIME‑meddelanden
flankers MIME‑parsningsmodul (`flanker.mime`) gör det möjligt för utvecklare att parsra råa e‑postmeddelanden till strukturerade Python‑objekt. Du kan extrahera rubriker, avkoda kroppar, upptäcka innehållstyper och navigera i multipart‑strukturer med lätthet. Biblioteket hanterar kodning, teckenkodningskonvertering och nästlade MIME‑delar automatiskt. Med predikat som `is_multipart()` och `is_singlepart()` kan du programatiskt inspektera meddelandestrukturen och bearbeta varje del därefter—idealiskt för att bygga e‑postklienter, arkiveringssystem eller automatiserade bearbetningspipeline.
Hur man analyserar MIME-meddelanden och extraherar rubriker och kroppar?
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}")
Extrahera rubriker och metadata
flanker ger rik tillgång till e‑postrubriker och metadata via sitt MIME‑parsnings‑API. Rubriker returneras som en Unicode‑dictionary med flera värden, vilket stödjer skiftlägesokänsliga uppslag och strukturerade värden (t.ex. `Content-Type` parsrat till typ och parametrar). Du kan enkelt hämta avsändare, mottagare, ämne, datum och anpassade rubriker. Detta är särskilt användbart för e‑postindexering, skräppostfiltrering, efterlevnadsgranskning och för att bygga sökvänliga e‑postarkiv där exakt rubrikparsning är kritisk.
Hur man extraherar e-postrubriker och 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>
Hantera multipart‑meddelanden och bilagor
flanker förenklar arbete med komplexa multipart‑meddelanden, inklusive sådana med nästlade delar och bilagor. Du kan iterera över `msg.parts` för att komma åt varje MIME‑del, inspektera dess innehållstyp och avkoda dess kropp. Biblioteket hanterar automatiskt base64‑ och quoted‑printable‑avkodning, teckenkodningskonvertering och gränssnittdetektering. Detta gör det enkelt att extrahera text/plain‑ och text/html‑versioner, spara bilagor eller bygga om meddelanden för vidarebefordran eller arkivering – idealiskt för e‑postklienter, backup‑verktyg och efterlevnadssystem.
Hur man bearbetar multipart-meddelanden och extraherar bilagor?
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)}")
