
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 ได้อย่างง่ายดาย ไลบรารีจัดการการเข้ารหัส, การแปลง charset, และส่วน 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 การแปลง charset และการตรวจจับขอบเขตโดยอัตโนมัติ ทำให้การดึงข้อความ 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)}")
