1. Produkti
  2.   E-pasts
  3.   GO
  4.   go-message

go-message

 
 

Atvērtā koda Go bibliotēka e-pastam un interneta ziņojumu formātam

Parsējiet, ģenerējiet un apstrādājiet RFC 5322, MIME un Content-Disposition galvenes, izmantojot plūsmas Go API.

Kas ir go-message?

go-message ir augstas veiktspējas, straumējoša Go bibliotēka, kas paredzēta e-pasta ziņojumu parsēšanai un ģenerēšanai, kas atbilst Interneta ziņojumu formātam (RFC 5322), MIME paplašinājumiem (RFC 2045–2047) un Content‑Disposition galvenēm (RFC 2183). Tā ļauj Go izstrādātājiem efektīvi apstrādāt e-pasta saturu, neielādējot visas ziņas atmiņā, padarot to par ideālu risinājumu mērogojamiem pasta serveriem un klientiem. Bibliotēka atbalsta automātisku rakstzīmju kopas atkodēšanu un integrējas nevainojami ar Go standarta bibliotēku.

Veidota, ņemot vērā modularitāti un paplašināmību, go-message ietver īpašas apakšpakotnes, piemēram, `mail` augsta līmeņa pasta apstrādei un `textproto` zemā līmeņa protokola parsēšanai. Tās DKIM‑draudzīgais dizains nodrošina saderību ar mūsdienīgiem e-pasta autentifikācijas darba plūsmām. Ar iebūvētu straumēšanas iespēju un rakstzīmju kopas normalizāciju, go-message vienkāršo sarežģītus e-pasta apstrādes uzdevumus, piemēram, multipart ķermeņu parsēšanu, kodētu galveņu atkodēšanu un ligzduotu MIME struktūru apstrādi — visu to, saglabājot atmiņas efektivitāti un veiktspēju.

Previous Next

Sākšana ar go-message

Lai sāktu izmantot go-message, instalējiet to, izmantojot `go get`, no oficiālā [go-message GitHub](https://github.com/emersion/go-message) krātuves. Ieteicamā pieeja ir izmantot Go moduļus: izpildiet `go get github.com/emersion/go-message` savā projekta direktorijā. Lai nodrošinātu rakstzīmju kopas dekodēšanas atbalstu, iekļaujiet `import _ "github.com/emersion/go-message/charset"`, lai aktivizētu visas standarta kodēšanas. Bibliotēka ir viegla, bez atkarībām, un integrējas gludi esošajās Go lietojumprogrammās.

Instalējiet go-message, izmantojot Go moduļus

go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"

E-pasta plūsmas parsēšana

go-message nodrošina straumējošu parseri, kas apstrādā e-pasta ziņojumus inkrementāli, neielādējot visu saturu atmiņā. Tas ir īpaši izdevīgi, apstrādājot lielus e-pastus vai lielapjoma pasta apstrādi. Parsers lasa galvenes un ķermeņa daļas secīgi, ļaujot izstrādātājiem pārbaudīt vai pārsūtīt ziņojumus reāllaikā. Tas atbalsta gan RFC atbilstošus, gan nepareizi formatētus ziņojumus, padarot to piemērotu ražošanas pasta serveriem. Izmantojot Go `io.Reader`, bibliotēka dabiski integrējas ar tīkla un failu I/O operācijām.

Kā parsēt e-pasta ziņojumu, izmantojot plūsmas 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 daudzdalu apstrāde

go-message pilnībā atbalsta MIME multipart ziņojumu parsēšanu un ģenerēšanu, kā definēts RFC 2045 un RFC 2046. Izstrādātāji var pārvietoties pa sarežģītām multipart struktūrām — ieskaitot ligzdotas daļas —, izmantojot intuitīvas API. Bibliotēka automātiski atkodē pārsūtīšanas kodējumus (piem., base64, quoted‑printable) un nodrošina piekļuvi atsevišķām daļām caur `Part` interfeisu. Tas ļauj izveidot stabilu e-pasta sastādīšanu un izvilkt pielikumus, HTML/teksta alternatīvas un iegultos resursus. Tā straumējošā daba nodrošina efektīvu apstrādi pat lieliem multipart ziņojumiem ar daudzām daļām.

Kā izvilkt multipart daļas no e-pasta?

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
}

Rakstzīmju kopas un kodējuma atbalsts

go-message ietver robustu automātisku rakstzīmju kopas un kodējuma apstrādi e-pasta galveņu un ķermeņa saturam. Tas atbalsta RFC 2047 kodētu galveņu dekodēšanu (piemēram, `=?utf-8?B?...?=`) un ķermeņa teksta dekodēšanu dažādās rakstzīmju kopās (UTF-8, ISO-8859 utt.). Importējot papildu pakotni `github.com/emersion/go-message/charset`, izstrādātāji iegūst piekļuvi visām reģistrētajām IANA rakstzīmju kopām caur `golang.org/x/text/encoding`. Tas nodrošina precīzu starptautiskā e-pasta satura attēlošanu, ieskaitot ne‑latīņu rakstus un īpašus simbolus, bez manuālas rakstzīmju kopas noteikšanas vai konvertēšanas.

Kā atkodēt rakstzīmju kopas kodētu galveni?

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-draudzīga ziņojumu parakstīšana

go-message ir izstrādāts, lai būtu DKIM‑draudzīgs, ļaujot nevainojamu integrāciju ar kriptogrāfiskās parakstīšanas un verifikācijas darba plūsmām. Tā plūstošais parsētājs saglabā ziņojuma struktūras integritāti, ļaujot parakstītājiem parakstīt tikai kanonizēto ķermeni un izvēlētās galvenes bez atkārtotas kodēšanas. Bibliotēka izvairās no nevajadzīgām transformācijām (piemēram, rindu beigu normalizācijas), kas varētu pārtraukt DKIM parakstus. Izstrādātāji var izveidot e-pasta parakstīšanas cauruļvadu, kombinējot go-message ar bibliotēkām, piemēram, `github.com/emersion/go-dkim`, nodrošinot atbilstību RFC 6376 domēna balstītai ziņojumu autentifikācijai.

Kā sagatavot ziņojumu DKIM parakstīšanai?

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
}
 Latviski