
go-message
Open Source Go-bibliotek for e-post og Internettmeldingsformat
Parse, generer og håndter RFC 5322, MIME og Content-Disposition‑overskrifter via Streaming Go API.
Hva er go-message?
go-message er et høyytelses, streaming‑basert Go‑bibliotek designet for å parse og generere e‑postmeldinger som følger Internet Message Format (RFC 5322), MIME‑utvidelser (RFC 2045–2047) og Content‑Disposition‑headere (RFC 2183). Det gjør det mulig for Go‑utviklere å behandle e‑postinnhold effektivt uten å laste hele meldinger inn i minnet, noe som gjør det ideelt for skalerbare e‑postservere og -klienter. Biblioteket støtter automatisk tegnsett‑dekoding og integreres sømløst med Go‑standardbiblioteket.
Bygget med modularitet og utvidbarhet i tankene, inkluderer go-message dedikerte underpakker som `mail` for høynivå e‑posthåndtering og `textproto` for lavnivå protokoll‑parsing. Dens DKIM‑vennlige design sikrer kompatibilitet med moderne e‑postautentiserings‑arbeidsflyter. Med innebygde streaming‑funksjoner og tegnsett‑normalisering gjør go-message komplekse e‑postbehandlingsoppgaver enklere, som parsing av multipart‑kropper, dekoding av kodede headere og håndtering av nestede MIME‑strukturer — alt mens minneeffektivitet og ytelse opprettholdes.
Kom i gang med go-message
Begynn å bruke go-message ved å installere det via `go get` fra det offisielle [go-message GitHub](https://github.com/emersion/go-message) depotet. Den anbefalte tilnærmingen er å bruke Go-moduler: kjør `go get github.com/emersion/go-message` i prosjektkatalogen din. For støtte for tegnsett‑dekoding, inkluder `import _ "github.com/emersion/go-message/charset"` for å aktivere alle standardkodinger. Biblioteket er lettvekt, uten avhengigheter, og integreres sømløst i eksisterende Go‑applikasjoner.
Installer go-message via Go-moduler
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Strømming av e-postparsing
go-message tilbyr en strømmende parser som behandler e-postmeldinger inkrementelt uten å laste hele innholdet inn i minnet. Dette er spesielt fordelaktig for håndtering av store e-poster eller høyvolum e-postbehandling. Parseren leser overskrifter og kroppsdelene sekvensielt, og gjør det mulig for utviklere å inspisere eller videresende meldinger i sanntid. Den støtter både RFC‑kompatible og feilformede meldinger på en elegant måte, noe som gjør den egnet for produksjonsmailservere. Ved å utnytte Go sin `io.Reader`, integreres biblioteket naturlig med nettverks- og fil‑I/O‑operasjoner.
Hvordan analysere en e-postmelding via 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
}
Håndtering av MIME-multipart
go-message støtter fullt ut parsing og generering av MIME multipart‑meldinger som definert i RFC 2045 og RFC 2046. Utviklere kan navigere i komplekse multipart‑strukturer—inkludert nestede deler—ved hjelp av intuitive API‑er. Biblioteket dekoder automatisk overføringskodinger (f.eks. base64, quoted‑printable) og gir tilgang til individuelle deler via `Part`‑grensesnittet. Dette muliggjør robust e‑postkomponering og uthenting av vedlegg, HTML/tekst‑alternativer og innebygde ressurser. Dens strømmende natur sikrer effektiv håndtering selv for store multipart‑meldinger med mange deler.
Hvordan hente ut multipart-deler fra en e-post?
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
}
Støtte for tegnsett og koding
go-message inkluderer robust automatisk håndtering av tegnsett og koding for e-posthoder og brødtekst. Den støtter dekoding av RFC 2047-kodede hoder (f.eks. `=?utf-8?B?...?=`) og brødtekst i ulike tegnsett (UTF-8, ISO-8859, osv.). Ved å importere den valgfrie `github.com/emersion/go-message/charset`-pakken får utviklere tilgang til alle registrerte IANA-tegnsett via `golang.org/x/text/encoding`. Dette sikrer nøyaktig gjengivelse av internasjonalt e-postinnhold, inkludert ikke-latinske skript og spesialtegn, uten manuell tegnsettdeteksjon eller konvertering.
Hvordan dekode en tegnsettkodet header?
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-vennlig meldingssignering
go-message er designet for å være DKIM-vennlig, og muliggjør sømløs integrasjon med kryptografiske signerings- og verifiseringsarbeidsflyter. Dens streaming-parser bevarer meldingsstrukturens integritet, slik at signatører kan signere kun den kanoniserte kroppen og utvalgte hoder uten å re-koding. Biblioteket unngår unødvendige transformasjoner (f.eks. normalisering av linjeskift) som kan ødelegge DKIM-signaturer. Utviklere kan bygge e-post-signerings-pipelines ved å kombinere go-message med biblioteker som `github.com/emersion/go-dkim`, og sikre overholdelse av RFC 6376 for domenebasert meldingsautentisering.
Hvordan forberede en melding for DKIM-signering?
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
}
