
flanker
Открытая библиотека Python для разбора электронной почты
Разбор адресов электронной почты, проверка адресов и разбор MIME‑сообщений с помощью открытого бесплатного API Python.
Что такое 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>
Обработка multipart‑сообщений и вложений
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)}")
