1. produkty
  2.   E-mailem
  3.   Python
  4.   flanker

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.

Previous Next

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)}")
 Čeština