1. Produkty
  2.   E-mail
  3.   Python
  4.   flanker

flanker

 
 

Otwarta biblioteka Python do parsowania e‑maili

Analiza adresów e‑mail, walidacja adresów i parsowanie wiadomości MIME za pomocą otwartego, darmowego API Python.

Czym jest flanker?

flanker jest otwarto‑źródłową biblioteką Pythona opracowaną przez Mailgun do parsowania adresów e‑mail i wiadomości MIME. Dostarcza solidne narzędzia do walidacji adresów e‑mail, parsowania złożonych list adresowych oraz wyodrębniania ustrukturyzowanych danych z wiadomości MIME. Zaprojektowany z myślą o produkcji, flanker obsługuje zarówno Python 2.7, jak i Python 3.6+, co czyni go idealnym dla programistów tworzących aplikacje intensywnie korzystające z e‑mail, takie jak potoki przetwarzania poczty, integracje CRM i systemy powiadomień.

Biblioteka składa się z dwóch podstawowych modułów: `flanker.addresslib` do parsowania i walidacji adresów e‑mail oraz `flanker.mime` do parsowania wiadomości MIME. Obsługuje tryby parsowania ścisłego i luźnego, walidację rekordów DNS/MX oraz szczegółowe raportowanie błędów. Dzięki czystemu API i minimalnym zależnościom, flanker umożliwia programistom niezawodne przetwarzanie danych e‑mail bez konieczności polegania na zewnętrznych binariach czy skomplikowanych zależnościach. Jego powszechne użycie w infrastrukturze Mailgun zapewnia stabilność i wydajność w środowiskach o dużym wolumenie.

Previous Next

Rozpoczęcie pracy z flanker

Zanim rozpoczniesz pracę z flanker, musisz najpierw zainstalować nagłówki Pythona. Na Ubuntu uruchom `sudo apt-get install python-dev`; na Fedorze użyj `sudo yum install python-devel`. Następnie zainstaluj za pomocą pip: `pip install flanker`. Alternatywnie, sklonuj repozytorium [flanker GitHub](https://github.com/mailgun/flanker) i uruchom `pip install -e .`. Biblioteka jest lekka, ma minimalne zależności i jest gotowa do użycia w produkcji. Szczegółowa dokumentacja oraz odniesienia do API są dostępne w repozytorium GitHub projektu.

Zainstaluj flanker za pomocą PIP lub 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 .

Analiza i weryfikacja adresów e-mail

flanker udostępnia potężne narzędzia do parsowania i walidacji adresów e‑mail. Możesz parsować pojedynczy adres z nazwą wyświetlaną, weryfikować go względem rekordów DNS/MX oraz sprawdzać reguły gramatyczne ESP. Biblioteka obsługuje tryby parsowania ścisłego i luźnego i może zwrócić sparsowane adresy lub `None` dla nieprawidłowych danych wejściowych. Obsługuje także listy adresów, zwracając osobno sparsowane adresy i fragmenty nieparsowalne. Dzięki temu jest idealna do czyszczenia danych wprowadzanych przez użytkowników, walidacji masowych importów oraz zapewniania integralności danych w przepływach pracy opartych na e‑mailach.

Jak analizować i weryfikować adresy e-mail przy użyciu Pythona?

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']

Analiza wiadomości MIME

Moduł parsowania MIME flankera (`flanker.mime`) umożliwia programistom analizowanie surowych wiadomości e-mail do ustrukturyzowanych obiektów Pythona. Możesz wyodrębniać nagłówki, dekodować treści, wykrywać typy zawartości i łatwo nawigować po strukturach multipart. Biblioteka automatycznie obsługuje kodowanie, konwersję zestawu znaków oraz zagnieżdżone części MIME. Dzięki predykatom takim jak `is_multipart()` i `is_singlepart()` możesz programowo sprawdzać strukturę wiadomości i przetwarzać każdą część odpowiednio — idealne do budowania klientów poczty, systemów archiwizacji lub zautomatyzowanych potoków przetwarzania.

Jak parsować wiadomości MIME i wyodrębniać nagłówki oraz treść?

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}")

Wyodrębnianie nagłówków i metadanych

flanker zapewnia bogaty dostęp do nagłówków e-mail i metadanych poprzez swoje API parsowania MIME. Nagłówki są zwracane jako słownik wielowartościowy Unicode, obsługujący wyszukiwania bez uwzględniania wielkości liter oraz wartości strukturalne (np. `Content-Type` parsowany na typ i parametry). Możesz łatwo pobrać nadawcę, odbiorcę, temat, datę oraz niestandardowe nagłówki. Jest to szczególnie przydatne do indeksowania e-maili, filtrowania spamu, audytu zgodności oraz budowania przyjaznych wyszukiwarce archiwów e-mail, gdzie precyzyjne parsowanie nagłówków jest kluczowe.

Jak wyodrębnić nagłówki e‑mail i metadane przy użyciu Pythona?

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>

Obsługa wiadomości wieloczęściowych i załączników

flanker upraszcza pracę z złożonymi wiadomościami multipart, w tym z tymi zawierającymi zagnieżdżone części i załączniki. Możesz iterować po `msg.parts`, aby uzyskać dostęp do każdej części MIME, sprawdzić jej typ treści i zdekodować ciało. Biblioteka automatycznie obsługuje dekodowanie base64 i quoted-printable, konwersję zestawu znaków oraz wykrywanie granic. Dzięki temu łatwo wyodrębnić wersje text/plain i text/html, zapisać załączniki lub odtworzyć wiadomości do przekazywania lub archiwizacji — idealne dla klientów poczty elektronicznej, narzędzi backupowych i systemów zgodności.

Jak przetwarzać wiadomości multipart i wyodrębniać załączniki?

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)}")
 Polski