Rust邮件处理库email的使用指南

email是一个功能强大的Rust库，提供了SMTP客户端、IMAP客户端和邮件解析功能，可以帮助开发者轻松实现邮件相关功能。

主要功能

1. SMTP客户端功能
2. IMAP客户端功能
3. 邮件解析(MIME)功能
4. 邮件构建功能

安装

在Cargo.toml中添加依赖：

[dependencies]
email = "0.8.1"

基本使用方法

1. 邮件解析

use email::message::Message;

let raw_email = r#"From: sender@example.com
To: recipient@example.com
Subject: Test Email
Content-Type: text/plain; charset=utf-8

This is the email body."#;

let message = Message::parse(raw_email.as_bytes()).unwrap();

println!("From: {}", message.get_from().unwrap());
println!("To: {}", message.get_to().unwrap());
println!("Subject: {}", message.get_subject().unwrap());
println!("Body: {}", message.get_body().unwrap());

2. 构建邮件

use email::message::{Message, Mailbox};

let mut message = Message::new();
message.set_from(Mailbox::new("Sender Name", "sender@example.com"));
message.set_to(vec![Mailbox::new("Recipient Name", "recipient@example.com")]);
message.set_subject("Test Email");
message.set_body("This is the email body.");

let raw_email = message.to_string();
println!("{}", raw_email);

3. SMTP客户端发送邮件

use email::smtp::{SmtpClient, commands::*};
use std::net::TcpStream;

let mut stream = TcpStream::connect("smtp.example.com:25").unwrap();
let mut client = SmtpClient::new(stream);

// SMTP协议交互
client.command(Ehlo::new("localhost")).unwrap();
client.command(Mail::new("sender@example.com")).unwrap();
client.command(Rcpt::new("recipient@example.com")).unwrap();
client.command(Data).unwrap();

// 发送邮件内容
let message = "From: sender@example.com\r\n\
               To: recipient@example.com\r\n\
               Subject: Test\r\n\r\n\
               Hello from Rust!";
client.send_data(message.as_bytes()).unwrap();
client.command(Quit).unwrap();

4. IMAP客户端读取邮件

use email::imap::{ImapClient, commands::*};
use std::net::TcpStream;

let mut stream = TcpStream::connect("imap.example.com:143").unwrap();
let mut client = ImapClient::new(stream);

// IMAP协议交互
client.command(Login {
    username: "user@example.com",
    password: "password"
}).unwrap();

client.command(Select {
    mailbox: "INBOX"
}).unwrap();

// 获取前5封邮件的UID
let response = client.command(Fetch {
    sequence_set: "1:5",
    attributes: "UID"
}).unwrap();

println!("{}", response);

client.command(Logout).unwrap();

高级功能

处理MIME邮件

use email::message::{Message, MimePart};

let raw_email = r#"Content-Type: multipart/mixed; boundary="boundary"

--boundary
Content-Type: text/plain

This is the text part.

--boundary
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="example.txt"

File content here.
--boundary--"#;

let message = Message::parse(raw_email.as_bytes()).unwrap();

if let Some(parts) = message.get_parts() {
    for part in parts {
        println!("Content-Type: {}", part.get_content_type().unwrap());
        if part.is_text() {
            println!("Text content: {}", part.get_body().unwrap());
        } else if part.is_attachment() {
            println!("Attachment: {:?}", part.get_filename());
        }
    }
}

注意事项

1. 对于生产环境，建议使用TLS加密连接
2. 处理用户输入时要小心邮件头注入攻击
3. 大附件处理时要注意内存使用

email库提供了强大而灵活的邮件处理能力，可以满足大多数邮件相关的开发需求。

完整示例demo

下面是一个完整的SMTP发送邮件示例，包含TLS加密连接：

use email::smtp::{SmtpClient, commands::*};
use native_tls::TlsStream;
use std::net::TcpStream;

fn send_email() -> Result<(), Box<dyn std::error::Error>> {
    // 建立TCP连接
    let stream = TcpStream::connect("smtp.example.com:465")?;
    
    // 创建TLS连接
    let connector = native_tls::TlsConnector::new()?;
    let tls_stream = connector.connect("smtp.example.com", stream)?;
    
    // 创建SMTP客户端
    let mut client = SmtpClient::new(TlsStream::from(tls_stream));
    
    // SMTP协议交互
    client.command(Ehlo::new("localhost"))?;
    client.command(Mail::new("sender@example.com"))?;
    client.command(Rcpt::new("recipient@example.com"))?;
    client.command(Data)?;
    
    // 构建邮件内容
    let mut message = email::message::Message::new();
    message.set_from(email::message::Mailbox::new("Sender", "sender@example.com"));
    message.set_to(vec![email::message::Mailbox::new("Recipient", "recipient@example.com")]);
    message.set_subject("Test Email with TLS");
    message.set_body("This is a secure email sent from Rust!");
    
    // 发送邮件
    client.send_data(message.to_string().as_bytes())?;
    client.command(Quit)?;
    
    Ok(())
}

fn main() {
    if let Err(e) = send_email() {
        eprintln!("Failed to send email: {}", e);
    }
}

这个完整示例演示了：

1. 使用TLS加密的SMTP连接
2. 构建完整的邮件消息
3. 处理可能出现的错误
4. 完整的SMTP协议交互流程

对于IMAP和邮件解析的完整使用，可以参考上面提供的基础示例进行扩展。