br-email 1.2.17

This is an Email
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

# br-email
----

[![License](https://img.shields.io/crates/l/MIT)](LICENSE-MIT)
[![Crates.io Version](https://img.shields.io/crates/v/br-email)](https://crates.io/crates/br-email)

Rust email library supporting IMAP, POP3, and SMTP with TLS, incremental sync, connection reuse, and automatic retry.

## Features

- **IMAP** - Receive emails via IMAP/TLS (port 993), UID-based incremental sync
- **POP3** - Receive emails via POP3/TLS (port 995), UIDL-based incremental sync
- **SMTP** - Send emails via SMTP/STARTTLS (port 25/587), powered by `lettre`
- **Email Parsing** - MIME parsing, headers, attachments, encoded content
- **Connection Reuse** - Cached connections with automatic reconnect on failure
- **Retry** - Exponential backoff (3 retries, 2s/4s/8s delays)
- **Thread Pool** - Parallel operations via `pools` module

## Usage

### Receive (IMAP)

```rust
use br_email::{Mail, Receive};

let mut mail = Mail::new("imap", "imap.gmail.com", 993, "name", "user@gmail.com", "app_password");
let mut recv = mail.receive();

let total = recv.get_total()?;
let email_data = recv.get_mail(1)?;
```

### Receive (POP3)

```rust
use br_email::{Mail, Receive};

let mut mail = Mail::new("pop3", "pop.gmail.com", 995, "name", "user@gmail.com", "app_password");
let mut recv = mail.receive();

let total = recv.get_total()?;
let email_data = recv.get_mail(1)?;
```

### Send (SMTP)

```rust
use br_email::{Mail, Sender};

let mut mail = Mail::new("smtp", "smtp.gmail.com", 587, "name", "user@gmail.com", "app_password");
let mut sender = mail.sender();

sender.set_from("user@gmail.com");
sender.set_to("recipient@example.com");
sender.set_subject("Hello");
sender.set_body("<p>Hello World</p>");
sender.send()?;
```

### Incremental Sync (IMAP - UID)

```rust
let mut recv = mail.receive();
let validity = recv.get_validity()?;      // UIDVALIDITY - resync if changed
let max_uid = recv.get_max_uid()?;         // Highest UID
let new_uids = recv.get_new_since("100")?; // UIDs > 100
```

### Incremental Sync (POP3 - UIDL)

```rust
let mut recv = mail.receive();
let uidl_map = recv.get_uidl_map()?;  // Vec<(seq, uidl)>
// Compare with stored UIDLs to find new messages
```

### Parse Email

```rust
use br_email::Mail;

let data: Vec<u8> = /* raw email bytes */;
let parsed = Mail::analyze(data, false)?;
// Access: parsed.subject, parsed.from, parsed.body, parsed.attachments, etc.
```

### Config File

```rust
use br_email::{Config, Mail};

let config = Config::create("./br-email.toml")?;
let mut mail = Mail::new_new(config)?;
```

## Feature Flags

```toml
[dependencies]
br-email = "1.2"           # All features (imap + pop3 + smtp)
br-email = { version = "1.2", default-features = false, features = ["imap"] }  # IMAP only
```

| Feature | Default | Description |
|---------|---------|-------------|
| `imap` | Yes | IMAP receive support |
| `pop3` | Yes | POP3 receive support |
| `smtp` | Yes | SMTP send support (depends on `lettre`) |

## License

MIT