
go-message
Открытая библиотека Go для электронной почты и формата интернет‑сообщений
Разбирайте, генерируйте и обрабатывайте заголовки RFC 5322, MIME и Content-Disposition с помощью потокового API Go.
Что такое go-message?
go-message — это высокопроизводительная потоковая библиотека Go, предназначенная для разбора и создания email‑сообщений, соответствующих формату Internet Message Format (RFC 5322), расширениям MIME (RFC 2045–2047) и заголовкам Content‑Disposition (RFC 2183). Она позволяет разработчикам Go эффективно обрабатывать содержимое писем без загрузки полностью сообщений в память, что делает её идеальной для масштабируемых почтовых серверов и клиентов. Библиотека поддерживает автоматическое декодирование наборов символов и бесшовно интегрируется со стандартной библиотекой Go.
Созданная с учётом модульности и расширяемости, go-message включает специализированные подпакеты, такие как `mail` для высокоуровневой обработки почты и `textproto` для низкоуровневого разбора протоколов. Её дизайн, ориентированный на DKIM, обеспечивает совместимость с современными рабочими процессами аутентификации электронной почты. Благодаря встроенным возможностям потоковой передачи и нормализации наборов символов, go-message упрощает сложные задачи обработки email, такие как разбор multipart‑телов, декодирование закодированных заголовков и обработка вложенных MIME‑структур — всё это при сохранении эффективности использования памяти и производительности.
Начало работы с go-message
Чтобы начать использовать go-message, установите его через `go get` из официального репозитория [GitHub go-message](https://github.com/emersion/go-message). Рекомендуемый подход — использовать модули Go: выполните `go get github.com/emersion/go-message` в каталоге вашего проекта. Для поддержки декодирования наборов символов включите `import _ "github.com/emersion/go-message/charset"`, чтобы активировать все стандартные кодировки. Библиотека лёгкая, не имеет зависимостей и легко интегрируется в существующие Go‑приложения.
Установите go-message через Go Modules
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Потоковый разбор электронной почты
go-message предоставляет потоковый парсер, который обрабатывает электронные сообщения постепенно, не загружая весь контент в память. Это особенно полезно при работе с большими письмами или обработкой большого объёма почты. Парсер последовательно читает заголовки и части тела, позволяя разработчикам инспектировать или пересылать сообщения в реальном времени. Он поддерживает как сообщения, соответствующие RFC, так и некорректные, делая его пригодным для производственных почтовых серверов. Используя `io.Reader` из Go, библиотека естественно интегрируется с сетевыми и файловыми операциями ввода‑вывода.
Как разобрать сообщение электронной почты через потоковый 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
}
Обработка MIME multipart
go-message полностью поддерживает разбор и генерацию MIME multipart сообщений в соответствии с RFC 2045 и RFC 2046. Разработчики могут перемещаться по сложным multipart структурам — включая вложенные части — с помощью интуитивных API. Библиотека автоматически декодирует кодировки передачи (например, base64, quoted-printable) и предоставляет доступ к отдельным частям через интерфейс `Part`. Это обеспечивает надёжную композицию писем и извлечение вложений, альтернатив HTML/текст, а также встроенных ресурсов. Его потоковая природа гарантирует эффективную обработку даже больших multipart сообщений с множеством частей.
Как извлечь части multipart из электронного письма?
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
}
Поддержка наборов символов и кодировок
go-message включает надёжную автоматическую обработку наборов символов и кодировок для заголовков и содержимого писем. Он поддерживает декодирование заголовков, закодированных по RFC 2047 (например, `=?utf-8?B?...?=`) и текста тела в различных наборах символов (UTF-8, ISO-8859 и т.д.). При импорте необязательного пакета `github.com/emersion/go-message/charset` разработчики получают доступ ко всем зарегистрированным наборам символов IANA через `golang.org/x/text/encoding`. Это обеспечивает точное отображение международного почтового контента, включая нелатинские скрипты и специальные символы, без необходимости ручного определения или преобразования кодировки.
Как декодировать заголовок, закодированный в наборе символов?
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
go-message разработан с учётом совместимости с DKIM, обеспечивая бесшовную интеграцию в процессы криптографической подписи и проверки. Его потоковый парсер сохраняет целостность структуры сообщения, позволяя подписантам подписывать только канонизированное тело и выбранные заголовки без повторного кодирования. Библиотека избегает ненужных преобразований (например, нормализации переводов строк), которые могут нарушить DKIM‑подписи. Разработчики могут создавать конвейеры подписи писем, комбинируя go-message с библиотеками вроде `github.com/emersion/go-dkim`, гарантируя соответствие RFC 6376 для доменно‑ориентированной аутентификации сообщений.
Как подготовить сообщение для подписи 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
}
