
go-message
Open Source knihovna Go pro e‑mail a formát internetových zpráv
Parsujte, generujte a zpracovávejte hlavičky RFC 5322, MIME a Content-Disposition pomocí streamovacího Go API.
Co je go-message?
go-message je vysoce výkonná, streamovací knihovna Go určená pro parsování a generování e‑mailových zpráv, které vyhovují formátu Internet Message Format (RFC 5322), rozšířením MIME (RFC 2045–2047) a hlavičkám Content‑Disposition (RFC 2183). Umožňuje vývojářům Go efektivně zpracovávat e‑mailový obsah bez načítání celých zpráv do paměti, což ji činí ideální pro škálovatelné poštovní servery a klienty. Knihovna podporuje automatické dekódování znakových sad a bezproblémově se integruje se standardní knihovnou Go.
Navržena s ohledem na modularitu a rozšiřitelnost, go-message obsahuje specializované podbalíčky jako `mail` pro vysokou úroveň zpracování pošty a `textproto` pro nízkoúrovňové parsování protokolu. Její design přátelský k DKIM zajišťuje kompatibilitu s moderními pracovními postupy autentizace e‑mailu. Díky vestavěným streamovacím schopnostem a normalizaci znakových sad go-message zjednodušuje složité úlohy zpracování e‑mailu, jako je parsování multipart těla, dekódování kódovaných hlaviček a práce s vnořenými strukturami MIME — vše při zachování efektivity paměti a výkonu.
Začínáme s go-message
Chcete‑li začít používat go-message, nainstalujte jej pomocí `go get` z oficiálního repozitáře [go-message GitHub](https://github.com/emersion/go-message). Doporučený postup je použít Go moduly: spusťte `go get github.com/emersion/go-message` ve svém adresáři projektu. Pro podporu dekódování znakových sad zahrňte `import _ "github.com/emersion/go-message/charset"`, aby byly povoleny všechny standardní kódování. Knihovna je lehká, bez závislostí a hladce se integruje do existujících Go aplikací.
Instalace go-message pomocí Go modulů
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Streamové zpracování e‑mailů
go-message poskytuje streamovací parser, který zpracovává e‑mailové zprávy inkrementálně, aniž by načítal celý obsah do paměti. To je zvláště výhodné při zpracování velkých e‑mailů nebo vysokého objemu pošty. Parser čte hlavičky a části těla sekvenčně, což vývojářům umožňuje inspekci nebo přeposílání zpráv v reálném čase. Podporuje jak RFC‑kompatibilní, tak i poškozené zprávy elegantně, což jej činí vhodným pro produkční poštovní servery. Využitím Go’s `io.Reader` knihovna přirozeně zapadá do síťových a souborových I/O operací.
Jak parsovat e‑mailovou zprávu pomocí streaming 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
}
Zpracování MIME multipart
go-message plně podporuje parsování a generování MIME multipart zpráv podle RFC 2045 a RFC 2046. Vývojáři mohou navigovat složité multipart struktury — včetně vnořených částí — pomocí intuitivních API. Knihovna automaticky dekóduje přenosové kódování (např. base64, quoted‑printable) a poskytuje přístup k jednotlivým částem přes rozhraní `Part`. To umožňuje robustní tvorbu e‑mailů a extrakci příloh, alternativ HTML/text a vložených zdrojů. Jeho streamovací povaha zajišťuje efektivní zpracování i velkých multipart zpráv s mnoha částmi.
Jak extrahovat multipart části z e‑mailu?
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
}
Podpora znakových sad a kódování
go-message zahrnuje robustní automatické zpracování znakových sad a kódování pro hlavičky e‑mailů a tělo zprávy. Podporuje dekódování hlaviček kódovaných podle RFC 2047 (např. `=?utf-8?B?...?=`) a textu těla v různých znakových sadách (UTF‑8, ISO‑8859 atd.). Importováním volitelného balíčku `github.com/emersion/go-message/charset` získají vývojáři přístup ke všem registrovaným znakovým sadám IANA prostřednictvím `golang.org/x/text/encoding`. To zajišťuje přesné vykreslení mezinárodního e‑mailového obsahu, včetně ne‑latinských skriptů a speciálních symbolů, bez nutnosti ručního detekování nebo konverze znakové sady.
Jak dekódovat hlavičku kódovanou znakovou sadou?
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
}
Podpis zpráv kompatibilní s DKIM
go-message je navržen tak, aby byl přátelský k DKIM, což umožňuje bezproblémovou integraci s pracovními postupy kryptografického podepisování a ověřování. Jeho streamovací parser zachovává integritu struktury zprávy, což umožňuje podepisujícím podepisovat pouze kanonizované tělo a vybrané hlavičky bez pře‑kódování. Knihovna se vyhýbá zbytečným transformacím (např. normalizaci konců řádků), které by mohly narušit DKIM podpisy. Vývojáři mohou vytvářet pipeline pro podepisování e‑mailů kombinací go-message s knihovnami jako `github.com/emersion/go-dkim`, čímž zajistí soulad s RFC 6376 pro autentizaci zpráv založenou na doméně.
Jak připravit zprávu pro podepisování 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
}
