
go-message
Açıq Mənbəli Go Kitabxanası E-poçt və İnternet Mesaj Formatı üçün
RFC 5322, MIME və Content-Disposition Başlıqlarını Axın Go API-si ilə Parsinq, Yaratma və İdarə Et.
go-message nədir?
go-message, Internet Message Format (RFC 5322), MIME uzantıları (RFC 2045–2047) və Content-Disposition başlıqları (RFC 2183) ilə uyğun gələn e-poçt mesajlarını pars etmək və yaratmaq üçün hazırlanmış yüksək performanslı, axın (streaming) Go kitabxanasıdır. Bu, Go inkişaf etdiricilərinə bütün mesajları yaddaşa yükləmədən e-poçt məzmununu səmərəli şəkildə emal etməyə imkan verir, bu da miqyaslana bilən poçt serverləri və müştəriləri üçün ideal edir. Kitabxana avtomatik charset dekodlaşdırmasını dəstəkləyir və Go‑nun standart kitabxanası ilə problemsiz inteqrasiya olunur.
Modulyarlıq və genişlənə bilənlik nəzərə alınaraq hazırlanmış go-message, `mail` kimi yüksək səviyyəli poçt idarəetməsi üçün və `textproto` kimi aşağı səviyyəli protokol parsinqi üçün ayrılmış alt paketləri ehtiva edir. DKIM‑dostu dizaynı müasir e‑poçt autentifikasiya iş axınları ilə uyğunluğu təmin edir. Daxili axın (streaming) imkanları və charset normallaşdırması sayəsində go-message, multipart bədənlərin parsinqi, kodlaşdırılmış başlıqların dekodlaşdırılması və iç-içə MIME strukturlarının idarə edilməsi kimi mürəkkəb e‑poçt emalı tapşırıqlarını sadələşdirir — bütün bunları yaddaş səmərəliliyi və performansı qoruyaraq həyata keçirir.
go-message ilə başlamaq
go-message istifadə etməyə başlamaq üçün, rəsmi [go-message GitHub](https://github.com/emersion/go-message) deposundan `go get` vasitəsilə quraşdırın. Tövsiyə olunan yanaşma Go modullarından istifadə etməkdir: layihə qovluğunuzda `go get github.com/emersion/go-message` əmri işlədin. Simvol dəsti dekodlaşdırma dəstəyi üçün `import _ "github.com/emersion/go-message/charset"` əlavə edin ki, bütün standart kodlamalar aktiv olsun. Kitabxana yüngül, asılılıqsizdir və mövcud Go tətbiqlərinə problemsiz inteqrasiya olunur.
Go Modulları vasitəsilə go-message quraşdırın
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Axın Email Parsinqi
go-message, e-poçt mesajlarını yaddaşa bütün məzmunu yükləmədən ardıcıl olaraq emal edən axın parseri təmin edir. Bu, xüsusilə böyük e-poçtları və ya yüksək həcmli poçt emalı üçün faydalıdır. Parser başlıqları və gövdə hissələrini ardıcıllıqla oxuyur, inkişafçılara mesajları real vaxtda yoxlamağa və ya yönləndirməyə imkan verir. Həm RFC-ə uyğun, həm də qüsurlu mesajları incəliklə dəstəkləyir, bu da onu istehsal poçt serverləri üçün uyğun edir. Go-nun `io.Reader`-indən istifadə edərək, kitabxana şəbəkə və fayl I/O əməliyyatları ilə təbii şəkildə inteqrasiya olur.
Axın API-si ilə Email Mesajını Necə Pars Etmək Olar?
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 Çox Hissəli İdarəetmə
go-message, RFC 2045 və RFC 2046-da müəyyən edilmiş MIME çoxhissəli mesajların təhlilini və yaradılmasını tam dəstəkləyir. İnkişafçılar intuitiv API-lərdən istifadə edərək mürəkkəb çoxhissəli strukturları—daxili hissələr daxil olmaqla—gəzə bilərlər. Kitabxana transfer kodlamalarını (məsələn, base64, quoted-printable) avtomatik olaraq dekodlayır və `Part` interfeysi vasitəsilə fərdi hissələrə çıxışı təmin edir. Bu, güclü e-poçt tərtibatını və əlavə faylların, HTML/mətn alternativlərinin və yerləşdirilmiş resursların çıxarılmasını mümkün edir. Onun axın təbiəti, çoxsaylı hissəli böyük mesajların belə səmərəli şəkildə idarə olunmasını təmin edir.
E-poçtdan Multipart Hissələri Necə Çıxarmaq Olar?
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
}
Simvol Dəsti və Kodlaşdırma Dəstəyi
go-message e-poçt başlıqları və gövdə məzmunu üçün güclü avtomatik charset və kodlaşdırma idarəetməsini təmin edir. O, RFC 2047‑kodlaşdırılmış başlıqların (məsələn, `=?utf-8?B?...?=`) və müxtəlif charset‑larda (UTF-8, ISO-8859 və s.) gövdə mətninin dekodlaşdırılmasını dəstəkləyir. İstəyə bağlı `github.com/emersion/go-message/charset` paketini idxal edərək, inkişafçılar `golang.org/x/text/encoding` vasitəsilə bütün qeydiyyatdan keçmiş IANA charset‑lərinə çıxış əldə edirlər. Bu, əl ilə charset aşkarlanması və ya çevrilməsi olmadan, qeyri‑Latın skriptləri və xüsusi simvollar daxil olmaqla, beynəlxalq e‑poçt məzmununun dəqiq göstərilməsini təmin edir.
Charset-Şifrələnmiş Başlığı Necə Dekodlaşdırmaq Olar?
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-dostu Mesaj İmzalama
go-message DKIM‑dostu olmaq üçün hazırlanmışdır və kriptoqrafik imzalama və təsdiq iş axınları ilə problemsiz inteqrasiyanı təmin edir. Onun axın parseri mesaj strukturunun bütövlüyünü qoruyur, imzalayanlara yalnız kanonikləşdirilmiş gövdəni və seçilmiş başlıqları yenidən kodlaşdırmadan imzalamağa imkan verir. Kitabxana DKIM imzalarını poza biləcək lazımsız transformasiyalardan (məsələn, sətir sonu normallaşdırması) çəkinir. İnkişafçılar `github.com/emersion/go-dkim` kimi kitabxanalarla go-message-i birləşdirərək e‑poçt imzalama boru kəmərləri qura bilər, bu da domen‑əsaslı mesaj autentifikasiyası üçün RFC 6376‑ya uyğunluğu təmin edir.
DKIM İmzalama Üçün Mesajı Necə Hazırlamaq Olar?
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
}
