
flanker
Open source Python knihovna pro analýzu e‑mailů
Analyzujte e‑mailové adresy, ověřujte adresy a analyzujte MIME zprávy pomocí open source bezplatného Python API.
Co je flanker?
flanker je open source knihovna Pythonu vyvinutá společností Mailgun pro parsování e‑mailových adres a MIME zpráv. Poskytuje robustní nástroje pro ověřování e‑mailových adres, parsování složitých seznamů adres a extrahování strukturovaných dat z MIME zpráv. Navržena pro produkční použití, flanker podporuje jak Python 2.7, tak Python 3.6+, což ji činí ideální pro vývojáře vytvářející aplikace s velkým objemem e‑mailů, jako jsou pipeline pro zpracování pošty, integrace CRM a notifikační systémy.
Knihovna se skládá ze dvou hlavních modulů: `flanker.addresslib` pro parsování a ověřování e‑mailových adres a `flanker.mime` pro parsování MIME zpráv. Podporuje přísné i volnější režimy parsování, ověřování DNS/MX záznamů a podrobnou hlášení chyb. Díky čistému API a minimálním závislostem umožňuje flanker vývojářům spolehlivě zpracovávat e‑mailová data bez nutnosti spoléhat se na externí binární soubory nebo složité závislosti. Jeho široké využití v infrastruktuře Mailgun zajišťuje stabilitu a výkon v prostředích s vysokým objemem.
Začínáme s flankerem
Abyste mohli začít s flankerem, musíte nejprve nainstalovat hlavičky Pythonu. V Ubuntu spusťte `sudo apt-get install python-dev`; ve Fedoře použijte `sudo yum install python-devel`. Pak nainstalujte pomocí pip: `pip install flanker`. Případně klonujte repozitář [flanker GitHub](https://github.com/mailgun/flanker) a spusťte `pip install -e .`. Knihovna je lehká, s minimálními závislostmi a připravená k produkčnímu použití. Podrobná dokumentace a odkazy na API jsou k dispozici v GitHub repozitáři projektu.
Instalovat flanker pomocí PIP nebo GitHubu
# 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 .
Analyzovat a ověřit e-mailové adresy
flanker poskytuje výkonné nástroje pro parsování a validaci e‑mailových adres. Můžete parsovat jednu adresu s zobrazovaným jménem, validovat proti DNS/MX záznamům a kontrolovat pravidla gramatiky ESP. Knihovna podporuje přísné i volné režimy parsování a může vrátit parsované adresy nebo `None` pro neplatné vstupy. Také zpracovává seznamy adres, vracející parsované adresy a neparsovatelné fragmenty odděleně. To ji činí ideální pro čištění uživatelských vstupů, validaci hromadných importů a zajištění integrity dat v e‑mailových pracovních postupech.
Jak analyzovat a ověřit e-mailové adresy pomocí Pythonu?
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']
Analyzovat MIME zprávy
modul pro analýzu MIME ve flanker (`flanker.mime`) umožňuje vývojářům parsovat surové e‑mailové zprávy do strukturovaných objektů Pythonu. Můžete extrahovat hlavičky, dekódovat těla, detekovat typy obsahu a snadno procházet multipart struktury. Knihovna automaticky zpracovává kódování, konverzi znakových sad a vnořené MIME části. S predikáty jako `is_multipart()` a `is_singlepart()` můžete programově zkoumat strukturu zprávy a zpracovávat jednotlivé části podle potřeby — ideální pro tvorbu e‑mailových klientů, archivních systémů nebo automatizovaných zpracovatelských pipeline.
Jak parsovat MIME zprávy a extrahovat hlavičky a těla?
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}")
Extrahovat hlavičky a metadata
flanker poskytuje bohatý přístup k e‑mailovým hlavičkám a metadatům prostřednictvím svého API pro analýzu MIME. Hlavičky jsou vráceny jako vícero hodnotový slovník Unicode, podporující vyhledávání bez ohledu na velikost písmen a strukturované hodnoty (např. `Content-Type` rozparsovaný na typ a parametry). Můžete snadno získat odesílatele, příjemce, předmět, datum a vlastní hlavičky. To je zvláště užitečné pro indexaci e‑mailů, filtrování spamu, auditování souladu, a tvorbu archivů e‑mailů přátelských k vyhledávání, kde je kritické přesné parsování hlaviček.
Jak extrahovat e‑mailové hlavičky a metadata pomocí Pythonu?
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>
Zpracovávat multipart zprávy a přílohy
flanker zjednodušuje práci s komplexními multipart zprávami, včetně těch s vnořenými částmi a přílohami. Můžete iterovat přes `msg.parts`, abyste získali každou MIME část, prozkoumali její typ obsahu a dekódovali tělo. Knihovna automaticky zpracovává dekódování base64 a quoted‑printable, konverzi znakových sad a detekci hranic. To usnadňuje extrahovat verze text/plain a text/html, ukládat přílohy nebo znovu sestavit zprávy pro přeposílání či archivaci – ideální pro e‑mailové klienty, zálohovací nástroje a systémy pro soulad.
Jak zpracovat multipart zprávy a extrahovat přílohy?
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)}")
