
go-message
E-posta ve Internet Mesaj Formatı için Açık Kaynak Go Kütüphanesi
RFC 5322, MIME ve Content-Disposition Başlıklarını Akış Go API'si ile Ayrıştırın, Oluşturun ve İşleyin.
go-message nedir?
go-message, Internet Message Format (RFC 5322), MIME uzantıları (RFC 2045–2047) ve Content-Disposition başlıkları (RFC 2183) ile uyumlu e-posta mesajlarını ayrıştırmak ve oluşturmak için tasarlanmış yüksek performanslı, akış tabanlı bir Go kütüphanesidir. Go geliştiricilerinin tüm mesajları belleğe yüklemeden e-posta içeriğini verimli bir şekilde işlemesini sağlar, bu da ölçeklenebilir posta sunucuları ve istemcileri için idealdir. Kütüphane otomatik karakter kümesi çözümlemeyi destekler ve Go’nun standart kütüphanesiyle sorunsuz bir şekilde bütünleşir.
Modülerlik ve genişletilebilirlik düşünülerek inşa edilen go-message, yüksek seviyeli posta işleme için `mail` ve düşük seviyeli protokol ayrıştırması için `textproto` gibi özel alt paketler içerir. DKIM dostu tasarımı, modern e-posta kimlik doğrulama iş akışlarıyla uyumluluğu garanti eder. Yerleşik akış yetenekleri ve karakter kümesi normalleştirmesi sayesinde go-message, çok parçalı gövdelerin ayrıştırılması, kodlanmış başlıkların çözülmesi ve iç içe MIME yapılarının işlenmesi gibi karmaşık e-posta işleme görevlerini basitleştirir—bütün bunları bellek verimliliği ve performansı koruyarak yapar.
go-message ile Başlarken
go-message'i kullanmaya başlamak için, resmi [go-message GitHub](https://github.com/emersion/go-message) deposundan `go get` ile kurun. Önerilen yöntem Go modüllerini kullanmaktır: proje dizininizde `go get github.com/emersion/go-message` komutunu çalıştırın. Karakter seti kod çözme desteği için, tüm standart kodlamaları etkinleştirmek amacıyla `import _ "github.com/emersion/go-message/charset"` ekleyin. Kütüphane hafiftir, bağımlılık içermez ve mevcut Go uygulamalarına sorunsuz bir şekilde entegre olur.
Go Modülleri ile go-message'ı Kurun
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
E-posta Akışını Ayrıştırma
go-message, e-posta mesajlarını belleğe tüm içeriği yüklemeden artımlı olarak işleyen bir akış ayrıştırıcısı sağlar. Bu, büyük e-postaların veya yüksek hacimli posta işleme işlemlerinin yönetilmesinde özellikle faydalıdır. Ayrıştırıcı, başlıkları ve gövde bölümlerini sırasıyla okur, geliştiricilerin mesajları gerçek zamanlı olarak incelemesine veya yönlendirmesine olanak tanır. Hem RFC uyumlu hem de hatalı mesajları sorunsuz bir şekilde destekler, bu da onu üretim posta sunucuları için uygun kılar. Go’nun `io.Reader` özelliğinden yararlanarak kütüphane, ağ ve dosya I/O işlemleriyle doğal olarak bütünleşir.
Akış API'si ile E-posta Mesajı Nasıl Ayrıştırılır?
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 Çok Parçalı İşleme
go-message, RFC 2045 ve RFC 2046'da tanımlandığı gibi MIME çok parçalı mesajların ayrıştırılmasını ve üretilmesini tam olarak destekler. Geliştiriciler, sezgisel API'leri kullanarak karmaşık çok parçalı yapılar—iç içe parçalar dahil—arasında gezinebilir. Kütüphane, aktarım kodlamalarını (ör. base64, quoted-printable) otomatik olarak çözer ve `Part` arayüzü aracılığıyla bireysel parçalara erişim sağlar. Bu, sağlam e-posta oluşturmayı ve eklerin, HTML/metin alternatiflerinin ve gömülü kaynakların çıkarılmasını mümkün kılar. Akış yapısı, çok sayıda parçaya sahip büyük çok parçalı mesajların bile verimli bir şekilde işlenmesini sağlar.
E-postadan Çok Parçalı Bölümler Nasıl Çıkarılır?
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
}
Karakter Kümesi ve Kodlama Desteği
go-message, e-posta başlıkları ve gövde içeriği için sağlam otomatik karakter kümesi ve kodlama işleme sağlar. RFC 2047 kodlu başlıkların (ör. `=?utf-8?B?...?=`) ve çeşitli karakter kümelerindeki (UTF-8, ISO-8859, vb.) gövde metninin çözülmesini destekler. İsteğe bağlı `github.com/emersion/go-message/charset` paketini içe aktararak, geliştiriciler `golang.org/x/text/encoding` aracılığıyla kayıtlı tüm IANA karakter kümelerine erişir. Bu, manuel karakter kümesi algılaması veya dönüşümü olmadan, Latin dışı yazı sistemleri ve özel semboller dahil uluslararası e-posta içeriğinin doğru şekilde görüntülenmesini sağlar.
Karakter Kümesi Kodlu Başlığı Nasıl Çözülür?
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-Uyumlu Mesaj İmzalama
go-message, DKIM dostu olacak şekilde tasarlanmıştır ve kriptografik imzalama ve doğrulama iş akışlarıyla sorunsuz entegrasyon sağlar. Akış tabanlı ayrıştırıcısı mesaj yapısının bütünlüğünü korur, imzalayanların yalnızca kanonikleştirilmiş gövdeyi ve seçili başlıkları yeniden kodlamadan imzalamasına izin verir. Kütüphane, DKIM imzalarını bozabilecek gereksiz dönüşümlerden (ör. satır sonu normalleştirmesi) kaçınır. Geliştiriciler, `github.com/emersion/go-dkim` gibi kütüphanelerle go-message'ı birleştirerek e-posta imzalama boru hatları oluşturabilir ve alan tabanlı mesaj kimlik doğrulaması için RFC 6376'ya uyumu sağlar.
DKIM İmzalama İçin Bir Mesaj Nasıl Hazırlanır?
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
}
