English

MogiMail

テスト用の組み込み SMTP サーバです。

モックを使わずにメール通信に関するコードのテストを可能にします。

インストール

Cargo.toml に以下を追加します。

[dev-dependencies]
mogimail = "0.1.1"

使い方

ライブラリとして

use mogimail::SmtpServer;
use std::sync::mpsc;
use std::thread;
use std::time::Duration;

#[test]
fn test_email_sending() {
    // サーバを作成して起動。
    let (tx, rx) = mpsc::channel();
    let server = SmtpServer::new("test.local");

    thread::spawn(move || {
        server.start("127.0.0.1:2525", tx).expect("failed starting server");
    });

    // アプリコードを実行
    send_mail("127.0.0.1:2525", "test@example.com", "recipient@example.com", "Test Subject", "Test Body");

    // サーバ処理の完了を待機します
    let email = rx.recv_timeout(Duration::from_secs(1)).expect("timeout exceeded");

    // 送信済みメールの中身を確認
    assert_eq!(email.from, "test@example.com");
    assert_eq!(email.to, vec!["recipient@example.com"]);
    assert!(email.data.contains("Test Subject"));
}

スタンドアロンサーバとして

# デフォルト設定で起動 (localhost:2525)
cargo run

# アドレスとホスト名を指定して起動
cargo run -- 127.0.0.1:8025 myhost.local

スタンドアロンサーバは受信したメールを順番に標準出力に流してくれます。

サンプルコードの実行

cargo run --example basic_usage

テスト

Run the test suite:

cargo test

対応している SMTP コマンド

• HELO - 送信者を識別
• MAIL FROM - 送信者のアドレスを指定
• RCPT TO - 宛先を指定（複数可）
• DATA - 本文の送信
• RSET - 現行のトランザクションをリセット
• NOOP - 何もしない
• QUIT - 接続を終了

追加機能

ehlo 機能を有効にすると EHLO コマンドも利用できます。

注意事項

• RFC 821 で定義される「最小装備」のみ実装しています。
• インメモリのみで動作します。メールの永続化はできません。
• SMTP 認証は未対応。
• SSL/TLS 接続は未対応です。
• メールの転送は行いません。

利用規約

このライブラリは MIT ライセンスで提供されています。 詳細は LICENSE ファイルをご覧ください。