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
use serde::{Deserialize, Serialize};
/// Represents an email attachment.
#[derive(Debug, Default, Clone, Serialize, Deserialize)]
pub struct Attachment {
/// The Base64 encoded content of the attachment.
pub content: String,
/// The mime type of the attachment (e.g. "image/jpeg").
#[serde(rename = "type")]
pub mime_type: String,
/// The filename of the attachment.
pub filename: String,
/// The content-disposition of the attachment specifying how you would like the attachment to be displayed.
///
/// Supported values are "attachment" or "inline". Defaults to "attachment".
///
/// For example, "inline" results in the attached file being displayed automatically within the message,
/// while "attachment" results in the attached file requiring some action to be taken before it is displayed (e.g. opening or downloading the file).
#[serde(skip_serializing_if = "Option::is_none")]
pub disposition: Option<String>,
/// The attachment's unique content identifier.
///
/// This is used when the disposition is set to "inline" and the attachment is an image, allowing the file to be displayed within the body of your email.
///
/// ```html
/// <img src="cid:ii_139db99fdb5c3704"></img>
/// ```
#[serde(skip_serializing_if = "Option::is_none")]
pub content_id: Option<String>,
}
#[cfg(test)]
mod tests {
use super::*;
use serde_json::to_string;
#[test]
fn it_serializes_to_json() {
let json = to_string(&Attachment {
content: "aGVsbG8gd29ybGQ=".to_owned(),
mime_type: "text/plain".to_owned(),
filename: "foo.txt".to_owned(),
disposition: None,
content_id: None,
})
.unwrap();
assert_eq!(
json,
r#"{"content":"aGVsbG8gd29ybGQ=","type":"text/plain","filename":"foo.txt"}"#
);
let json = to_string(&Attachment {
content: "aGVsbG8gd29ybGQ=".to_owned(),
mime_type: "text/plain".to_owned(),
filename: "foo.txt".to_owned(),
disposition: Some("inline".to_owned()),
content_id: Some("123456".to_owned()),
})
.unwrap();
assert_eq!(
json,
r#"{"content":"aGVsbG8gd29ybGQ=","type":"text/plain","filename":"foo.txt","disposition":"inline","content_id":"123456"}"#
);
}
}