1. Produkter
  2.   E-post
  3.   GO
  4.   go-message

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.

Previous Next

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
}
 Norsk