1. Produk
  2.   E-mel
  3.   Python
  4.   flanker

flanker

 
 

Perpustakaan Python Sumber Terbuka untuk Penguraian E-mel

Urai Alamat E-mel, Sahkan Alamat & Urai Mesej MIME melalui API Python Percuma Sumber Terbuka.

Apakah flanker?

flanker ialah perpustakaan Python sumber terbuka yang dibangunkan oleh Mailgun untuk menghurai alamat e-mel dan mesej MIME. Ia menyediakan alat yang kukuh untuk mengesahkan alamat e-mel, menghurai senarai alamat yang kompleks, dan mengekstrak data berstruktur daripada mesej MIME. Direka untuk penggunaan produksi, flanker menyokong kedua-dua Python 2.7 dan Python 3.6+, menjadikannya ideal untuk pembangun yang membina aplikasi berat e-mel seperti saluran pemprosesan mel, integrasi CRM, dan sistem pemberitahuan.

Perpustakaan ini terdiri daripada dua modul teras: `flanker.addresslib` untuk menghurai dan mengesahkan alamat e-mel, dan `flanker.mime` untuk menghurai mesej MIME. Ia menyokong mod penghurai ketat dan longgar, pengesahan rekod DNS/MX, dan pelaporan ralat terperinci. Dengan API yang bersih dan kebergantungan minimum, flanker membolehkan pembangun memproses data e-mel dengan boleh dipercayakan tanpa bergantung pada binari luaran atau kebergantungan yang kompleks. Penggunaannya yang meluas dalam infrastruktur Mailgun memastikan kestabilan dan prestasi dalam persekitaran berkelajuan tinggi.

Previous Next

Mula Menggunakan flanker

Untuk memulakan dengan flanker, anda perlu memasang header Python terlebih dahulu. Pada Ubuntu, jalankan `sudo apt-get install python-dev`; pada Fedora, gunakan `sudo yum install python-devel`. Kemudian pasang melalui pip: `pip install flanker`. Sebagai alternatif, klon repositori [flanker GitHub](https://github.com/mailgun/flanker) dan jalankan `pip install -e .`. Perpustakaan ini ringan, dengan kebergantungan minimum, dan sedia untuk penggunaan produksi. Dokumentasi terperinci serta rujukan API tersedia dalam repositori GitHub projek tersebut.

Pasang flanker melalui PIP atau 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 .

Menghurai dan Mengesahkan Alamat E-mel

flanker menyediakan alat yang kuat untuk menguraikan dan mengesahkan alamat e-mel. Anda boleh menguraikan satu alamat dengan nama paparan, mengesahkan terhadap rekod DNS/MX, dan memeriksa peraturan tatabahasa ESP. Perpustakaan ini menyokong mod penguraian ketat dan longgar, dan boleh mengembalikan alamat yang diuraikan atau `None` untuk input yang tidak sah. Ia juga mengendalikan senarai alamat, memulangkan alamat yang diuraikan dan fragmen yang tidak dapat diuraikan secara berasingan. Ini menjadikannya ideal untuk membersihkan input pengguna, mengesahkan import pukal, dan memastikan integriti data dalam aliran kerja berasaskan e-mel.

Bagaimana Menghurai dan Mengesahkan Alamat E-mel melalui 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']

Menghurai Mesej MIME

modul penapisan MIME flanker (`flanker.mime`) membolehkan pembangun untuk mengurai mesej e-mel mentah menjadi objek Python berstruktur. Anda boleh mengekstrak pengepala, menyahkod badan, mengesan jenis kandungan, dan menavigasi struktur multipart dengan mudah. Perpustakaan ini mengendalikan pengekodan, penukaran set aksara, dan bahagian MIME bersarang secara automatik. Dengan predikat seperti `is_multipart()` dan `is_singlepart()`, anda boleh memeriksa struktur mesej secara programatik dan memproses setiap bahagian mengikut keperluan—ideal untuk membina klien e-mel, sistem arkib, atau saluran pemprosesan automatik.

Bagaimana untuk Menghurai Mesej MIME dan Mengekstrak Pengepala & Badan?

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

Mengekstrak Pengepala dan Metadata

flanker menyediakan akses yang kaya kepada pengepala e-mel dan metadata melalui API penapisan MIME-nya. Pengepala dikembalikan sebagai kamus berbilang nilai Unicode, menyokong carian tidak sensitif huruf besar/kecil dan nilai berstruktur (contohnya, `Content-Type` diurai menjadi jenis dan parameter). Anda boleh mendapatkan penghantar, penerima, subjek, tarikh, dan pengepala khusus dengan mudah. Ini sangat berguna untuk pengindeksan e-mel, penapisan spam, audit pematuhan, dan membina arkib e-mel mesra carian di mana penguraian pengepala yang tepat adalah kritikal.

Bagaimana untuk Mengekstrak Pengepala E-mel dan Metadata melalui 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>

Mengendalikan Mesej Multipart dan Lampiran

flanker mempermudah kerja dengan mesej multipart yang kompleks, termasuk yang mempunyai bahagian bersarang dan lampiran. Anda boleh mengulangi `msg.parts` untuk mengakses setiap bahagian MIME, memeriksa jenis kandungannya, dan mengekod badan mesej. Perpustakaan ini secara automatik mengendalikan pengekodan base64 dan quoted-printable, penukaran set aksara, dan pengesanan sempadan. Ini menjadikannya mudah untuk mengekstrak versi text/plain dan text/html, menyimpan lampiran, atau membina semula mesej untuk pemajuan atau arkib—ideal untuk klien e-mel, alat sandaran, dan sistem pematuhan.

Bagaimana untuk Memproses Mesej Multipart dan Mengekstrak Lampiran?

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