1. 製品
  2.   Eメール
  3.   Python
  4.   flanker

flanker

 
 

メール解析のためのオープンソースPythonライブラリ

オープンソースの無料Python APIでメールアドレスを解析し、アドレスを検証、MIMEメッセージを解析

flanker とは何ですか?

flanker は、Mailgun が開発したオープンソースの Python ライブラリで、メールアドレスと MIME メッセージの解析を行います。メールアドレスの検証、複雑なアドレスリストの解析、MIME メッセージからの構造化データ抽出のための堅牢なツールを提供します。プロダクション向けに設計されており、flanker は Python 2.7 と Python 3.6+ の両方をサポートしているため、メール処理パイプライン、CRM 連携、通知システムなど、メール中心のアプリケーションを構築する開発者に最適です。

このライブラリは、メールアドレスの解析と検証を行う `flanker.addresslib` と、MIME メッセージの解析を行う `flanker.mime` の 2 つのコアモジュールで構成されています。厳格モードと寛容モードのパース、DNS/MX レコードの検証、詳細なエラーレポートをサポートします。クリーンな API と最小限の依存関係により、flanker は外部バイナリや複雑な依存関係に頼らずにメールデータを確実に処理できるように開発者を支援します。Mailgun のインフラストラクチャで広く使用されていることから、高ボリューム環境における安定性とパフォーマンスが保証されています。

Previous Next

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 リポジトリで入手可能です。

PIP または GitHub で flanker をインストール

# 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 メッセージの解析

flanker の MIME パーシングモジュール(`flanker.mime`)は、開発者が生のメールメッセージを構造化された Python オブジェクトに解析できるようにします。ヘッダーの抽出、本文のデコード、コンテンツタイプの検出、マルチパート構造のナビゲーションを簡単に行えます。このライブラリはエンコーディング、文字セット変換、ネストされた 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 は、MIME パーシング API を通じてメールヘッダーとメタデータへの豊富なアクセスを提供します。ヘッダーは 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 は、ネストされたパートや添付ファイルを含む複雑なマルチパートメッセージの処理を簡素化します。`msg.parts` を反復処理して各 MIME パートにアクセスし、コンテンツタイプを検査し、本文をデコードできます。このライブラリは base64 および quoted-printable のデコード、文字セット変換、境界検出を自動的に処理します。これにより、text/plain と text/html のバージョンを抽出したり、添付ファイルを保存したり、転送やアーカイブ用にメッセージを再構築したりすることが簡単になります—メールクライアント、バックアップツール、コンプライアンスシステムに最適です。

マルチパートメッセージを処理し、添付ファイルを抽出する方法は?

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