1. Produk
  2.   Surel
  3.   GO
  4.   go-message

go-message

 
 

Pustaka Go Open Source untuk Email & Format Pesan Internet

Urai, Hasilkan & Tangani Header RFC 5322, MIME, dan Content-Disposition melalui API Go Streaming.

Apa itu go-message?

go-message adalah pustaka Go berperforma tinggi dan streaming yang dirancang untuk mengurai dan menghasilkan pesan email yang sesuai dengan Internet Message Format (RFC 5322), ekstensi MIME (RFC 2045–2047), dan header Content-Disposition (RFC 2183). Pustaka ini memungkinkan pengembang Go memproses konten email secara efisien tanpa memuat seluruh pesan ke dalam memori, menjadikannya ideal untuk server dan klien email yang dapat diskalakan. Pustaka ini mendukung dekode charset otomatis dan terintegrasi mulus dengan pustaka standar Go.

Dibangun dengan mempertimbangkan modularitas dan extensibilitas, go-message menyertakan subpaket khusus seperti `mail` untuk penanganan email tingkat tinggi dan `textproto` untuk parsing protokol tingkat rendah. Desainnya yang ramah DKIM memastikan kompatibilitas dengan alur kerja otentikasi email modern. Dengan kemampuan streaming bawaan dan normalisasi charset, go-message menyederhanakan tugas pemrosesan email yang kompleks seperti mengurai badan multipart, mendekode header yang di-encode, dan menangani struktur MIME bersarang—semua sambil mempertahankan efisiensi memori dan kinerja.

Previous Next

Memulai dengan go-message

Untuk mulai menggunakan go-message, instal melalui `go get` dari repositori resmi [go-message GitHub](https://github.com/emersion/go-message). Pendekatan yang disarankan adalah menggunakan modul Go: jalankan `go get github.com/emersion/go-message` di direktori proyek Anda. Untuk dukungan dekode charset, sertakan `import _ "github.com/emersion/go-message/charset"` untuk mengaktifkan semua enkoding standar. Perpustakaan ini ringan, bebas dependensi, dan terintegrasi dengan mulus ke dalam aplikasi Go yang ada.

Instal go-message melalui Go Modules

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

Parsing Email Streaming

go-message menyediakan parser streaming yang memproses pesan email secara bertahap tanpa memuat seluruh konten ke memori. Ini sangat bermanfaat untuk menangani email besar atau pemrosesan surat dalam volume tinggi. Parser membaca header dan bagian tubuh secara berurutan, memungkinkan pengembang untuk memeriksa atau meneruskan pesan secara real time. Ia mendukung baik pesan yang sesuai RFC maupun yang tidak terformat dengan baik secara elegan, menjadikannya cocok untuk server surat produksi. Dengan memanfaatkan `io.Reader` milik Go, pustaka ini terintegrasi secara alami dengan operasi I/O jaringan dan file.

Bagaimana Cara Mengurai Pesan Email melalui API Streaming?

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
}

Penanganan MIME Multipart

go-message sepenuhnya mendukung parsing dan pembuatan pesan MIME multipart sebagaimana didefinisikan dalam RFC 2045 dan RFC 2046. Pengembang dapat menavigasi struktur multipart yang kompleks—termasuk bagian bersarang—menggunakan API yang intuitif. Pustaka secara otomatis mendekode transfer encoding (mis., base64, quoted-printable) dan menyediakan akses ke bagian individual melalui antarmuka `Part`. Hal ini memungkinkan komposisi email yang kuat serta ekstraksi lampiran, alternatif HTML/teks, dan sumber daya tersemat. Sifat streaming‑nya memastikan penanganan yang efisien bahkan untuk pesan multipart besar dengan banyak bagian.

Bagaimana Mengekstrak Bagian Multipart dari Email?

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
}

Dukungan Charset & Encoding

go-message mencakup penanganan charset dan encoding otomatis yang kuat untuk header email dan konten tubuh. Ini mendukung dekode header yang dienkode RFC 2047 (mis., `=?utf-8?B?...?=`) dan teks tubuh dalam berbagai charset (UTF-8, ISO-8859, dll.). Dengan mengimpor paket opsional `github.com/emersion/go-message/charset`, pengembang mendapatkan akses ke semua charset IANA yang terdaftar melalui `golang.org/x/text/encoding`. Ini memastikan rendering yang akurat dari konten email internasional, termasuk skrip non-Latin dan simbol khusus, tanpa deteksi atau konversi charset manual.

Bagaimana Mendekode Header yang Dikodekan dengan Charset?

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
}

Penandatanganan Pesan yang Ramah DKIM

go-message dirancang agar ramah DKIM, memungkinkan integrasi mulus dengan alur kerja penandatanganan dan verifikasi kriptografis. Parser streaming-nya mempertahankan integritas struktur pesan, memungkinkan penandatangan menandatangani hanya tubuh yang telah dikanonisasi dan header yang dipilih tanpa melakukan re-encoding. Perpustakaan ini menghindari transformasi yang tidak perlu (mis., normalisasi akhir baris) yang dapat merusak tanda tangan DKIM. Pengembang dapat membangun pipeline penandatanganan email dengan menggabungkan go-message bersama perpustakaan seperti `github.com/emersion/go-dkim`, memastikan kepatuhan terhadap RFC 6376 untuk otentikasi pesan berbasis domain.

Bagaimana Menyiapkan Pesan untuk Penandatanganan 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
}
 Indonesia