1. Táirgí
  2.   Ríomhphost
  3.   GO
  4.   go-message

go-message

 
 

Leabharlann Go Foinse Oscailte le haghaidh Ríomhphoist & Formáid Teachtaireachta Idirlín

Parsaigh, Ginigh & Láimhseáil Ceanntásca RFC 5322, MIME, agus Content-Disposition trí API Go Sruthaithe.

Cad é go-message?

go-message is a high-performance, streaming Go library designed for parsing and generating email messages conforming to the Internet Message Format (RFC 5322), MIME extensions (RFC 2045–2047), and Content-Disposition headers (RFC 2183). It enables Go developers to process email content efficiently without loading entire messages into memory, making it ideal for scalable mail servers and clients. The library supports automatic charset decoding and integrates seamlessly with Go’s standard library.

Built with modularity and extensibility in mind, go-message includes dedicated subpackages like `mail` for high-level mail handling and `textproto` for low-level protocol parsing. Its DKIM-friendly design ensures compatibility with modern email authentication workflows. With built-in streaming capabilities and charset normalization, go-message simplifies complex email processing tasks such as parsing multipart bodies, decoding encoded headers, and handling nested MIME structures—all while maintaining memory efficiency and performance.

Previous Next

Ag tosú le go-message

Chun tosú ag baint úsáide as go-message, suiteáil é trí `go get` ón stór oifigiúil [GitHub go-message](https://github.com/emersion/go-message). Is é an cur chuige molta úsáid a bhaint as modúil Go: rith `go get github.com/emersion/go-message` i dteanga tionscadail. Chun tacaíocht díchódaíochta charset a fháil, cuir `import _ "github.com/emersion/go-message/charset"` san áireamh chun gach ionchódú caighdeánach a chumasú. Tá an leabharlann éadrom, gan spleáchas, agus leannann sé go réidh isteach i bhfeidhmchláir Go atá ann cheana.

Suiteáil go-message trí Mhodúil Go

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

Parsáil Ríomhphoist Sruthaithe

cuireann go-message parser sruthaithe ar fáil a phróiseálann teachtaireachtaí ríomhphoist go hincrimintí gan an t-ábhar iomlán a luchtú i gcuimhne. Tá sé seo go háirithe úsáideach chun ríomhphoist mhóra nó próiseáil ríomhphoist le mór-údarás a láimhseáil. Léann an parser na ceanntásca agus na codanna corp go seicheamhach, ag ligean d'fhorbróirí iniúchadh nó seoladh teachtaireachtaí i bhfíor-am. Tacaíonn sé le teachtaireachtaí a chomhlíonann RFC agus teachtaireachtaí míchumtha go grásta, rud a fhágann go bhfuil sé oiriúnach do fhreastalaithe ríomhphoist táirgthe. Trí úsáid a bhaint as `io.Reader` ó Go, comhtháthaíonn an leabharlann go nádúrtha le hoibríochtaí I/O líonra agus comhad.

Conas Teachtaireacht Ríomhphoist a Pharsáil trí API Sruthaithe?

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
}

Láimhseáil Iolraithe MIME

cuireann go-message tacaíocht iomlán ar parsáil agus ar ghiniúint teachtaireachtaí MIME ilchuidí mar atá sainithe i RFC 2045 agus RFC 2046. Is féidir le forbróirí nascleanúint a dhéanamh ar struchtúir ilchuidí casta—cuidí neadaithe san áireamh—ag baint úsáide as APIanna intuítíve. Déanann an leabharlann díchódú go huathoibríoch ar ionchódaíochtaí aistrithe (m.sh., base64, quoted‑printable) agus soláthraíonn sé rochtain ar na codanna aonair tríd an gcomhéadan `Part`. Cuireann sé seo ar chumas cumadóireacht ríomhphoist láidir agus baint amach iatáin, roghanna HTML/téacs, agus acmhainní leabaithe. Cinntíonn a nádúr sruthaithe láimhseáil éifeachtach fiú do theachtaireachtaí ilchuidí móra le go leor codanna.

Conas Páirteanna Ilchodach a Bhaint ó Ríomhphost?

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
}

Tacaíocht Carachtair & Ionchódú

go-message cuimsíonn láimhseáil láidir uathoibríoch charset agus ionchódú do cheanntáisc ríomhphoist agus do chorp an teachtaireachta. Tacaíonn sé le díchódú ceanntásca i ndéanfar ionchódú RFC 2047 (m.sh., `=?utf-8?B?...?=`) agus téacs corp i go leor charsetanna (UTF-8, ISO-8859, srl.). Trí an pacáiste roghnach `github.com/emersion/go-message/charset` a iompórtáil, faigheann forbróirí rochtain ar gach charset IANA cláraithe trí `golang.org/x/text/encoding`. Cinntíonn sé seo rindreáil chruinn ar ábhar ríomhphoist idirnáisiúnta, lena n-áirítear clónna neamh-Latin agus siombailí speisialta, gan braitear charset de láimh ná tiontú.

Conas Ceanntásc Codáilte le Carachtar-Set a Dhíchódú?

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
}

Síniú Teachtaireachta a oireann do DKIM

Tá go-message deartha chun a bheith DKIM-ciasúil, ag cumas comhtháthú gan uaim le sreabhadh sínithe criptithe agus sreabhadh fíorú. Coimeádann a pharsálaí sruthaithe sláine struchtúr na teachtaireachta, ag ligean do shínitheoirí síniú ach an corp canónach agus na ceanntáisc roghnaithe gan athionchódú. Seachnaíonn an leabharlann athrú nach gá (m.sh., caighdeánú deiridh líne) a d'fhéadfadh sínithe DKIM a bhriseadh. Is féidir le forbróirí píblíneanna sínithe ríomhphoist a thógáil trí ghníomhú go-message le leabharlanna mar `github.com/emersion/go-dkim`, ag cinntiú comhlíontacht le RFC 6376 le haghaidh fíordheimhniúcháin teachtaireachta bunaithe ar fhearann.

Conas Teachtaireacht a Ullmhú le haghaidh Sínithe 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
}
 Gaeilge