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