
go-message
メールとインターネットメッセージフォーマット向けのオープンソース Go ライブラリ
ストリーミング Go API を通じて RFC 5322、MIME、Content-Disposition ヘッダーを解析、生成、処理します。
go-message とは何ですか?
go-message は、高性能でストリーミング対応の Go ライブラリで、Internet Message Format (RFC 5322)、MIME 拡張 (RFC 2045–2047)、および Content-Disposition ヘッダー (RFC 2183) に準拠したメールメッセージの解析と生成を目的としています。メモリに全メッセージを読み込むことなくメールコンテンツを効率的に処理できるため、スケーラブルなメールサーバーやクライアントに最適です。このライブラリは自動文字セットデコードをサポートし、Go の標準ライブラリとシームレスに統合されます。
モジュラリティと拡張性を念頭に設計された go-message には、ハイレベルなメール処理のための `mail` や、低レベルのプロトコル解析のための `textproto` といった専用サブパッケージが含まれています。その DKIM フレンドリーな設計により、最新のメール認証ワークフローとの互換性が確保されています。組み込みのストリーミング機能と文字セット正規化により、go-message はマルチパートボディの解析、エンコードされたヘッダーのデコード、入れ子になった MIME 構造の処理など、複雑なメール処理タスクをシンプルにします――メモリ効率とパフォーマンスを維持しながら。
go-message の入門
go-message の使用を開始するには、公式の [go-message の GitHub](https://github.com/emersion/go-message) リポジトリから `go get` でインストールします。推奨される方法は Go モジュールを使用することです。プロジェクトディレクトリで `go get github.com/emersion/go-message` を実行してください。文字セットデコードのサポートが必要な場合は、`import _ "github.com/emersion/go-message/charset"` を追加してすべての標準エンコーディングを有効にします。このライブラリは軽量で依存関係がなく、既存の Go アプリケーションにスムーズに統合できます。
Go Modules を使用して go-message をインストール
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
ストリーミングメールパース
go-message は、メールメッセージをメモリ全体にロードせずにインクリメンタルに処理するストリーミングパーサーを提供します。これは、大容量のメールや大量のメール処理を扱う際に特に有益です。パーサーはヘッダーと本文パーツを順次読み取り、開発者がリアルタイムでメッセージを検査または転送できるようにします。RFC に準拠したメッセージと不正なメッセージの両方を適切にサポートし、実運用のメールサーバーに適しています。Go の `io.Reader` を活用することで、ライブラリはネットワークやファイル I/O 操作と自然に統合されます。
ストリーミング 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 マルチパートの処理
go-message は、RFC 2045 および RFC 2046 で定義された MIME マルチパートメッセージの解析と生成を完全にサポートします。開発者は直感的な API を使用して、ネストされたパーツを含む複雑なマルチパート構造をナビゲートできます。ライブラリは転送エンコーディング(例:base64、quoted-printable)を自動的にデコードし、`Part` インターフェースを介して個々のパーツへのアクセスを提供します。これにより、堅牢なメール作成や添付ファイル、HTML/テキストの代替、埋め込みリソースの抽出が可能になります。そのストリーミング特性により、多数のパーツを持つ大規模なマルチパートメッセージでも効率的に処理できます。
メールからマルチパートのパーツを抽出する方法は?
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` パッケージをインポートすることで、開発者は `golang.org/x/text/encoding` を介して登録されたすべての IANA 文字セットにアクセスできます。これにより、手動で文字セットを検出・変換することなく、ラテン文字以外のスクリプトや特殊記号を含む国際的なメールコンテンツを正確に表示できます。
文字セットでエンコードされたヘッダーをデコードする方法は?
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 署名を破壊する可能性のある不要な変換(例: 改行正規化)を回避します。開発者は `github.com/emersion/go-dkim` などのライブラリと go-message を組み合わせてメール署名パイプラインを構築でき、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
}
