
go-message
Biblioteca Go de código abierto para Correo Electrónico y Formato de Mensaje de Internet
Analiza, genera y maneja los encabezados RFC 5322, MIME y Content-Disposition mediante la API Go de transmisión.
¿Qué es go-message?
go-message es una biblioteca de Go de alto rendimiento y transmisión diseñada para analizar y generar mensajes de correo electrónico que cumplen con el Formato de Mensaje de Internet (RFC 5322), extensiones MIME (RFC 2045–2047) y encabezados Content-Disposition (RFC 2183). Permite a los desarrolladores de Go procesar el contenido del correo electrónico de manera eficiente sin cargar mensajes completos en memoria, lo que la hace ideal para servidores y clientes de correo escalables. La biblioteca admite la decodificación automática de charset e se integra sin problemas con la biblioteca estándar de Go.
Construida con modularidad y extensibilidad en mente, go-message incluye subpaquetes dedicados como `mail` para el manejo de correo de alto nivel y `textproto` para el análisis de protocolos de bajo nivel. Su diseño amigable con DKIM garantiza la compatibilidad con flujos de trabajo modernos de autenticación de correo electrónico. Con capacidades de transmisión integradas y normalización de charset, go-message simplifica tareas complejas de procesamiento de correo como analizar cuerpos multipart, decodificar encabezados codificados y manejar estructuras MIME anidadas, todo mientras mantiene la eficiencia de memoria y el rendimiento.
Primeros pasos con go-message
Para comenzar a usar go-message, instálalo mediante `go get` desde el repositorio oficial de [GitHub de go-message](https://github.com/emersion/go-message). El enfoque recomendado es usar módulos de Go: ejecuta `go get github.com/emersion/go-message` en el directorio de tu proyecto. Para soporte de decodificación de juegos de caracteres, incluye `import _ \"github.com/emersion/go-message/charset\"` para habilitar todas las codificaciones estándar. La biblioteca es ligera, sin dependencias y se integra sin problemas en aplicaciones Go existentes.
Instalar go-message mediante módulos Go
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Análisis de correo electrónico en streaming
go-message proporciona un analizador de transmisión que procesa los mensajes de correo electrónico de forma incremental sin cargar todo el contenido en memoria. Esto es especialmente beneficioso para manejar correos electrónicos grandes o procesamiento de correo de alto volumen. El analizador lee los encabezados y las partes del cuerpo secuencialmente, lo que permite a los desarrolladores inspeccionar o reenviar mensajes en tiempo real. Soporta tanto mensajes compatibles con RFC como mensajes mal formados de manera elegante, lo que lo hace adecuado para servidores de correo en producción. Al aprovechar el `io.Reader` de Go, la biblioteca se integra de forma natural con operaciones de E/S de red y de archivos.
¿Cómo analizar un mensaje de correo electrónico mediante la API 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
}
Manejo de multipartes MIME
go-message admite completamente el análisis y la generación de mensajes MIME multipartes según lo definido en RFC 2045 y RFC 2046. Los desarrolladores pueden navegar por estructuras multipartes complejas—incluyendo partes anidadas—utilizando APIs intuitivas. La biblioteca decodifica automáticamente las codificaciones de transferencia (p. ej., base64, quoted‑printable) y brinda acceso a las partes individuales a través de la interfaz `Part`. Esto permite una composición de correo robusta y la extracción de archivos adjuntos, alternativas HTML/texto y recursos incrustados. Su naturaleza de transmisión garantiza un manejo eficiente incluso para mensajes multipartes grandes con muchas partes.
¿Cómo extraer partes multipart de un correo electrónico?
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
}
Compatibilidad con juegos de caracteres y codificación
go-message incluye un manejo robusto y automático de juegos de caracteres y codificaciones para los encabezados y el contenido del cuerpo de los correos electrónicos. Soporta la decodificación de encabezados codificados según RFC 2047 (p. ej., `=?utf-8?B?...?=`) y texto del cuerpo en varios juegos de caracteres (UTF-8, ISO-8859, etc.). Al importar el paquete opcional `github.com/emersion/go-message/charset`, los desarrolladores obtienen acceso a todos los juegos de caracteres IANA registrados a través de `golang.org/x/text/encoding`. Esto garantiza una representación precisa del contenido de correo internacional, incluidos scripts no latinos y símbolos especiales, sin detección o conversión manual de juegos de caracteres.
¿Cómo decodificar un encabezado codificado en 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 de mensajes compatible con DKIM
go-message está diseñado para ser compatible con DKIM, permitiendo una integración fluida con flujos de trabajo de firma y verificación criptográfica. Su analizador en streaming preserva la integridad de la estructura del mensaje, permitiendo a los firmantes firmar solo el cuerpo canonizado y los encabezados seleccionados sin volver a codificar. La biblioteca evita transformaciones innecesarias (p. ej., normalización de finales de línea) que podrían romper las firmas DKIM. Los desarrolladores pueden crear canalizaciones de firma de correo combinando go-message con bibliotecas como `github.com/emersion/go-dkim`, garantizando el cumplimiento del RFC 6376 para la autenticación de mensajes basada en dominio.
¿Cómo preparar un mensaje para 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
}
