1. Produse
  2.   E-mail
  3.   GO
  4.   go-message

go-message

 
 

Bibliotecă Go Open Source pentru Email și Formatul de Mesaje pe Internet

Parsează, generează și gestionează anteturile RFC 5322, MIME și Content-Disposition prin API-ul Go de streaming.

Ce este go-message?

go-message este o bibliotecă Go de înaltă performanță, cu streaming, concepută pentru parsarea și generarea mesajelor de e‑mail conforme cu Formatul de Mesaj Internet (RFC 5322), extensiile MIME (RFC 2045–2047) și antetele Content‑Disposition (RFC 2183). Permite dezvoltatorilor Go să proceseze conținutul e‑mailului eficient, fără a încărca mesajele întregi în memorie, făcându‑la ideală pentru servere și clienți de mail scalabili. Biblioteca suportă decodarea automată a charset‑ului și se integrează perfect cu biblioteca standard a limbajului Go.

Construită având în vedere modularitatea și extensibilitatea, go-message include subpachete dedicate precum `mail` pentru gestionarea la nivel înalt a e‑mailurilor și `textproto` pentru parsarea la nivel scăzut a protocolului. Designul său prietenos cu DKIM asigură compatibilitatea cu fluxurile moderne de autentificare a e‑mailurilor. Cu capabilități de streaming încorporate și normalizare a charset‑ului, go-message simplifică sarcinile complexe de procesare a e‑mailurilor, cum ar fi parsarea corpurilor multipart, decodarea antetelor codificate și gestionarea structurilor MIME imbricate — toate acestea menținând eficiența memoriei și performanța.

Previous Next

Începerea utilizării go-message

Pentru a începe să utilizați go-message, instalați-l prin `go get` din depozitul oficial [go-message GitHub](https://github.com/emersion/go-message). Abordarea recomandată este să folosiți module Go: rulați `go get github.com/emersion/go-message` în directorul proiectului dumneavoastră. Pentru suportul de decodare a setului de caractere, includeți `import _ "github.com/emersion/go-message/charset"` pentru a activa toate codările standard. Biblioteca este ușoară, fără dependențe și se integrează perfect în aplicațiile Go existente.

Instalați go-message prin Go Modules

go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"

Analiza e-mailurilor prin streaming

go-message oferă un parser în flux care procesează mesajele de email incremental, fără a încărca întregul conținut în memorie. Acest lucru este deosebit de benefic pentru gestionarea emailurilor mari sau a procesării de volum mare de corespondență. Parserul citește anteturile și părțile corpului în mod secvențial, permițând dezvoltatorilor să inspecteze sau să redirecționeze mesajele în timp real. Suportă atât mesajele conforme cu RFC, cât și pe cele malformate, cu grație, făcându-l potrivit pentru servere de mail în producție. Prin valorificarea `io.Reader` din Go, biblioteca se integrează natural cu operațiunile de rețea și I/O de fișiere.

Cum să analizați un mesaj de e-mail prin API-ul de streaming?

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
}

Gestionarea MIME Multipart

go-message suportă pe deplin parsarea și generarea mesajelor MIME multipart, așa cum sunt definite în RFC 2045 și RFC 2046. Dezvoltatorii pot naviga structuri multipart complexe—incluzând părți imbricate—folosind API-uri intuitive. Biblioteca decodează automat codările de transfer (de ex., base64, quoted-printable) și oferă acces la părțile individuale prin interfața `Part`. Aceasta permite compunerea robustă a emailurilor și extragerea atașamentelor, alternativelor HTML/text și a resurselor încorporate. Natura sa în flux asigură o gestionare eficientă chiar și pentru mesaje multipart mari cu multe părți.

Cum să extragi părțile multipart dintr-un e-mail?

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
}

Suport pentru seturi de caractere și codare

go-message include gestionare robustă automată a seturilor de caractere și a codificării pentru antetele și conținutul mesajelor de email. Suportă decodarea antetelor codificate conform RFC 2047 (de exemplu, `=?utf-8?B?...?=`) și a textului din corp în diverse seturi de caractere (UTF-8, ISO-8859, etc.). Prin importarea pachetului opțional `github.com/emersion/go-message/charset`, dezvoltatorii au acces la toate seturile de caractere IANA înregistrate prin `golang.org/x/text/encoding`. Aceasta asigură redarea corectă a conținutului de email internațional, inclusiv a scripturilor non-latine și a simbolurilor speciale, fără detectarea sau conversia manuală a setului de caractere.

Cum să decodezi un antet codificat în charset?

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
}

Semnarea mesajelor compatibilă cu DKIM

go-message este conceput pentru a fi compatibil cu DKIM, permițând integrarea fără întreruperi cu fluxurile de semnare și verificare criptografică. Parserul său în flux păstrează integritatea structurii mesajului, permițând semnatarilor să semneze doar corpul canonic și antetele selectate fără re-codare. Biblioteca evită transformările inutile (de exemplu, normalizarea sfârșiturilor de linie) care ar putea rupe semnăturile DKIM. Dezvoltatorii pot construi lanțuri de semnare a emailurilor combinând go-message cu biblioteci precum `github.com/emersion/go-dkim`, asigurând conformitatea cu RFC 6376 pentru autentificarea mesajelor bazate pe domeniu.

Cum să pregătești un mesaj pentru semnarea 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
}
 Română