
flanker
Отворена Python библиотека за разбиране на имейли
Разбор на имейл адреси, валидиране на адреси и разбиране на MIME съобщения чрез отворен безплатен Python API.
Какво е flanker?
flanker е отворена Python библиотека, разработена от Mailgun за парсиране на имейл адреси и MIME съобщения. Тя предоставя мощни инструменти за валидиране на имейл адреси, парсиране на сложни списъци с адреси и извличане на структурирани данни от MIME съобщения. Проектирана за продукционна употреба, flanker поддържа както Python 2.7, така и Python 3.6+, което я прави идеална за разработчиците, създаващи приложения с голямо количество имейли, като пощенски процесинг пайплайни, CRM интеграции и системи за известия.
Библиотеката се състои от два основни модула: `flanker.addresslib` за парсиране и валидиране на имейл адреси и `flanker.mime` за парсиране на MIME съобщения. Тя поддържа строг и нестрог режим на парсиране, валидиране на DNS/MX записи и подробни доклади за грешки. Със своя чист API и минимални зависимости, flanker позволява на разработчиците надеждно да обработват имейл данни без да разчитат на външни бинарни файлове или сложни зависимости. Широкото ѝ използване в инфраструктурата на Mailgun осигурява стабилност и производителност в среди с висок обем.
Започване с flanker
За да започнете с flanker, първо трябва да имате инсталирани Python хедъри. На Ubuntu изпълнете `sudo apt-get install python-dev`; на Fedora използвайте `sudo yum install python-devel`. След това инсталирайте чрез pip: `pip install flanker`. Алтернативно, клонирайте репото [flanker GitHub](https://github.com/mailgun/flanker) и изпълнете `pip install -e .`. Библиотеката е лека, с минимални зависимости, и готова за продукционна употреба. Подробна документация и API референции са налични в GitHub хранилището на проекта.
Инсталирайте flanker чрез PIP или 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 .
Анализиране и валидиране на имейл адреси
flanker предоставя мощни инструменти за анализ и валидиране на имейл адреси. Можете да анализирате един адрес с име за показване, да валидирате срещу DNS/MX записи и да проверите граматичните правила на ESP. Библиотеката поддържа строг и нестрог режим на анализ и може да върне анализирани адреси или `None` за невалидни входове. Тя също така обработва списъци с адреси, като връща анализирани адреси и неанализируеми фрагменти отделно. Това я прави идеална за почистване на потребителски вход, валидиране на масови импорти и осигуряване на целостта на данните в работни процеси, базирани на имейл.
Как да анализирам и валидирам имейл адреси с Python?
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 съобщения
Модулът за MIME парсиране на flanker (`flanker.mime`) позволява на разработчиците да анализират необработени имейл съобщения в структуриран Python обекти. Можете да извличате заглавки, декодирате тела, откривате типове съдържание и лесно навигирате в multipart структури. Библиотеката автоматично се грижи за кодиране, конверсия на набор от знаци и вложени MIME части. С предикати като `is_multipart()` и `is_singlepart()`, можете програмено да инспектирате структурата на съобщението и да обработвате всяка част съответно — идеално за създаване на имейл клиенти, архивиращи системи или автоматизирани процесни конвейери.
Как да парсираме MIME съобщения и да извлечем заглавки & тела?
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}")
Извличане на заглавки и метаданни
flanker предоставя богати достъпи до имейл заглавки и метаданни чрез своя API за MIME парсиране. Заглавките се връщат като Unicode речник с множество стойности, поддържащ търсене без значение на регистъра и структурираните стойности (например `Content-Type`, анализиран в тип и параметри). Можете лесно да извлечете подател, получател, тема, дата и персонализирани заглавки. Това е особено полезно за индексиране на имейли, филтриране на спам, одит за съответствие и създаване на търсено‑приятелски имейл архиви, където точният парсинг на заглавките е от съществено значение.
Как да извлечем заглавки на имейл и метаданни чрез Python?
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>
Обработка на многочастични съобщения и прикачени файлове
flanker опростява работата със сложни multipart съобщения, включително тези с вложени части и прикачени файлове. Можете да итерирате през `msg.parts`, за да достъпите всяка MIME част, да проверите нейния тип съдържание и да декодирате тялото й. Библиотеката автоматично обработва декодиране на base64 и quoted-printable, конверсия на набор от знаци и откриване на граници. Това прави лесно извличането на версии text/plain и text/html, запазването на прикачени файлове или възстановяването на съобщения за препращане или архивиране — идеално за имейл клиенти, инструменти за резервно копиране и системи за съответствие.
Как да обработим multipart съобщения и да извлечем прикачени файлове?
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)}")
