flanker

 
 

ספריית פייתון קוד פתוח לפענוח אימייל

פענוח כתובות אימייל, אימות כתובות ופענוח הודעות MIME באמצעות API פייתון חינמי וקוד פתוח.

מהו flanker?

flanker היא ספריית פייתון קוד פתוח שפותחה על ידי 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 בקלות. הספרייה מטפלת בקידוד, המרת ערכות תווים וחלקי 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` מפורק לסוג ולפרמטרים). ניתן לאחזר את השולח, הנמען, הנושא, התאריך והכותרות המותאמות בקלות. זה במיוחד שימושי לאינדוקס דוא"ל, סינון ספאם, ביקורת ציות, ולבניית ארכיוני דוא"ל ידידותיים לחיפוש שבהם ניתוח מדויק של הכותרות הוא קריטי.

איך לחלץ כותרות דוא"ל ונתוני מטא באמצעות פייתון?

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 מפשט עבודה עם הודעות מרובות חלקים מורכבות, כולל כאלה עם חלקים מקוננים וקבצים מצורפים. ניתן לעבור על `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)}")
 עִברִית