guerrillamail-client 0.4.0

Async Rust client for GuerrillaMail temporary email service
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

# guerrillamail-client


[![Crates.io](https://img.shields.io/crates/v/guerrillamail-client.svg)](https://crates.io/crates/guerrillamail-client)
[![Documentation](https://docs.rs/guerrillamail-client/badge.svg)](https://docs.rs/guerrillamail-client)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![GuerrillaMail](https://img.guerrillamail.com/4/6/f/46f9fd8911b3a915c1fec119e9062d00.png)

An async Rust client for the [GuerrillaMail](https://www.guerrillamail.com) temporary email service.

## Features


- 🚀 **Async/await** - Built on tokio and reqwest
- 📧 **Create temporary emails** - Generate disposable email addresses
- 📬 **Check inbox** - Retrieve messages from your temporary inbox
- 🗑️ **Delete emails** - Clean up when done
- 🌐 **Proxy support** - Route requests through HTTP proxies

## Installation


Add to your `Cargo.toml`:

```toml
[dependencies]
guerrillamail = "0.3.1"
tokio = { version = "1", features = ["full"] }
```

## Quick Start


```rust
use guerrillamail::Client;

#[tokio::main]

async fn main() -> Result<(), guerrillamail::Error> {
    // Create a new client
    let client = Client::new().await?;
    
    // Create a temporary email address
    let email = client.create_email("myalias").await?;
    println!("Temporary email: {}", email);
    
    // Check for messages
    let messages = client.get_messages(&email).await?;
    for msg in messages {
        println!("From: {}", msg.mail_from);
        println!("Subject: {}", msg.mail_subject);
    }
    
    // Delete when done
    client.delete_email(&email).await?;
    
    Ok(())
}
```

If you need custom configuration (proxy, TLS, user agent), use the builder:

```rust
use guerrillamail::Client;

let client = Client::builder()
    .proxy("http://127.0.0.1:8080")
    .danger_accept_invalid_certs(false)
    .user_agent("my-app/1.0")
    .ajax_url("https://www.guerrillamail.com/ajax.php")
    .build()
    .await?;
```

## Acknowledgements


This library is a Rust port of [GuerrillaMail-Python](https://github.com/rino-snow/GuerrillaMail-Python).

## License


MIT License - see [license](license) for details.