
go-message
Libreria Go open source per email e formato dei messaggi Internet
Analizza, genera e gestisci le intestazioni RFC 5322, MIME e Content-Disposition tramite API Go in streaming.
Che cos'è go-message?
go-message è una libreria Go ad alte prestazioni e in streaming, progettata per l'analisi e la generazione di messaggi email conformi al formato di messaggio Internet (RFC 5322), alle estensioni MIME (RFC 2045–2047) e alle intestazioni Content‑Disposition (RFC 2183). Consente agli sviluppatori Go di elaborare il contenuto delle email in modo efficiente senza caricare interi messaggi in memoria, rendendola ideale per server di posta e client scalabili. La libreria supporta la decodifica automatica dei charset e si integra perfettamente con la libreria standard di Go.
Progettata con modularità ed estensibilità in mente, go-message include sottopacchetti dedicati come `mail` per la gestione della posta a livello alto e `textproto` per l'analisi a basso livello del protocollo. Il suo design compatibile con DKIM garantisce la compatibilità con i moderni flussi di lavoro di autenticazione email. Grazie alle capacità di streaming integrate e alla normalizzazione dei charset, go-message semplifica compiti complessi di elaborazione delle email, come l'analisi di corpi multipart, la decodifica di intestazioni codificate e la gestione di strutture MIME annidate—tutto mantenendo efficienza di memoria e prestazioni.
Iniziare con go-message
Per iniziare a utilizzare go-message, installalo tramite `go get` dal repository ufficiale [GitHub di go-message](https://github.com/emersion/go-message). L'approccio consigliato è utilizzare i moduli Go: esegui `go get github.com/emersion/go-message` nella directory del tuo progetto. Per il supporto alla decodifica dei set di caratteri, includi `import _ "github.com/emersion/go-message/charset"` per abilitare tutte le codifiche standard. La libreria è leggera, priva di dipendenze e si integra senza problemi nelle applicazioni Go esistenti.
Installa go-message tramite Go Modules
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Analisi di email in streaming
go-message fornisce un parser in streaming che elabora i messaggi email in modo incrementale senza caricare l'intero contenuto in memoria. Questo è particolarmente vantaggioso per la gestione di email di grandi dimensioni o per l'elaborazione di grandi volumi di posta. Il parser legge le intestazioni e le parti del corpo in sequenza, consentendo agli sviluppatori di ispezionare o inoltrare i messaggi in tempo reale. Supporta sia i messaggi conformi agli RFC sia quelli malformati in modo elegante, rendendolo adatto ai server di posta in produzione. Sfruttando il `io.Reader` di Go, la libreria si integra naturalmente con le operazioni di I/O di rete e file.
Come analizzare un messaggio email tramite l'API di 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
}
Gestione multipart MIME
go-message supporta pienamente l'analisi e la generazione di messaggi MIME multipart come definiti nelle RFC 2045 e RFC 2046. Gli sviluppatori possono navigare strutture multipart complesse—including nested parts—utilizzando API intuitive. La libreria decodifica automaticamente le codifiche di trasferimento (ad es., base64, quoted‑printable) e fornisce l'accesso alle singole parti tramite l'interfaccia `Part`. Ciò consente una composizione email robusta e l'estrazione di allegati, alternative HTML/testo e risorse incorporate. La sua natura in streaming garantisce una gestione efficiente anche per messaggi multipart di grandi dimensioni con molte parti.
Come estrarre le parti multipart da un'email?
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
}
Supporto per charset e codifica
go-message include una gestione robusta e automatica dei set di caratteri e della codifica per le intestazioni e il contenuto del corpo delle email. Supporta la decodifica delle intestazioni codificate secondo RFC 2047 (ad es., `=?utf-8?B?...?=`) e del testo del corpo in vari set di caratteri (UTF-8, ISO-8859, ecc.). Importando il pacchetto opzionale `github.com/emersion/go-message/charset`, gli sviluppatori ottengono l'accesso a tutti i set di caratteri IANA registrati tramite `golang.org/x/text/encoding`. Ciò garantisce una resa accurata del contenuto email internazionale, inclusi script non latini e simboli speciali, senza rilevamento o conversione manuale del set di caratteri.
Come decodificare un'intestazione codificata con 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
}
Firma di messaggi compatibile con DKIM
go-message è progettato per essere compatibile con DKIM, consentendo un'integrazione fluida con i flussi di lavoro di firma e verifica crittografica. Il suo parser in streaming preserva l'integrità della struttura del messaggio, permettendo ai firmatari di firmare solo il corpo canonicalizzato e le intestazioni selezionate senza ricodifica. La libreria evita trasformazioni non necessarie (ad es., la normalizzazione delle terminazioni di riga) che potrebbero invalidare le firme DKIM. Gli sviluppatori possono costruire pipeline di firma delle email combinando go-message con librerie come `github.com/emersion/go-dkim`, garantendo la conformità a RFC 6376 per l'autenticazione dei messaggi basata sul dominio.
Come preparare un messaggio per la firma 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
}
