
go-message
Nyílt forráskódú Go könyvtár e-mailhez és Internet Message Formátumhoz
Elemzés, generálás és kezelés RFC 5322, MIME és Content-Disposition fejlécekhez streaming Go API-val.
Mi az a go-message?
A go-message egy nagy teljesítményű, streaming Go könyvtár, amely e‑mail üzenetek elemzésére és előállítására lett tervezve, megfelelve az Internet Message Format (RFC 5322), a MIME kiterjesztések (RFC 2045–2047) és a Content‑Disposition fejlécek (RFC 2183) szabványainak. Lehetővé teszi a Go fejlesztők számára, hogy hatékonyan dolgozzanak e‑mail tartalommal anélkül, hogy az egész üzeneteket a memóriába töltenék, így ideális skálázható levelezőszerverek és kliensek számára. A könyvtár automatikus karakterkészlet‑dekódolást támogat, és zökkenőmentesen integrálódik a Go szabványos könyvtárával.
A modularitásra és bővíthetőségre építve a go-message dedikált alcsomagokat tartalmaz, például a `mail`‑t a magas szintű levelezéskezeléshez és a `textproto`‑t az alacsony szintű protokoll‑elemzéshez. DKIM‑barát tervezése biztosítja a kompatibilitást a modern e‑mail hitelesítési munkafolyamatokkal. A beépített streaming képességek és a karakterkészlet normalizálás révén a go-message leegyszerűsíti a bonyolult e‑mail feldolgozási feladatokat, mint a multipart testek elemzése, a kódolt fejlécek dekódolása és a beágyazott MIME struktúrák kezelése – mindezt a memóriahatékonyság és a teljesítmény megőrzése mellett.
Első lépések a go-message használatához
A go-message használatának megkezdéséhez telepítsd a hivatalos [go-message GitHub](https://github.com/emersion/go-message) tárolóból a `go get` paranccsal. Ajánlott megközelítés a Go modulok használata: futtasd a `go get github.com/emersion/go-message` parancsot a projekt könyvtárában. A karakterkészlet dekódolás támogatásához add hozzá a `import _ "github.com/emersion/go-message/charset"` sort, hogy engedélyezd az összes szabványos kódolást. A könyvtár könnyű, függőségmentes, és zökkenőmentesen integrálódik a meglévő Go alkalmazásokba.
A go-message telepítése Go modulok segítségével
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
E-mail streaming elemzése
A go-message egy streaming elemzőt biztosít, amely fokozatosan dolgozza fel az e‑mail üzeneteket anélkül, hogy a teljes tartalmat memóriába töltené. Ez különösen előnyös nagy e‑mailek vagy nagy mennyiségű levélfeldolgozás esetén. Az elemző sorban olvassa a fejléceket és a törzsrészeket, lehetővé téve a fejlesztők számára, hogy valós időben ellenőrizzék vagy továbbítsák az üzeneteket. Támogatja mind az RFC‑nek megfelelő, mind a hibásan formázott üzeneteket, így alkalmas termelési levelezőszerverekre. A Go `io.Reader`‑ének kihasználásával a könyvtár természetesen integrálódik a hálózati és fájl I/O műveletekkel.
Hogyan elemezzünk egy e-mail üzenetet streaming API-n keresztül?
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 többréses kezelés
A go-message teljes mértékben támogatja a MIME multipart üzenetek elemzését és előállítását, ahogyan azt az RFC 2045 és RFC 2046 definiálja. A fejlesztők intuitív API‑k segítségével navigálhatnak a komplex multipart struktúrákban – beleértve a beágyazott részeket is. A könyvtár automatikusan dekódolja az átvitel kódolásait (pl. base64, quoted-printable), és a `Part` interfészen keresztül hozzáférést biztosít az egyes részekhez. Ez lehetővé teszi a robusztus e‑mail összeállítást és a mellékletek, HTML/szöveg alternatívák, valamint a beágyazott erőforrások kinyerését. Streaming jellege biztosítja a hatékony kezelést még nagy, sok részes multipart üzenetek esetén is.
Hogyan lehet kinyerni a multipart részeket egy e‑mailből?
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
}
Karakterkészlet- és kódolástámogatás
A go-message robusztus automatikus karakterkészlet- és kódoláskezelést biztosít az e‑mail fejlécekhez és a törzstartalomhoz. Támogatja az RFC 2047‑kódolt fejlécek (például `=?utf-8?B?...?=`) dekódolását, valamint a törzsszöveg különböző karakterkészletekben (UTF‑8, ISO‑8859, stb.) való kezelését. Az opcionális `github.com/emersion/go-message/charset` csomag importálásával a fejlesztők hozzáférhetnek az összes regisztrált IANA karakterkészlethez a `golang.org/x/text/encoding` segítségével. Ez biztosítja a nemzetközi e‑mail tartalom pontos megjelenítését, beleértve a nem latin írásrendszereket és speciális szimbólumokat, manuális karakterkészlet‑felismerés vagy konverzió nélkül.
Hogyan lehet dekódolni egy karakterkészlet‑kódolt fejlécet?
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-barát üzenet aláírás
A go-message úgy lett tervezve, hogy DKIM-barát legyen, lehetővé téve a kriptográfiai aláírási és ellenőrzési munkafolyamatok zökkenőmentes integrációját. A streaming parser megőrzi az üzenet szerkezeti integritását, így az aláírók csak a kanonikalizált törzset és a kiválasztott fejléceket írhatják alá újrakódolás nélkül. A könyvtár elkerüli a felesleges átalakításokat (például a sorvégek normalizálását), amelyek megtörhetnék a DKIM-aláírásokat. A fejlesztők e‑mail aláírási csővezetékeket építhetnek a go-message-et olyan könyvtárakkal kombinálva, mint a `github.com/emersion/go-dkim`, biztosítva az RFC 6376 szerinti domain‑alapú üzenet‑hitelesítésnek való megfelelést.
Hogyan lehet előkészíteni egy üzenetet a DKIM aláíráshoz?
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
}
