go-message

 
 

ईमेल और इंटरनेट संदेश प्रारूप के लिए ओपन सोर्स Go लाइब्रेरी

स्ट्रीमिंग Go API के माध्यम से RFC 5322, MIME, और कंटेंट-डिस्पोज़िशन हेडर को पार्स, जेनरेट और हैंडल करें।

go-message क्या है?

go-message एक उच्च-प्रदर्शन, स्ट्रीमिंग Go लाइब्रेरी है जो ईमेल संदेशों को पार्स करने और उत्पन्न करने के लिए डिज़ाइन की गई है, जो इंटरनेट मैसेज फ़ॉर्मेट (RFC 5322), MIME एक्सटेंशन (RFC 2045–2047), और कंटेंट-डिस्पोज़िशन हेडर (RFC 2183) के अनुरूप हैं। यह Go डेवलपर्स को ईमेल सामग्री को कुशलतापूर्वक प्रोसेस करने में सक्षम बनाती है बिना पूरे संदेशों को मेमोरी में लोड किए, जिससे यह स्केलेबल मेल सर्वर और क्लाइंट्स के लिए आदर्श बनता है। लाइब्रेरी स्वचालित कैरेक्टरसेट डिकोडिंग का समर्थन करती है और Go की स्टैंडर्ड लाइब्रेरी के साथ सहजता से एकीकृत होती है।

मॉड्यूलरिटी और विस्तारशीलता को ध्यान में रखकर निर्मित, go-message में `mail` जैसे समर्पित सबपैकेज शामिल हैं जो उच्च-स्तरीय मेल हैंडलिंग के लिए और `textproto` जो लो-लेवल प्रोटोकॉल पार्सिंग के लिए है। इसका DKIM-फ्रेंडली डिज़ाइन आधुनिक ईमेल प्रमाणीकरण वर्कफ़्लो के साथ संगतता सुनिश्चित करता है। अंतर्निहित स्ट्रीमिंग क्षमताओं और कैरेक्टरसेट नॉर्मलाइज़ेशन के साथ, go-message जटिल ईमेल प्रोसेसिंग कार्यों को सरल बनाता है जैसे कि मल्टीपार्ट बॉडीज़ को पार्स करना, एन्कोडेड हेडर को डिकोड करना, और नेस्टेड MIME संरचनाओं को संभालना—सभी मेमोरी दक्षता और प्रदर्शन को बनाए रखते हुए।

Previous Next

go-message के साथ शुरूआत

go-message का उपयोग शुरू करने के लिए, इसे आधिकारिक [go-message GitHub](https://github.com/emersion/go-message) रिपॉज़िटरी से `go get` के माध्यम से स्थापित करें। अनुशंसित तरीका Go मॉड्यूल्स का उपयोग करना है: अपने प्रोजेक्ट डायरेक्टरी में `go get github.com/emersion/go-message` चलाएँ। charset डिकोडिंग समर्थन के लिए, सभी मानक एन्कोडिंग सक्षम करने हेतु `import _ \"github.com/emersion/go-message/charset\"` शामिल करें। यह लाइब्रेरी हल्की, निर्भरता‑रहित है, और मौजूदा Go अनुप्रयोगों में सहजता से एकीकृत होती है।

Go मॉड्यूल्स के माध्यम से go-message स्थापित करें

go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"

स्ट्रीमिंग ईमेल पार्सिंग

go-message एक स्ट्रीमिंग पार्सर प्रदान करता है जो ईमेल संदेशों को क्रमिक रूप से प्रोसेस करता है बिना पूरी सामग्री को मेमोरी में लोड किए। यह बड़े ईमेल या उच्च-आयतन मेल प्रोसेसिंग को संभालने में विशेष रूप से लाभदायक है। पार्सर हेडर और बॉडी पार्ट्स को क्रमशः पढ़ता है, जिससे डेवलपर्स वास्तविक समय में संदेशों का निरीक्षण या फ़ॉरवर्ड कर सकते हैं। यह RFC‑अनुपालन और विकृत दोनों प्रकार के संदेशों को सहजता से सपोर्ट करता है, जिससे यह प्रोडक्शन मेल सर्वरों के लिए उपयुक्त बनता है। Go के `io.Reader` का उपयोग करके, लाइब्रेरी नेटवर्क और फ़ाइल I/O ऑपरेशन्स के साथ स्वाभाविक रूप से एकीकृत होती है।

स्ट्रीमिंग API के माध्यम से ईमेल संदेश को कैसे पार्स करें?

import (
	"bytes"
	"github.com/emersion/go-message"
)

func parseEmail(data []byte) error {
	r := bytes.NewReader(data)
	m, err := message.Read(r)
	if err != nil {
		return err
	}
	// Access headers and body parts
	return nil
}

MIME मल्टीपार्ट हैंडलिंग

go-message पूरी तरह से RFC 2045 और RFC 2046 में परिभाषित MIME मल्टीपार्ट संदेशों को पार्स और जेनरेट करने का समर्थन करता है। डेवलपर्स सहज APIs का उपयोग करके जटिल मल्टीपार्ट संरचनाओं—जिसमें नेस्टेड पार्ट्स भी शामिल हैं—के माध्यम से नेविगेट कर सकते हैं। लाइब्रेरी स्वचालित रूप से ट्रांसफर एन्कोडिंग्स (जैसे base64, quoted-printable) को डिकोड करती है और `Part` इंटरफ़ेस के माध्यम से व्यक्तिगत पार्ट्स तक पहुंच प्रदान करती है। यह मजबूत ईमेल कंपोज़िशन और अटैचमेंट्स, HTML/टेक्स्ट विकल्प, तथा एम्बेडेड रिसोर्सेज़ को निकालने में सक्षम बनाता है। इसकी स्ट्रीमिंग प्रकृति बड़े मल्टीपार्ट संदेशों में कई पार्ट्स होने पर भी कुशल हैंडलिंग सुनिश्चित करती है।

ईमेल से मल्टीपार्ट भागों को कैसे निकालें?

import (
	"github.com/emersion/go-message"
	"github.com/emersion/go-message/textproto"
)

func extractParts(m *message.Message) error {
	if m.Multipart() {
		for _, p := range m.Parts() {
			// Process each part (e.g., text, attachment)
			mediaType, params, _ := p.Header.MediaType()
			if mediaType == "text/plain" {
				// Read plain text content
				content, _ := io.ReadAll(p.Body)
			}
		}
	}
	return nil
}

कैरेक्टर सेट और एन्कोडिंग समर्थन

go-message ईमेल हेडर और बॉडी कंटेंट के लिए मजबूत स्वचालित कैरेक्टरसेट और एन्कोडिंग हैंडलिंग शामिल करता है। यह RFC 2047-एन्कोडेड हेडर (जैसे, `=?utf-8?B?...?=`) और विभिन्न कैरेक्टरसेट (UTF-8, ISO-8859, आदि) में बॉडी टेक्स्ट को डिकोड करने का समर्थन करता है। वैकल्पिक `github.com/emersion/go-message/charset` पैकेज को इम्पोर्ट करके, डेवलपर्स `golang.org/x/text/encoding` के माध्यम से सभी पंजीकृत IANA कैरेक्टरसेट तक पहुंच प्राप्त कर सकते हैं। यह अंतर्राष्ट्रीय ईमेल कंटेंट, जिसमें गैर-लैटिन स्क्रिप्ट और विशेष प्रतीक शामिल हैं, को मैन्युअल कैरेक्टरसेट डिटेक्शन या रूपांतरण के बिना सटीक रूप से रेंडर करने को सुनिश्चित करता है।

कैरेक्टरसेट-एन्कोडेड हेडर को कैसे डिकोड करें?

import (
	"github.com/emersion/go-message"
	_ "github.com/emersion/go-message/charset" // Enable all charsets
)

func decodeSubject(m *message.Message) (string, error) {
	subject, err := m.Header.Get("Subject")
	if err != nil {
		return "", err
	}
	// Automatically decoded using registered charsets
	return subject, nil
}

DKIM-फ्रेंडली संदेश साइनिंग

go-message को DKIM-फ्रेंडली होने के लिए डिजाइन किया गया है, जिससे क्रिप्टोग्राफिक साइनिंग और वेरिफिकेशन वर्कफ़्लो के साथ सहज एकीकरण संभव हो सके। इसका स्ट्रीमिंग पार्सर संदेश संरचना की अखंडता को बनाए रखता है, जिससे साइनर केवल कैनोनिकलाइज़्ड बॉडी और चयनित हेडर को पुनः-एन्कोडिंग के बिना साइन कर सकते हैं। लाइब्रेरी अनावश्यक ट्रांसफ़ॉर्मेशन (जैसे, लाइन-एंडिंग नॉर्मलाइज़ेशन) से बचती है जो DKIM सिग्नेचर को तोड़ सकते हैं। डेवलपर्स `github.com/emersion/go-dkim` जैसी लाइब्रेरीज़ के साथ go-message को मिलाकर ईमेल साइनिंग पाइपलाइन बना सकते हैं, जिससे डोमेन-आधारित संदेश प्रमाणीकरण के लिए RFC 6376 के अनुपालन को सुनिश्चित किया जा सके।

DKIM साइनिंग के लिए संदेश को कैसे तैयार करें?

import (
	"bytes"
	"github.com/emersion/go-message"
	"github.com/emersion/go-message/textproto"
)

func prepareForDKIM(m *message.Message) (*bytes.Buffer, error) {
	var buf bytes.Buffer
	// Write canonicalized headers and body
	h := m.Header
	h.WriteTo(&buf)
	buf.WriteString("\r\n")
	if _, err := io.Copy(&buf, m.Body); err != nil {
		return nil, err
	}
	return &buf, nil
}
 हिन्दी