flanker

 
 

مكتبة بايثون مفتوحة المصدر لتحليل البريد الإلكتروني

تحليل عناوين البريد الإلكتروني، التحقق من صحة العناوين وتحليل رسائل MIME عبر واجهة برمجة تطبيقات بايثون مجانية ومفتوحة المصدر.

ما هو flanker؟

flanker هي مكتبة بايثون مفتوحة المصدر تم تطويرها بواسطة Mailgun لتحليل عناوين البريد الإلكتروني ورسائل MIME. توفر أدوات قوية للتحقق من صحة عناوين البريد الإلكتروني، وتحليل قوائم العناوين المعقدة، واستخراج البيانات المهيكلة من رسائل MIME. صُممت للاستخدام في بيئات الإنتاج، وتدعم flanker كلًا من Python 2.7 و Python 3.6+، مما يجعلها مثالية للمطورين الذين يبنون تطبيقات تعتمد بشكل كبير على البريد الإلكتروني مثل خطوط معالجة البريد، وتكاملات CRM، وأنظمة الإشعارات.

تتكون المكتبة من وحدتين أساسيتين: `flanker.addresslib` لتحليل والتحقق من صحة عناوين البريد الإلكتروني، و `flanker.mime` لتحليل رسائل MIME. تدعم أوضاع التحليل الصارمة والمرنة، والتحقق من سجلات DNS/MX، وتقديم تقارير أخطاء مفصلة. بفضل واجهة برمجة التطبيقات النظيفة والاعتماديات القليلة، تمكّن 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 بسهولة. تتعامل المكتبة مع الترميز، تحويل مجموعة الأحرف، وأجزاء 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 وصولًا غنيًا إلى رؤوس البريد الإلكتروني والبيانات الوصفية من خلال واجهة برمجة تطبيقات تحليل MIME الخاصة بها. تُرجع الرؤوس كقاموس متعدد القيم Unicode، يدعم عمليات البحث غير حساسة لحالة الأحرف والقيم المهيكلة (مثل `Content-Type` التي يتم تحليلها إلى النوع والمعاملات). يمكنك استرجاع المرسل، المستلم، الموضوع، التاريخ، والرؤوس المخصصة بسهولة. هذا مفيد بشكل خاص لفهرسة البريد الإلكتروني، تصفية الرسائل المزعجة، تدقيق الامتثال، وبناء أرشيفات بريد إلكتروني صديقة للبحث حيث يكون تحليل الرؤوس بدقة أمرًا حاسمًا.

كيف يتم استخراج رؤوس البريد الإلكتروني والبيانات الوصفية عبر بايثون؟

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، وتحويل مجموعة الأحرف، واكتشاف الحدود. هذا يجعل من السهل استخراج إصدارات 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)}")
 عربي