
flanker
Nyílt forráskódú Python könyvtár e-mail feldolgozáshoz
E-mail címek feldolgozása, címek ellenőrzése és MIME üzenetek feldolgozása nyílt forráskódú ingyenes Python API-val.
Mi az a flanker?
flanker egy nyílt forráskódú Python könyvtár, amelyet a Mailgun fejlesztett e‑mail címek és MIME üzenetek feldolgozására. Robusztus eszközöket biztosít e‑mail címek érvényesítéséhez, összetett címlisták elemzéséhez, valamint strukturált adatok kinyeréséhez a MIME üzenetekből. A termelésre tervezve, a flanker támogatja a Python 2.7-et és a Python 3.6+-ot is, így ideális fejlesztők számára, akik e‑mail‑intenzív alkalmazásokat építenek, például levélfeldolgozó csővezetékeket, CRM integrációkat és értesítési rendszereket.
A könyvtár két fő modulból áll: `flanker.addresslib` az e‑mail címek feldolgozásához és érvényesítéséhez, valamint `flanker.mime` a MIME üzenetek feldolgozásához. Támogatja a szigorú és a lazább elemzési módokat, a DNS/MX rekordok ellenőrzését, valamint a részletes hibajelentést. Tiszta API-jával és minimális függőségeivel a flanker lehetővé teszi a fejlesztők számára, hogy megbízhatóan dolgozzanak fel e‑mail adatokat anélkül, hogy külső binárisokra vagy összetett függőségekre támaszkodnának. Széles körű használata a Mailgun infrastruktúrájában biztosítja a stabilitást és a teljesítményt nagy volumenű környezetekben.
Első lépések a flankerrel
A flanker használatának megkezdéséhez először telepítened kell a Python fejléceket. Ubuntu rendszeren futtasd a `sudo apt-get install python-dev` parancsot; Fedora esetén használd a `sudo yum install python-devel` parancsot. Ezután telepítsd a pip‑en keresztül: `pip install flanker`. Alternatívaként klónozd a [flanker GitHub](https://github.com/mailgun/flanker) tárolót, és futtasd a `pip install -e .` parancsot. A könyvtár könnyű, minimális függőségekkel rendelkezik, és készen áll a termelési környezetben való használatra. Részletes dokumentáció és API hivatkozások érhetők el a projekt GitHub tárolójában.
A flanker telepítése PIP vagy GitHub segítségével
# 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 .
E-mail címek feldolgozása és ellenőrzése
A flanker erőteljes eszközöket biztosít e‑mail címek elemzéséhez és érvényesítéséhez. Egyetlen címet megjelenítési névvel is elemezhetsz, ellenőrizheted a DNS/MX rekordok alapján, és ellenőrizheted az ESP nyelvtani szabályait. A könyvtár támogatja a szigorú és a lazább elemzési módokat, és érvénytelen bemenetek esetén visszaadhatja a feldolgozott címeket vagy a `None` értéket. Kezeli a címlistákat is, külön visszaadva a feldolgozott címeket és a nem elemezhető részeket. Ez ideálissá teszi a felhasználói bemenet tisztításához, a tömeges importok validálásához, és az e‑mail‑alapú munkafolyamatok adatintegritásának biztosításához.
Hogyan lehet e-mail címeket feldolgozni és ellenőrizni Python segítségével?
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']
MIME üzenetek feldolgozása
flanker MIME elemző modulja (`flanker.mime`) lehetővé teszi a fejlesztők számára, hogy nyers e-mail üzeneteket strukturált Python objektumokká alakítsanak. Kinyerheted a fejléceket, dekódolhatod a törzseket, felismerheted a tartalomtípusokat, és könnyedén navigálhatsz a multipart struktúrákban. A könyvtár automatikusan kezeli a kódolást, a karakterkészlet-átalakítást és a beágyazott MIME részeket. Az olyan predikátumokkal, mint a `is_multipart()` és a `is_singlepart()`, programozottan ellenőrizheted az üzenet szerkezetét és feldolgozhatod az egyes részeket ennek megfelelően—ideális e-mail kliensek, archiválási rendszerek vagy automatizált feldolgozási csővezetékek építéséhez.
Hogyan kell feldolgozni a MIME üzeneteket és kinyerni a fejléceket és a törzseket?
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}")
Fejlécek és metaadatok kinyerése
flanker gazdag hozzáférést biztosít az e-mail fejlécekhez és metaadatokhoz a MIME elemző API-ján keresztül. A fejlécek Unicode többértékű szótárként kerülnek visszaadásra, amely támogatja a kis- és nagybetűktől független kereséseket és a strukturált értékeket (például a `Content-Type` típusra és paraméterekre bontva). Könnyedén lekérheted a feladót, a címzettet, a tárgyat, a dátumot és az egyedi fejléceket. Ez különösen hasznos e-mail indexeléshez, spam szűréshez, megfelelőségi auditáláshoz, valamint keresőbarát e-mail archívumok építéséhez, ahol a pontos fejléc-elemzés kritikus.
Hogyan lehet kinyerni az e‑mail fejléceket és metaadatokat Python segítségével?
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>
Többrészes üzenetek és mellékletek kezelése
A flanker egyszerűsíti a komplex többrészes üzenetekkel való munkát, beleértve a beágyazott részeket és mellékleteket is. A `msg.parts` segítségével iterálhat minden MIME részen, ellenőrizheti a tartalom típusát, és dekódolhatja a törzset. A könyvtár automatikusan kezeli a base64 és quoted-printable dekódolást, a karakterkészlet konverziót és a határvonal felismerését. Ez megkönnyíti a text/plain és text/html verziók kinyerését, a mellékletek mentését, vagy az üzenetek újjáépítését továbbítás vagy archiválás céljából – ideális e‑mail kliensek, biztonsági mentő eszközök és megfelelőségi rendszerek számára.
Hogyan kell feldolgozni a több részből álló üzeneteket és kinyerni a mellékleteket?
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)}")
