flanker

 
 

Thư viện Python mã nguồn mở cho việc phân tích email

Phân tích địa chỉ email, xác thực địa chỉ & phân tích tin nhắn MIME qua API Python miễn phí mã nguồn mở.

Flanker là gì?

flanker là một thư viện Python mã nguồn mở được phát triển bởi Mailgun để phân tích địa chỉ email và thông điệp MIME. Nó cung cấp các công cụ mạnh mẽ để xác thực địa chỉ email, phân tích danh sách địa chỉ phức tạp và trích xuất dữ liệu có cấu trúc từ các thông điệp MIME. Được thiết kế cho môi trường sản xuất, flanker hỗ trợ cả Python 2.7 và Python 3.6+, khiến nó trở thành lựa chọn lý tưởng cho các nhà phát triển xây dựng các ứng dụng liên quan nhiều email như pipeline xử lý thư, tích hợp CRM và hệ thống thông báo.

Thư viện bao gồm hai mô-đun cốt lõi: `flanker.addresslib` để phân tích và xác thực địa chỉ email, và `flanker.mime` để phân tích các thông điệp MIME. Nó hỗ trợ các chế độ phân tích nghiêm ngặt và linh hoạt, xác thực bản ghi DNS/MX, và báo cáo lỗi chi tiết. Với API sạch sẽ và phụ thuộc tối thiểu, flanker cho phép các nhà phát triển xử lý dữ liệu email một cách đáng tin cậy mà không cần dựa vào các binary bên ngoài hoặc các phụ thuộc phức tạp. Việc sử dụng rộng rãi trong hạ tầng của Mailgun đảm bảo tính ổn định và hiệu suất trong môi trường khối lượng lớn.

Previous Next

Bắt đầu với flanker

Để bắt đầu với flanker, trước tiên bạn cần cài đặt các header Python. Trên Ubuntu, chạy `sudo apt-get install python-dev`; trên Fedora, sử dụng `sudo yum install python-devel`. Sau đó cài đặt qua pip: `pip install flanker`. Ngoài ra, bạn có thể sao chép repo [flanker GitHub](https://github.com/mailgun/flanker) và chạy `pip install -e .`. Thư viện này nhẹ, có ít phụ thuộc và sẵn sàng cho môi trường sản xuất. Tài liệu chi tiết và tham chiếu API có sẵn trong kho GitHub của dự án.

Cài đặt flanker qua PIP hoặc 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 .

Phân tích và xác thực địa chỉ email

flanker cung cấp các công cụ mạnh mẽ để phân tích và xác thực địa chỉ email. Bạn có thể phân tích một địa chỉ duy nhất kèm tên hiển thị, xác thực dựa trên bản ghi DNS/MX, và kiểm tra các quy tắc ngữ pháp ESP. Thư viện hỗ trợ các chế độ phân tích nghiêm ngặt và linh hoạt, và có thể trả về địa chỉ đã phân tích hoặc `None` cho các đầu vào không hợp lệ. Nó cũng xử lý danh sách địa chỉ, trả về các địa chỉ đã phân tích và các đoạn không thể phân tích riêng biệt. Điều này làm cho nó trở nên lý tưởng cho việc làm sạch dữ liệu người dùng, xác thực nhập khẩu hàng loạt, và đảm bảo tính toàn vẹn dữ liệu trong các quy trình làm việc dựa trên email.

Cách phân tích và xác thực địa chỉ email bằng 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']

Phân tích tin nhắn MIME

module phân tích MIME của flanker (`flanker.mime`) cho phép các nhà phát triển phân tích các tin nhắn email thô thành các đối tượng Python có cấu trúc. Bạn có thể trích xuất tiêu đề, giải mã nội dung, phát hiện loại nội dung và điều hướng các cấu trúc multipart một cách dễ dàng. Thư viện tự động xử lý mã hoá, chuyển đổi charset và các phần MIME lồng nhau. Với các hàm dự đoán như `is_multipart()` và `is_singlepart()`, bạn có thể kiểm tra cấu trúc tin nhắn một cách lập trình và xử lý từng phần tương ứng—lý tưởng cho việc xây dựng các client email, hệ thống lưu trữ, hoặc các pipeline xử lý tự động.

Cách phân tích thông điệp MIME và trích xuất tiêu đề & nội dung?

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

Trích xuất tiêu đề và siêu dữ liệu

flanker cung cấp quyền truy cập phong phú vào các tiêu đề email và siêu dữ liệu thông qua API phân tích MIME của nó. Các tiêu đề được trả về dưới dạng từ điển đa giá trị Unicode, hỗ trợ tra cứu không phân biệt chữ hoa chữ thường và các giá trị có cấu trúc (ví dụ, `Content-Type` được phân tích thành loại và các tham số). Bạn có thể dễ dàng lấy thông tin người gửi, người nhận, tiêu đề, ngày và các tiêu đề tùy chỉnh. Điều này đặc biệt hữu ích cho việc lập chỉ mục email, lọc spam, kiểm toán tuân thủ, và xây dựng các kho lưu trữ email thân thiện với tìm kiếm, nơi việc phân tích tiêu đề một cách chính xác là rất quan trọng.

Cách trích xuất tiêu đề email và siêu dữ liệu bằng 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>

Xử lý tin nhắn đa phần và tệp đính kèm

flanker đơn giản hóa việc làm việc với các tin nhắn multipart phức tạp, bao gồm cả những tin nhắn có các phần lồng nhau và tệp đính kèm. Bạn có thể lặp qua `msg.parts` để truy cập từng phần MIME, kiểm tra loại nội dung của nó và giải mã phần thân. Thư viện tự động xử lý giải mã base64 và quoted‑printable, chuyển đổi charset, và phát hiện ranh giới. Điều này giúp dễ dàng trích xuất các phiên bản text/plain và text/html, lưu tệp đính kèm, hoặc tái tạo tin nhắn để chuyển tiếp hoặc lưu trữ—lý tưởng cho các client email, công cụ sao lưu và hệ thống tuân thủ.

Cách xử lý thông điệp đa phần và trích xuất tệp đính kèm?

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)}")
 Tiếng Việt