1. Produk
  2.   Surel
  3.   Python
  4.   flanker

flanker

 
 

Perpustakaan Python Sumber Terbuka untuk Penguraian Email

Mengurai Alamat Email, Memvalidasi Alamat & Mengurai Pesan MIME melalui API Python Gratis Sumber Terbuka.

Apa itu flanker?

flanker adalah pustaka Python sumber terbuka yang dikembangkan oleh Mailgun untuk mengurai alamat email dan pesan MIME. Ia menyediakan alat yang kuat untuk memvalidasi alamat email, mengurai daftar alamat yang kompleks, dan mengekstrak data terstruktur dari pesan MIME. Dirancang untuk penggunaan produksi, flanker mendukung baik Python 2.7 maupun Python 3.6+, menjadikannya ideal bagi pengembang yang membangun aplikasi berat email seperti pipeline pemrosesan surat, integrasi CRM, dan sistem notifikasi.

Pustaka ini terdiri dari dua modul inti: `flanker.addresslib` untuk mengurai dan memvalidasi alamat email, serta `flanker.mime` untuk mengurai pesan MIME. Ia mendukung mode penguraian ketat dan longgar, validasi catatan DNS/MX, serta pelaporan kesalahan yang detail. Dengan API yang bersih dan ketergantungan minimal, flanker memungkinkan pengembang memproses data email secara andal tanpa bergantung pada binari eksternal atau ketergantungan yang kompleks. Penggunaannya yang luas dalam infrastruktur Mailgun menjamin stabilitas dan kinerja di lingkungan dengan volume tinggi.

Previous Next

Memulai dengan flanker

Untuk memulai dengan flanker, Anda perlu menginstal header Python terlebih dahulu. Di Ubuntu, jalankan `sudo apt-get install python-dev`; di Fedora, gunakan `sudo yum install python-devel`. Kemudian instal melalui pip: `pip install flanker`. Atau, kloning repositori [flanker GitHub](https://github.com/mailgun/flanker) dan jalankan `pip install -e .`. Perpustakaan ini ringan, dengan dependensi minimal, dan siap untuk penggunaan produksi. Dokumentasi terperinci serta referensi API tersedia di repositori GitHub proyek.

Instal flanker via 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 .

Mengurai dan Memvalidasi Alamat Email

flanker menyediakan alat yang kuat untuk parsing dan validasi alamat email. Anda dapat mem-parsing satu alamat dengan nama tampilan, memvalidasi terhadap catatan DNS/MX, dan memeriksa aturan tata bahasa ESP. Perpustakaan ini mendukung mode parsing ketat dan longgar, serta dapat mengembalikan alamat yang diparsing atau `None` untuk input yang tidak valid. Ia juga menangani daftar alamat, mengembalikan alamat yang diparsing dan fragmen yang tidak dapat diparsing secara terpisah. Hal ini menjadikannya ideal untuk membersihkan input pengguna, memvalidasi impor massal, dan memastikan integritas data dalam alur kerja yang berbasis email.

Cara Mengurai dan Memvalidasi Alamat Email via 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']

Mengurai Pesan MIME

Modul parsing MIME flanker (`flanker.mime`) memungkinkan pengembang untuk mengurai pesan email mentah menjadi objek Python terstruktur. Anda dapat mengekstrak header, mendekode isi, mendeteksi tipe konten, dan menavigasi struktur multipart dengan mudah. Perpustakaan ini menangani pengkodean, konversi charset, dan bagian MIME bersarang secara otomatis. Dengan predikat seperti `is_multipart()` dan `is_singlepart()`, Anda dapat memeriksa struktur pesan secara programatik dan memproses setiap bagian sesuai—ideal untuk membangun klien email, sistem pengarsipan, atau pipeline pemrosesan otomatis.

Bagaimana Cara Mengurai Pesan MIME dan Mengekstrak Header & Body?

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 Header dan Metadata

flanker menyediakan akses kaya ke header email dan metadata melalui API parsing MIME-nya. Header dikembalikan sebagai kamus multi-nilai Unicode, mendukung pencarian tidak sensitif huruf besar/kecil dan nilai terstruktur (misalnya, `Content-Type` diurai menjadi tipe dan parameter). Anda dapat mengambil pengirim, penerima, subjek, tanggal, dan header khusus dengan mudah. Ini sangat berguna untuk pengindeksan email, penyaringan spam, audit kepatuhan, dan membangun arsip email yang ramah pencarian di mana parsing header yang tepat sangat penting.

Bagaimana Cara Mengekstrak Header Email 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>

Menangani Pesan Multipart dan Lampiran

flanker menyederhanakan kerja dengan pesan multipart yang kompleks, termasuk yang memiliki bagian bersarang dan lampiran. Anda dapat mengiterasi `msg.parts` untuk mengakses setiap bagian MIME, memeriksa tipe kontennya, dan mendekode tubuhnya. Perpustakaan secara otomatis menangani dekoding base64 dan quoted-printable, konversi charset, serta deteksi batas. Ini membuatnya mudah untuk mengekstrak versi text/plain dan text/html, menyimpan lampiran, atau membangun kembali pesan untuk penerusan atau arsip—ideal untuk klien email, alat cadangan, dan sistem kepatuhan.

Bagaimana Cara Memproses Pesan 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)}")
 Indonesia