
go-message
Відкрита бібліотека Go для електронної пошти та формату інтернет‑повідомлень
Розбирайте, генеруйте та обробляйте заголовки RFC 5322, MIME та Content‑Disposition за допомогою потокового API Go.
Що таке go-message?
go-message — це високопродуктивна потокова бібліотека Go, призначена для розбору та створення електронних листів, що відповідають формату Internet Message Format (RFC 5322), розширенням MIME (RFC 2045–2047) та заголовкам Content‑Disposition (RFC 2183). Вона дозволяє розробникам Go ефективно обробляти вміст електронної пошти без завантаження всіх повідомлень у пам'ять, що робить її ідеальною для масштабованих поштових серверів і клієнтів. Бібліотека підтримує автоматичне декодування набору символів і безшовно інтегрується зі стандартною бібліотекою Go.
Створена з урахуванням модульності та розширюваності, go-message включає спеціалізовані підпакети, такі як `mail` для високорівневої обробки пошти та `textproto` для низькорівневого розбору протоколу. Її дизайн, орієнтований на DKIM, забезпечує сумісність із сучасними процесами автентифікації електронної пошти. Завдяки вбудованим можливостям потокової обробки та нормалізації набору символів, go-message спрощує складні завдання обробки електронної пошти, такі як розбір multipart‑тіл, декодування закодованих заголовків та обробка вкладених MIME‑структур — усе це при збереженні ефективності використання пам'яті та продуктивності.
Початок роботи з go-message
Щоб почати використовувати go-message, встановіть його за допомогою `go get` з офіційного репозиторію [go-message GitHub](https://github.com/emersion/go-message). Рекомендований підхід — використовувати Go modules: виконайте `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, бібліотека природно інтегрується з мережевими та файловими операціями вводу/виводу.
Як розпарсити електронне повідомлення за допомогою 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
}
Обробка 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
}
