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 ทำให้มั่นใจในความเสถียรและประสิทธิภาพในสภาพแวดล้อมที่มีปริมาณสูง.

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 ของโครงการ.

ติดตั้ง 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)}")
 ไทย