
flanker
ईमेल पार्सिंग के लिए ओपन सोर्स Python लाइब्रेरी
ओपन सोर्स फ्री Python API के माध्यम से ईमेल पते पार्स करें, पतों को मान्य करें और MIME संदेश पार्स करें।
फ़्लैंकर क्या है?
flanker एक ओपन सोर्स Python लाइब्रेरी है जिसे Mailgun ने ईमेल पतों और MIME संदेशों को पार्स करने के लिए विकसित किया है। यह ईमेल पतों को वैध करने, जटिल पता सूचियों को पार्स करने, और MIME संदेशों से संरचित डेटा निकालने के लिए मजबूत उपकरण प्रदान करती है। उत्पादन उपयोग के लिए डिज़ाइन की गई, flanker Python 2.7 और Python 3.6+ दोनों को सपोर्ट करती है, जिससे यह मेल प्रोसेसिंग पाइपलाइन, CRM इंटीग्रेशन, और नोटिफिकेशन सिस्टम जैसे ईमेल-भारी अनुप्रयोग बनाने वाले डेवलपर्स के लिए आदर्श बनती है।
यह लाइब्रेरी दो मुख्य मॉड्यूल्स से बनी है: `flanker.addresslib` ईमेल पतों को पार्स और वैध करने के लिए, और `flanker.mime` MIME संदेशों को पार्स करने के लिए। यह सख्त और लचीले पार्सिंग मोड, DNS/MX रिकॉर्ड वैधता, और विस्तृत त्रुटि रिपोर्टिंग को सपोर्ट करता है। अपनी साफ़ API और न्यूनतम निर्भरताओं के साथ, flanker डेवलपर्स को बाहरी बाइनरीज़ या जटिल निर्भरताओं पर निर्भर हुए बिना ईमेल डेटा को विश्वसनीय रूप से प्रोसेस करने में सक्षम बनाता है। Mailgun की इन्फ्रास्ट्रक्चर में इसका व्यापक उपयोग उच्च-आयतन वाले वातावरण में स्थिरता और प्रदर्शन सुनिश्चित करता है।
फ़्लैंकर के साथ शुरुआत
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 रिपॉज़िटरी में उपलब्ध हैं।
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 संदेशों को पार्स करें
flanker का MIME पार्सिंग मॉड्यूल (`flanker.mime`) डेवलपर्स को कच्चे ईमेल संदेशों को संरचित Python ऑब्जेक्ट्स में पार्स करने में सक्षम बनाता है। आप हेडर निकाल सकते हैं, बॉडी डिकोड कर सकते हैं, कंटेंट टाइप का पता लगा सकते हैं, और मल्टीपार्ट संरचनाओं को आसानी से नेविगेट कर सकते हैं। लाइब्रेरी एन्कोडिंग, कैरेक्टर सेट रूपांतरण, और नेस्टेड 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 पार्सिंग API के माध्यम से ईमेल हेडर और मेटाडेटा तक समृद्ध पहुँच प्रदान करता है। हेडर यूनिकोड मल्टी-वैल्यू डिक्शनरी के रूप में लौटाए जाते हैं, जो केस-इन्सेंसिटिव लुकअप और संरचित मानों (जैसे, `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 जटिल मल्टीपार्ट संदेशों के साथ काम करना सरल बनाता है, जिसमें नेस्टेड भाग और अटैचमेंट शामिल हैं। आप `msg.parts` पर इटररेट करके प्रत्येक MIME भाग तक पहुंच सकते हैं, उसकी कंटेंट टाइप जांच सकते हैं, और उसके बॉडी को डिकोड कर सकते हैं। लाइब्रेरी स्वचालित रूप से base64 और quoted-printable डिकोडिंग, कैरेक्टरसेट रूपांतरण, और बाउंड्री डिटेक्शन को संभालती है। यह टेक्स्ट/प्लेन और टेक्स्ट/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)}")
