rust/lettre
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #239 from amousset/move-envelope-lettre

Browse Source 
feat(all): Move Envelope from lettre_email to lettre
This commit is contained in:
Alexis Mousset
2018-03-31 16:38:40 +02:00
committed by GitHub
parent bef45c48f7 f3f963c6a5
commit d283254b1a
34 changed files with 578 additions and 444 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/404.html
View File

@@ -9,14 +9,14 @@
<title>404 Page not found</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/horsey.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/horsey.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<style type="text/css">
:root #header + #content > #left > #rlblock_left {

48
docs/creating-messages/email/index.html
View File

@@ -12,17 +12,17 @@
<title>Email creation :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -669,20 +669,20 @@ as fallback for the HTML version.</p>
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

48
docs/creating-messages/index.html
View File

@@ -12,17 +12,17 @@
<title>Creating messages :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -608,20 +608,20 @@
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

48
docs/getting-started/index.html
View File

@@ -12,17 +12,17 @@
<title>Getting started :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -605,20 +605,20 @@
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

48
docs/getting-started/intro/index.html
View File

@@ -12,17 +12,17 @@
<title>Introduction :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -611,20 +611,20 @@ Please use <a href="https://docs.rs/lettre/0.6.2/lettre/">https://docs.rs/lettre
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

8
docs/index.json
View File

@@ -32,7 +32,7 @@
{
"uri": "/content/sending-messages/file",
"title": "File transport",
"content": "\nThe file transport writes the emails to the given directory. The name of the file will be\nmessage_id.txt.\nIt can be useful for testing purposes, or if you want to keep track of sent messages.\n\nextern crate lettre;\n\nuse std::env::temp_dir;\n\nuse lettre::file::FileEmailTransport;\nuse lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};\n\nfn main() {\n // Write to the local temp directory\n let mut sender = FileEmailTransport::new(temp_dir());\n let email = SimpleSendableEmail::new(\n EmailAddress::new(\"user@localhost\".to_string()),\n vec![EmailAddress::new(\"root@localhost\".to_string())],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n );\n \n let result = sender.send(&email);\n assert!(result.is_ok());\n}\n\nExample result in /tmp/b7c211bc-9811-45ce-8cd9-68eab575d695.txt:\n\nb7c211bc-9811-45ce-8cd9-68eab575d695: from=user@localhost to=root@localhost\nTo: root@localhost\nFrom: user@localhost\nSubject: Hello\nDate: Sat, 31 Oct 2015 13:42:19 +0100\nMessage-ID: b7c211bc-9811-45ce-8cd9-68eab575d695.lettre@localhost\n\nHello World!\n",
"content": "\nThe file transport writes the emails to the given directory. The name of the file will be\nmessage_id.txt.\nIt can be useful for testing purposes, or if you want to keep track of sent messages.\n\nextern crate lettre;\n\nuse std::env::temp_dir;\n\nuse lettre::file::FileEmailTransport;\nuse lettre::{SimpleSendableEmail, EmailTransport};\n\nfn main() {\n // Write to the local temp directory\n let mut sender = FileEmailTransport::new(temp_dir());\n let email = SimpleSendableEmail::new(\n \"user@localhost\".to_string(),\n &[\"root@localhost\".to_string()],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n ).unwrap();\n \n let result = sender.send(&email);\n assert!(result.is_ok());\n}\n\nExample result in /tmp/b7c211bc-9811-45ce-8cd9-68eab575d695.txt:\n\nb7c211bc-9811-45ce-8cd9-68eab575d695: from=user@localhost to=root@localhost\nTo: root@localhost\nFrom: user@localhost\nSubject: Hello\nDate: Sat, 31 Oct 2015 13:42:19 +0100\nMessage-ID: b7c211bc-9811-45ce-8cd9-68eab575d695.lettre@localhost\n\nHello World!\n",
"tags": []
},
{
@@ -44,19 +44,19 @@
{
"uri": "/content/sending-messages/sendmail",
"title": "Sendmail transport",
"content": "\nThe sendmail transport sends the email using the local sendmail command.\n\nextern crate lettre;\n\nuse lettre::sendmail::SendmailTransport;\nuse lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};\n\nfn main() {\n let email = SimpleSendableEmail::new(\n EmailAddress::new(\"user@localhost\".to_string()),\n vec![EmailAddress::new(\"root@localhost\".to_string())],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n );\n \n let mut sender = SendmailTransport::new();\n let result = sender.send(&email);\n assert!(result.is_ok());\n}\n",
"content": "\nThe sendmail transport sends the email using the local sendmail command.\n\nextern crate lettre;\n\nuse lettre::sendmail::SendmailTransport;\nuse lettre::{SimpleSendableEmail, EmailTransport};\n\nfn main() {\n let email = SimpleSendableEmail::new(\n \"user@localhost\".to_string(),\n &[\"root@localhost\".to_string()],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n ).unwrap();\n \n let mut sender = SendmailTransport::new();\n let result = sender.send(&email);\n assert!(result.is_ok());\n}\n",
"tags": []
},
{
"uri": "/content/sending-messages/smtp",
"title": "SMTP transport",
"content": "\nThis transport uses the SMTP protocol to send emails over the network (locally or remotely).\n\nIt is designed to be:\n\nSecured: email are encrypted by default\nModern: Unicode support for email content and sender/recipient addresses when compatible\nFast: supports tcp connection reuse\n\nThis client is designed to send emails to a relay server, and should not be used to send\nemails directly to the destination.\n\nThe relay server can be the local email server, a specific host or a third-party service.\n\nSimple example\n\nThis is the most basic example of usage:\n\nextern crate lettre;\n\nuse lettre::{SimpleSendableEmail, EmailTransport, EmailAddress, SmtpTransport};\n\nfn main() {\n let email = SimpleSendableEmail::new(\n EmailAddress::new(\"user@localhost\".to_string()),\n vec![EmailAddress::new(\"root@localhost\".to_string())],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n );\n \n // Open a local connection on port 25\n let mut mailer =\n SmtpTransport::builderunencryptedlocalhost().unwrap().build();\n // Send the email\n let result = mailer.send(&email);\n \n assert!(result.is_ok());\n}\n\n Complete example\n\nextern crate lettre;\n\nuse lettre::smtp::authentication::{Credentials, Mechanism};\nuse lettre::{SimpleSendableEmail, EmailTransport, EmailAddress, SmtpTransport};\nuse lettre::smtp::extension::ClientId;\nuse lettre::smtp::ConnectionReuseParameters;\n\nfn main() {\n let email = SimpleSendableEmail::new(\n EmailAddress::new(\"user@localhost\".to_string()),\n vec![EmailAddress::new(\"root@localhost\".to_string())],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n );\n \n // Connect to a remote server on a custom port\n let mut mailer = SmtpTransport::simple_builder(\"server.tld\").unwrap()\n // Set the name sent during EHLO/HELO, default is localhost\n .helloname(ClientId::Domain(\"my.hostname.tld\".tostring()))\n // Add credentials for authentication\n .credentials(Credentials::new(\"username\".tostring(), \"password\".tostring()))\n // Enable SMTPUTF8 if the server supports it\n .smtp_utf8(true)\n // Configure expected authentication mechanism\n .authentication_mechanism(Mechanism::Plain)\n // Enable connection reuse\n .connection_reuse(ConnectionReuseParameters::ReuseUnlimited).build();\n \n let result_1 = mailer.send(&email);\n assert!(result1.isok());\n \n // The second email will use the same connection\n let result_2 = mailer.send(&email);\n assert!(result2.isok());\n \n // Explicitly close the SMTP transaction as we enabled connection reuse\n mailer.close();\n}\n\nLower level\n\nYou can also send commands, here is a simple email transaction without\nerror handling:\n\nextern crate lettre;\n\nuse lettre::EmailAddress;\nuse lettre::smtp::SMTP_PORT;\nuse lettre::smtp::client::Client;\nuse lettre::smtp::client::net::NetworkStream;\nuse lettre::smtp::extension::ClientId;\nuse lettre::smtp::commands::*;\n\nfn main() {\n let mut email_client: ClientNetworkStream = Client::new();\n let _ = emailclient.connect(&(\"localhost\", SMTPPORT), None);\n let _ = emailclient.command(EhloCommand::new(ClientId::new(\"myhostname\".to_string())));\n let _ = email_client.command(\n MailCommand::new(Some(EmailAddress::new(\"user@example.com\".to_string())), vec![])\n );\n let _ = email_client.command(\n RcptCommand::new(EmailAddress::new(\"user@example.org\".to_string()), vec![])\n );\n let _ = email_client.command(DataCommand);\n let _ = emailclient.message(Box::new(\"Test email\".asbytes()));\n let _ = email_client.command(QuitCommand);\n}\n\n",
"content": "\nThis transport uses the SMTP protocol to send emails over the network (locally or remotely).\n\nIt is designed to be:\n\nSecured: email are encrypted by default\nModern: Unicode support for email content and sender/recipient addresses when compatible\nFast: supports tcp connection reuse\n\nThis client is designed to send emails to a relay server, and should not be used to send\nemails directly to the destination.\n\nThe relay server can be the local email server, a specific host or a third-party service.\n\nSimple example\n\nThis is the most basic example of usage:\n\nextern crate lettre;\n\nuse lettre::{SimpleSendableEmail, EmailTransport, SmtpTransport};\n\nfn main() {\n let email = SimpleSendableEmail::new(\n \"user@localhost\".to_string(),\n &[\"root@localhost\".to_string()],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n ).unwrap();\n \n // Open a local connection on port 25\n let mut mailer =\n SmtpTransport::builderunencryptedlocalhost().unwrap().build();\n // Send the email\n let result = mailer.send(&email);\n \n assert!(result.is_ok());\n}\n\n Complete example\n\nextern crate lettre;\n\nuse lettre::smtp::authentication::{Credentials, Mechanism};\nuse lettre::{SimpleSendableEmail, EmailTransport, SmtpTransport};\nuse lettre::smtp::extension::ClientId;\nuse lettre::smtp::ConnectionReuseParameters;\n\nfn main() {\n let email = SimpleSendableEmail::new(\n \"user@localhost\".to_string(),\n &[\"root@localhost\".to_string()],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n ).unwrap();\n \n // Connect to a remote server on a custom port\n let mut mailer = SmtpTransport::simple_builder(\"server.tld\").unwrap()\n // Set the name sent during EHLO/HELO, default is localhost\n .helloname(ClientId::Domain(\"my.hostname.tld\".tostring()))\n // Add credentials for authentication\n .credentials(Credentials::new(\"username\".tostring(), \"password\".tostring()))\n // Enable SMTPUTF8 if the server supports it\n .smtp_utf8(true)\n // Configure expected authentication mechanism\n .authentication_mechanism(Mechanism::Plain)\n // Enable connection reuse\n .connection_reuse(ConnectionReuseParameters::ReuseUnlimited).build();\n \n let result_1 = mailer.send(&email);\n assert!(result1.isok());\n \n // The second email will use the same connection\n let result_2 = mailer.send(&email);\n assert!(result2.isok());\n \n // Explicitly close the SMTP transaction as we enabled connection reuse\n mailer.close();\n}\n\nLower level\n\nYou can also send commands, here is a simple email transaction without\nerror handling:\n\nextern crate lettre;\n\nuse lettre::EmailAddress;\nuse lettre::smtp::SMTP_PORT;\nuse lettre::smtp::client::Client;\nuse lettre::smtp::client::net::NetworkStream;\nuse lettre::smtp::extension::ClientId;\nuse lettre::smtp::commands::*;\n\nfn main() {\n let mut email_client: ClientNetworkStream = Client::new();\n let _ = emailclient.connect(&(\"localhost\", SMTPPORT), None);\n let _ = emailclient.command(EhloCommand::new(ClientId::new(\"myhostname\".to_string())));\n let _ = email_client.command(\n MailCommand::new(Some(EmailAddress::new(\"user@example.com\".to_string()).unwrap()), vec![])\n );\n let _ = email_client.command(\n RcptCommand::new(EmailAddress::new(\"user@example.org\".to_string()).unwrap(), vec![])\n );\n let _ = email_client.command(DataCommand);\n let _ = emailclient.message(Box::new(\"Test email\".asbytes()));\n let _ = email_client.command(QuitCommand);\n}\n\n",
"tags": []
},
{
"uri": "/content/sending-messages/stub",
"title": "Stub transport",
"content": "\nThe stub transport only logs message envelope and drops the content. It can be useful for\ntesting purposes.\n\nextern crate lettre;\n\nuse lettre::stub::StubEmailTransport;\nuse lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};\n\nfn main() {\n let email = SimpleSendableEmail::new(\n EmailAddress::new(\"user@localhost\".to_string()),\n vec![EmailAddress::new(\"root@localhost\".to_string())],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n );\n \n let mut sender = StubEmailTransport::new_positive();\n let result = sender.send(&email);\n assert!(result.is_ok());\n}\n\nWill log (when using a logger like env_logger):\n\nb7c211bc-9811-45ce-8cd9-68eab575d695: from=user@localhost to=root@localhost\n",
"content": "\nThe stub transport only logs message envelope and drops the content. It can be useful for\ntesting purposes.\n\nextern crate lettre;\n\nuse lettre::stub::StubEmailTransport;\nuse lettre::{SimpleSendableEmail, EmailTransport};\n\nfn main() {\n let email = SimpleSendableEmail::new(\n \"user@localhost\".to_string(),\n &[\"root@localhost\".to_string()],\n \"messageid\".tostring(),\n \"Hello world\".to_string(),\n ).unwrap();\n \n let mut sender = StubEmailTransport::new_positive();\n let result = sender.send(&email);\n assert!(result.is_ok());\n}\n\nWill log (when using a logger like env_logger):\n\nb7c211bc-9811-45ce-8cd9-68eab575d695: from=user@localhost to=root@localhost\n",
"tags": []
}
]

6
docs/index.xml
View File

@@ -52,7 +52,7 @@ The relay server can be the local email server, a specific host or a third-party
<guid>https://lettre.github.io/lettre/sending-messages/sendmail/</guid>
<description>The sendmail transport sends the email using the local sendmail command.
extern crate lettre; use lettre::sendmail::SendmailTransport; use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress}; fn main() { let email = SimpleSendableEmail::new( EmailAddress::new(&amp;#34;user@localhost&amp;#34;.to_string()), vec![EmailAddress::new(&amp;#34;root@localhost&amp;#34;.to_string())], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ); let mut sender = SendmailTransport::new(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); }</description>
extern crate lettre; use lettre::sendmail::SendmailTransport; use lettre::{SimpleSendableEmail, EmailTransport}; fn main() { let email = SimpleSendableEmail::new( &amp;#34;user@localhost&amp;#34;.to_string(), &amp;amp;[&amp;#34;root@localhost&amp;#34;.to_string()], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ).unwrap(); let mut sender = SendmailTransport::new(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); }</description>
</item>
<item>
@@ -72,7 +72,7 @@ extern crate lettre_email; use lettre_email::EmailBuilder; fn main() { // Create
<guid>https://lettre.github.io/lettre/sending-messages/file/</guid>
<description>The file transport writes the emails to the given directory. The name of the file will be message_id.txt. It can be useful for testing purposes, or if you want to keep track of sent messages.
extern crate lettre; use std::env::temp_dir; use lettre::file::FileEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress}; fn main() { // Write to the local temp directory let mut sender = FileEmailTransport::new(temp_dir()); let email = SimpleSendableEmail::new( EmailAddress::new(&amp;#34;user@localhost&amp;#34;.to_string()), vec![EmailAddress::new(&amp;#34;root@localhost&amp;#34;.to_string())], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.</description>
extern crate lettre; use std::env::temp_dir; use lettre::file::FileEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport}; fn main() { // Write to the local temp directory let mut sender = FileEmailTransport::new(temp_dir()); let email = SimpleSendableEmail::new( &amp;#34;user@localhost&amp;#34;.to_string(), &amp;amp;[&amp;#34;root@localhost&amp;#34;.to_string()], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ).</description>
</item>
<item>
@@ -82,7 +82,7 @@ extern crate lettre; use std::env::temp_dir; use lettre::file::FileEmailTranspor
<guid>https://lettre.github.io/lettre/sending-messages/stub/</guid>
<description>The stub transport only logs message envelope and drops the content. It can be useful for testing purposes.
extern crate lettre; use lettre::stub::StubEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress}; fn main() { let email = SimpleSendableEmail::new( EmailAddress::new(&amp;#34;user@localhost&amp;#34;.to_string()), vec![EmailAddress::new(&amp;#34;root@localhost&amp;#34;.to_string())], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ); let mut sender = StubEmailTransport::new_positive(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); } Will log (when using a logger like env_logger):
extern crate lettre; use lettre::stub::StubEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport}; fn main() { let email = SimpleSendableEmail::new( &amp;#34;user@localhost&amp;#34;.to_string(), &amp;amp;[&amp;#34;root@localhost&amp;#34;.to_string()], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ).unwrap(); let mut sender = StubEmailTransport::new_positive(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); } Will log (when using a logger like env_logger):
b7c211bc-9811-45ce-8cd9-68eab575d695: from=&amp;lt;user@localhost&amp;gt; to=&amp;lt;root@localhost&amp;gt;</description>
</item>

56
docs/sending-messages/file/index.html
View File

@@ -12,17 +12,17 @@
<title>File transport :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -391,17 +391,17 @@ It can be useful for testing purposes, or if you want to keep track of sent mess
<span style="color:#66d9ef">use</span> std::env::temp_dir;
<span style="color:#66d9ef">use</span> lettre::file::FileEmailTransport;
<span style="color:#66d9ef">use</span> lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};
<span style="color:#66d9ef">use</span> lettre::{SimpleSendableEmail, EmailTransport};
<span style="color:#66d9ef">fn</span> <span style="color:#a6e22e">main</span>() {
<span style="color:#75715e">// Write to the local temp directory
</span><span style="color:#75715e"></span> <span style="color:#66d9ef">let</span> <span style="color:#66d9ef">mut</span> sender <span style="color:#f92672">=</span> FileEmailTransport::new(temp_dir());
<span style="color:#66d9ef">let</span> email <span style="color:#f92672">=</span> SimpleSendableEmail::new(
EmailAddress::new(<span style="color:#e6db74">&#34;user@localhost&#34;</span>.to_string()),
vec<span style="color:#f92672">!</span>[EmailAddress::new(<span style="color:#e6db74">&#34;root@localhost&#34;</span>.to_string())],
<span style="color:#e6db74">&#34;user@localhost&#34;</span>.to_string(),
<span style="color:#f92672">&amp;</span>[<span style="color:#e6db74">&#34;root@localhost&#34;</span>.to_string()],
<span style="color:#e6db74">&#34;message_id&#34;</span>.to_string(),
<span style="color:#e6db74">&#34;Hello world&#34;</span>.to_string(),
);
).unwrap();
<span style="color:#66d9ef">let</span> result <span style="color:#f92672">=</span> sender.send(<span style="color:#f92672">&amp;</span>email);
assert<span style="color:#f92672">!</span>(result.is_ok());
@@ -635,20 +635,20 @@ Hello World!</code></pre></div>
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

48
docs/sending-messages/index.html
View File

@@ -12,17 +12,17 @@
<title>Sending messages :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -608,20 +608,20 @@
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

6
docs/sending-messages/index.xml
View File

@@ -41,7 +41,7 @@ The relay server can be the local email server, a specific host or a third-party
<guid>https://lettre.github.io/lettre/sending-messages/sendmail/</guid>
<description>The sendmail transport sends the email using the local sendmail command.
extern crate lettre; use lettre::sendmail::SendmailTransport; use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress}; fn main() { let email = SimpleSendableEmail::new( EmailAddress::new(&amp;#34;user@localhost&amp;#34;.to_string()), vec![EmailAddress::new(&amp;#34;root@localhost&amp;#34;.to_string())], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ); let mut sender = SendmailTransport::new(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); }</description>
extern crate lettre; use lettre::sendmail::SendmailTransport; use lettre::{SimpleSendableEmail, EmailTransport}; fn main() { let email = SimpleSendableEmail::new( &amp;#34;user@localhost&amp;#34;.to_string(), &amp;amp;[&amp;#34;root@localhost&amp;#34;.to_string()], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ).unwrap(); let mut sender = SendmailTransport::new(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); }</description>
</item>
<item>
@@ -51,7 +51,7 @@ extern crate lettre; use lettre::sendmail::SendmailTransport; use lettre::{Simpl
<guid>https://lettre.github.io/lettre/sending-messages/file/</guid>
<description>The file transport writes the emails to the given directory. The name of the file will be message_id.txt. It can be useful for testing purposes, or if you want to keep track of sent messages.
extern crate lettre; use std::env::temp_dir; use lettre::file::FileEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress}; fn main() { // Write to the local temp directory let mut sender = FileEmailTransport::new(temp_dir()); let email = SimpleSendableEmail::new( EmailAddress::new(&amp;#34;user@localhost&amp;#34;.to_string()), vec![EmailAddress::new(&amp;#34;root@localhost&amp;#34;.to_string())], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.</description>
extern crate lettre; use std::env::temp_dir; use lettre::file::FileEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport}; fn main() { // Write to the local temp directory let mut sender = FileEmailTransport::new(temp_dir()); let email = SimpleSendableEmail::new( &amp;#34;user@localhost&amp;#34;.to_string(), &amp;amp;[&amp;#34;root@localhost&amp;#34;.to_string()], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ).</description>
</item>
<item>
@@ -61,7 +61,7 @@ extern crate lettre; use std::env::temp_dir; use lettre::file::FileEmailTranspor
<guid>https://lettre.github.io/lettre/sending-messages/stub/</guid>
<description>The stub transport only logs message envelope and drops the content. It can be useful for testing purposes.
extern crate lettre; use lettre::stub::StubEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress}; fn main() { let email = SimpleSendableEmail::new( EmailAddress::new(&amp;#34;user@localhost&amp;#34;.to_string()), vec![EmailAddress::new(&amp;#34;root@localhost&amp;#34;.to_string())], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ); let mut sender = StubEmailTransport::new_positive(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); } Will log (when using a logger like env_logger):
extern crate lettre; use lettre::stub::StubEmailTransport; use lettre::{SimpleSendableEmail, EmailTransport}; fn main() { let email = SimpleSendableEmail::new( &amp;#34;user@localhost&amp;#34;.to_string(), &amp;amp;[&amp;#34;root@localhost&amp;#34;.to_string()], &amp;#34;message_id&amp;#34;.to_string(), &amp;#34;Hello world&amp;#34;.to_string(), ).unwrap(); let mut sender = StubEmailTransport::new_positive(); let result = sender.send(&amp;amp;email); assert!(result.is_ok()); } Will log (when using a logger like env_logger):
b7c211bc-9811-45ce-8cd9-68eab575d695: from=&amp;lt;user@localhost&amp;gt; to=&amp;lt;root@localhost&amp;gt;</description>
</item>

48
docs/sending-messages/intro/index.html
View File

@@ -12,17 +12,17 @@
<title>Introduction :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -616,20 +616,20 @@ logs.</li>
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

56
docs/sending-messages/sendmail/index.html
View File

@@ -12,17 +12,17 @@
<title>Sendmail transport :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -387,15 +387,15 @@
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-rust,no_run" data-lang="rust,no_run">extern crate lettre;
use lettre::sendmail::SendmailTransport;
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};
use lettre::{SimpleSendableEmail, EmailTransport};
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new(&#34;user@localhost&#34;.to_string()),
vec![EmailAddress::new(&#34;root@localhost&#34;.to_string())],
&#34;user@localhost&#34;.to_string(),
&amp;[&#34;root@localhost&#34;.to_string()],
&#34;message_id&#34;.to_string(),
&#34;Hello world&#34;.to_string(),
);
).unwrap();
let mut sender = SendmailTransport::new();
let result = sender.send(&amp;email);
@@ -621,20 +621,20 @@ fn main() {
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

68
docs/sending-messages/smtp/index.html
View File

@@ -12,17 +12,17 @@
<title>SMTP transport :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -420,15 +420,15 @@ emails directly to the destination.</p>
<p>This is the most basic example of usage:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-rust,no_run" data-lang="rust,no_run">extern crate lettre;
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress, SmtpTransport};
use lettre::{SimpleSendableEmail, EmailTransport, SmtpTransport};
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new(&#34;user@localhost&#34;.to_string()),
vec![EmailAddress::new(&#34;root@localhost&#34;.to_string())],
&#34;user@localhost&#34;.to_string(),
&amp;[&#34;root@localhost&#34;.to_string()],
&#34;message_id&#34;.to_string(),
&#34;Hello world&#34;.to_string(),
);
).unwrap();
// Open a local connection on port 25
let mut mailer =
@@ -442,17 +442,17 @@ fn main() {
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-rust,no_run" data-lang="rust,no_run">extern crate lettre;
use lettre::smtp::authentication::{Credentials, Mechanism};
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress, SmtpTransport};
use lettre::{SimpleSendableEmail, EmailTransport, SmtpTransport};
use lettre::smtp::extension::ClientId;
use lettre::smtp::ConnectionReuseParameters;
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new(&#34;user@localhost&#34;.to_string()),
vec![EmailAddress::new(&#34;root@localhost&#34;.to_string())],
&#34;user@localhost&#34;.to_string(),
&amp;[&#34;root@localhost&#34;.to_string()],
&#34;message_id&#34;.to_string(),
&#34;Hello world&#34;.to_string(),
);
).unwrap();
// Connect to a remote server on a custom port
let mut mailer = SmtpTransport::simple_builder(&#34;server.tld&#34;).unwrap()
@@ -495,10 +495,10 @@ fn main() {
let _ = email_client.connect(&amp;(&#34;localhost&#34;, SMTP_PORT), None);
let _ = email_client.command(EhloCommand::new(ClientId::new(&#34;my_hostname&#34;.to_string())));
let _ = email_client.command(
MailCommand::new(Some(EmailAddress::new(&#34;user@example.com&#34;.to_string())), vec![])
MailCommand::new(Some(EmailAddress::new(&#34;user@example.com&#34;.to_string()).unwrap()), vec![])
);
let _ = email_client.command(
RcptCommand::new(EmailAddress::new(&#34;user@example.org&#34;.to_string()), vec![])
RcptCommand::new(EmailAddress::new(&#34;user@example.org&#34;.to_string()).unwrap(), vec![])
);
let _ = email_client.command(DataCommand);
let _ = email_client.message(Box::new(&#34;Test email&#34;.as_bytes()));
@@ -724,20 +724,20 @@ fn main() {
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

56
docs/sending-messages/stub/index.html
View File

@@ -12,17 +12,17 @@
<title>Stub transport :: Lettre site</title>
<link href="/lettre/css/nucleus.css?1517057321" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1517057321" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1517057321" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1517057321" rel="stylesheet">
<link href="/lettre/css/theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1517057321" rel="stylesheet">
<link href="/lettre/css/nucleus.css?1522506318" rel="stylesheet">
<link href="/lettre/css/font-awesome.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hybrid.css?1522506318" rel="stylesheet">
<link href="/lettre/css/featherlight.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/perfect-scrollbar.min.css?1522506318" rel="stylesheet">
<link href="/lettre/css/auto-complete.css?1522506318" rel="stylesheet">
<link href="/lettre/css/theme.css?1522506318" rel="stylesheet">
<link href="/lettre/css/hugo-theme.css?1522506318" rel="stylesheet">
<script src="/lettre/js/jquery-2.x.min.js?1517057321"></script>
<script src="/lettre/js/jquery-2.x.min.js?1522506318"></script>
<style type="text/css">
:root #header + #content > #left > #rlblock_left{
@@ -49,14 +49,14 @@
<span data-search-clear=""><i class="fa fa-close"></i></span>
</div>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/lunr.min.js?1522506318"></script>
<script type="text/javascript" src="/lettre/js/auto-complete.js?1522506318"></script>
<script type="text/javascript">
var baseurl = "https:\/\/lettre.github.io\/lettre";
</script>
<script type="text/javascript" src="/lettre/js/search.js?1517057321"></script>
<script type="text/javascript" src="/lettre/js/search.js?1522506318"></script>
</div>
@@ -388,15 +388,15 @@ testing purposes.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-rust" data-lang="rust"><span style="color:#66d9ef">extern</span> <span style="color:#66d9ef">crate</span> lettre;
<span style="color:#66d9ef">use</span> lettre::stub::StubEmailTransport;
<span style="color:#66d9ef">use</span> lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};
<span style="color:#66d9ef">use</span> lettre::{SimpleSendableEmail, EmailTransport};
<span style="color:#66d9ef">fn</span> <span style="color:#a6e22e">main</span>() {
<span style="color:#66d9ef">let</span> email <span style="color:#f92672">=</span> SimpleSendableEmail::new(
EmailAddress::new(<span style="color:#e6db74">&#34;user@localhost&#34;</span>.to_string()),
vec<span style="color:#f92672">!</span>[EmailAddress::new(<span style="color:#e6db74">&#34;root@localhost&#34;</span>.to_string())],
<span style="color:#e6db74">&#34;user@localhost&#34;</span>.to_string(),
<span style="color:#f92672">&amp;</span>[<span style="color:#e6db74">&#34;root@localhost&#34;</span>.to_string()],
<span style="color:#e6db74">&#34;message_id&#34;</span>.to_string(),
<span style="color:#e6db74">&#34;Hello world&#34;</span>.to_string(),
);
).unwrap();
<span style="color:#66d9ef">let</span> <span style="color:#66d9ef">mut</span> sender <span style="color:#f92672">=</span> StubEmailTransport::new_positive();
<span style="color:#66d9ef">let</span> result <span style="color:#f92672">=</span> sender.send(<span style="color:#f92672">&amp;</span>email);
@@ -621,20 +621,20 @@ testing purposes.</p>
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/lettre/js/clipboard.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1517057321"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1517057321"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1517057321"></script>
<script src="/lettre/js/featherlight.min.js?1517057321"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1517057321"></script>
<script src="/lettre/js/highlight.pack.js?1517057321"></script>
<script src="/lettre/js/clipboard.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.min.js?1522506318"></script>
<script src="/lettre/js/perfect-scrollbar.jquery.min.js?1522506318"></script>
<script src="/lettre/js/jquery.sticky-kit.min.js?1522506318"></script>
<script src="/lettre/js/featherlight.min.js?1522506318"></script>
<script src="/lettre/js/html5shiv-printshiv.min.js?1522506318"></script>
<script src="/lettre/js/highlight.pack.js?1522506318"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/lettre/js/modernizr.custom.71422.js?1517057321"></script>
<script src="/lettre/js/learn.js?1517057321"></script>
<script src="/lettre/js/hugo-learn.js?1517057321"></script>
<script src="/lettre/js/modernizr.custom.71422.js?1522506318"></script>
<script src="/lettre/js/learn.js?1522506318"></script>
<script src="/lettre/js/hugo-learn.js?1522506318"></script>
<link href="/lettre/mermaid/mermaid.css?1517057321" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1517057321"></script>
<link href="/lettre/mermaid/mermaid.css?1522506318" type="text/css" rel="stylesheet" />
<script src="/lettre/mermaid/mermaid.js?1522506318"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>

4
lettre/CHANGELOG.md
View File

@@ -11,6 +11,10 @@
* Detail in SMTP Response is now an enum
* Use nom for parsing smtp responses
* `Envelope` was moved from `lettre_email` to `lettre`
* `EmailAddress::new()` now returns a `Result`
* `SendableEmail` replaces `from` and `to` by `envelope` that returns an `Envelope`
* `File` transport storage format has changed
#### Removed

10
lettre/examples/smtp.rs
View File

@@ -1,17 +1,17 @@
extern crate env_logger;
extern crate lettre;
use lettre::{EmailAddress, EmailTransport, SimpleSendableEmail, SmtpTransport};
use lettre::{EmailTransport, SimpleSendableEmail, SmtpTransport};
fn main() {
env_logger::init();
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"file_id".to_string(),
"user@localhost".to_string(),
&["root@localhost".to_string()],
"my-message-id".to_string(),
"Hello ß☺ example".to_string(),
);
).unwrap();
// Open a local connection on port 25
let mut mailer = SmtpTransport::builder_unencrypted_localhost()

7
lettre/src/file/mod.rs
View File

@@ -40,10 +40,9 @@ impl<'a, T: Read + 'a> EmailTransport<'a, T, FileResult> for FileEmailTransport
let mut message_content = String::new();
let _ = email.message().read_to_string(&mut message_content);
let simple_email = SimpleSendableEmail::new(
email.from().clone(),
email.to().clone(),
email.message_id().clone(),
let simple_email = SimpleSendableEmail::new_with_envelope(
email.envelope().clone(),
email.message_id().to_string(),
message_content,
);

187
lettre/src/lib.rs
View File

@@ -48,11 +48,63 @@ pub use smtp::{ClientSecurity, SmtpTransport};
pub use smtp::client::net::ClientTlsParameters;
use std::fmt::{self, Display, Formatter};
use std::io::Read;
use std::error::Error as StdError;
use std::str::FromStr;
/// Error type for email content
#[derive(Debug)]
pub enum Error {
/// Missing from in envelope
MissingFrom,
/// Missing to in envelope
MissingTo,
/// Invalid email
InvalidEmailAddress,
}
impl StdError for Error {
fn description(&self) -> &str {
match *self {
Error::MissingFrom => "missing source address, invalid envelope",
Error::MissingTo => "missing destination address, invalid envelope",
Error::InvalidEmailAddress => "invalid email address",
}
}
fn cause(&self) -> Option<&StdError> {
None
}
}
impl Display for Error {
fn fmt(&self, fmt: &mut Formatter) -> Result<(), fmt::Error> {
fmt.write_str(self.description())
}
}
/// Email result type
pub type EmailResult<T> = Result<T, Error>;
/// Email address
#[derive(PartialEq, Eq, Clone, Debug)]
#[cfg_attr(feature = "serde-impls", derive(Serialize, Deserialize))]
pub struct EmailAddress(pub String);
pub struct EmailAddress(String);
impl EmailAddress {
/// Creates a new `EmailAddress`. For now it makes no validation.
pub fn new(address: String) -> EmailResult<EmailAddress> {
// TODO make some basic sanity checks
Ok(EmailAddress(address))
}
}
impl FromStr for EmailAddress {
type Err = Error;
fn from_str(s: &str) -> Result<Self, Self::Err> {
EmailAddress::new(s.to_string())
}
}
impl Display for EmailAddress {
fn fmt(&self, f: &mut Formatter) -> fmt::Result {
@@ -60,19 +112,98 @@ impl Display for EmailAddress {
}
}
impl EmailAddress {
/// Creates a new email address
pub fn new(address: String) -> EmailAddress {
EmailAddress(address)
/// Simple email envelope representation
///
/// We only accept mailboxes, and do not support source routes (as per RFC).
#[derive(PartialEq, Eq, Clone, Debug)]
#[cfg_attr(feature = "serde-impls", derive(Serialize, Deserialize))]
pub struct Envelope {
/// The envelope recipients' addresses
///
/// This can not be empty.
forward_path: Vec<EmailAddress>,
/// The envelope sender address
reverse_path: Option<EmailAddress>,
}
impl Envelope {
/// Creates a new envelope, which may fail if `to` is empty.
pub fn new(from: Option<EmailAddress>, to: Vec<EmailAddress>) -> EmailResult<Envelope> {
if to.is_empty() {
return Err(Error::MissingTo);
}
Ok(Envelope {
forward_path: to,
reverse_path: from,
})
}
/// Destination addresses of the envelope
pub fn to(&self) -> &[EmailAddress] {
self.forward_path.as_slice()
}
/// Source address of the envelope
pub fn from(&self) -> Option<&EmailAddress> {
self.reverse_path.as_ref()
}
/// Creates a new builder
pub fn builder() -> EnvelopeBuilder {
EnvelopeBuilder::new()
}
}
/// Simple email envelope representation
#[derive(PartialEq, Eq, Clone, Debug, Default)]
pub struct EnvelopeBuilder {
/// The envelope recipients' addresses
to: Vec<EmailAddress>,
/// The envelope sender address
from: Option<EmailAddress>,
}
impl EnvelopeBuilder {
/// Constructs an envelope with no recipients and an empty sender
pub fn new() -> Self {
EnvelopeBuilder {
to: vec![],
from: None,
}
}
/// Adds a recipient
pub fn to<S: Into<EmailAddress>>(mut self, address: S) -> Self {
self.add_to(address);
self
}
/// Adds a recipient
pub fn add_to<S: Into<EmailAddress>>(&mut self, address: S) {
self.to.push(address.into());
}
/// Sets the sender
pub fn from<S: Into<EmailAddress>>(mut self, address: S) -> Self {
self.set_from(address);
self
}
/// Sets the sender
pub fn set_from<S: Into<EmailAddress>>(&mut self, address: S) {
self.from = Some(address.into());
}
/// Build the envelope
pub fn build(self) -> EmailResult<Envelope> {
Envelope::new(self.from, self.to)
}
}
/// Email sendable by an SMTP client
pub trait SendableEmail<'a, T: Read + 'a> {
/// To
fn to(&self) -> Vec<EmailAddress>;
/// From
fn from(&self) -> EmailAddress;
/// Envelope
fn envelope(&self) -> Envelope;
/// Message ID, used for logging
fn message_id(&self) -> String;
/// Message content
@@ -89,10 +220,8 @@ pub trait EmailTransport<'a, U: Read + 'a, V> {
#[derive(Debug, Clone)]
#[cfg_attr(feature = "serde-impls", derive(Serialize, Deserialize))]
pub struct SimpleSendableEmail {
/// To
to: Vec<EmailAddress>,
/// From
from: EmailAddress,
/// Envelope
envelope: Envelope,
/// Message ID
message_id: String,
/// Message content
@@ -102,14 +231,30 @@ pub struct SimpleSendableEmail {
impl SimpleSendableEmail {
/// Returns a new email
pub fn new(
from_address: EmailAddress,
to_addresses: Vec<EmailAddress>,
from_address: String,
to_addresses: &[String],
message_id: String,
message: String,
) -> EmailResult<SimpleSendableEmail> {
let to: Result<Vec<EmailAddress>, Error> = to_addresses
.iter()
.map(|x| EmailAddress::new(x.clone()))
.collect();
Ok(SimpleSendableEmail::new_with_envelope(
Envelope::new(Some(EmailAddress::new(from_address)?), to?)?,
message_id,
message,
))
}
/// Returns a new email from a valid envelope
pub fn new_with_envelope(
envelope: Envelope,
message_id: String,
message: String,
) -> SimpleSendableEmail {
SimpleSendableEmail {
from: from_address,
to: to_addresses,
envelope,
message_id,
message: message.into_bytes(),
}
@@ -117,12 +262,8 @@ impl SimpleSendableEmail {
}
impl<'a> SendableEmail<'a, &'a [u8]> for SimpleSendableEmail {
fn to(&self) -> Vec<EmailAddress> {
self.to.clone()
}
fn from(&self) -> EmailAddress {
self.from.clone()
fn envelope(&self) -> Envelope {
self.envelope.clone()
}
fn message_id(&self) -> String {

9
lettre/src/sendmail/mod.rs
View File

@@ -33,13 +33,18 @@ impl SendmailTransport {
impl<'a, T: Read + 'a> EmailTransport<'a, T, SendmailResult> for SendmailTransport {
fn send<U: SendableEmail<'a, T> + 'a>(&mut self, email: &'a U) -> SendmailResult {
let envelope = email.envelope();
// Spawn the sendmail command
let to_addresses: Vec<String> = email.to().iter().map(|x| x.to_string()).collect();
let to_addresses: Vec<String> = envelope.to().iter().map(|x| x.to_string()).collect();
let mut process = Command::new(&self.command)
.args(&[
"-i",
"-f",
&email.from().to_string(),
&match envelope.from() {
Some(address) => address.to_string(),
None => "\"\"".to_string(),
},
&to_addresses.join(" "),
])
.stdin(Stdio::piped())

2
lettre/src/smtp/commands.rs
View File

@@ -307,7 +307,7 @@ mod test {
#[test]
fn test_display() {
let id = ClientId::Domain("localhost".to_string());
let email = EmailAddress::new("test@example.com".to_string());
let email = EmailAddress::new("test@example.com".to_string()).unwrap();
let mail_parameter = MailParameter::Other {
keyword: "TEST".to_string(),
value: Some("value".to_string()),

14
lettre/src/smtp/mod.rs
View File

@@ -308,6 +308,7 @@ impl<'a, T: Read + 'a> EmailTransport<'a, T, SmtpResult> for SmtpTransport {
fn send<U: SendableEmail<'a, T> + 'a>(&mut self, email: &'a U) -> SmtpResult {
// Extract email information
let message_id = email.message_id();
let envelope = email.envelope();
// Check if the connection is still available
if (self.state.connection_reuse_count > 0) && (!self.client.is_connected()) {
@@ -413,15 +414,22 @@ impl<'a, T: Read + 'a> EmailTransport<'a, T, SmtpResult> for SmtpTransport {
try_smtp!(
self.client
.command(MailCommand::new(Some(email.from().clone()), mail_options,)),
.command(MailCommand::new(envelope.from().cloned(), mail_options,)),
self
);
// Log the mail command
info!("{}: from=<{}>", message_id, email.from());
info!(
"{}: from=<{}>",
message_id,
match envelope.from() {
Some(address) => address.to_string(),
None => "".to_string(),
}
);
// Recipient
for to_address in &email.to() {
for to_address in envelope.to() {
try_smtp!(
self.client
.command(RcptCommand::new(to_address.clone(), vec![]),),

30
lettre/src/smtp/response.rs
View File

@@ -53,16 +53,26 @@ impl Display for Category {
/// The detail digit of a response code (third digit)
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
pub enum Detail {
#[allow(missing_docs)] Zero = 0,
#[allow(missing_docs)] One = 1,
#[allow(missing_docs)] Two = 2,
#[allow(missing_docs)] Three = 3,
#[allow(missing_docs)] Four = 4,
#[allow(missing_docs)] Five = 5,
#[allow(missing_docs)] Six = 6,
#[allow(missing_docs)] Seven = 7,
#[allow(missing_docs)] Eight = 8,
#[allow(missing_docs)] Nine = 9,
#[allow(missing_docs)]
Zero = 0,
#[allow(missing_docs)]
One = 1,
#[allow(missing_docs)]
Two = 2,
#[allow(missing_docs)]
Three = 3,
#[allow(missing_docs)]
Four = 4,
#[allow(missing_docs)]
Five = 5,
#[allow(missing_docs)]
Six = 6,
#[allow(missing_docs)]
Seven = 7,
#[allow(missing_docs)]
Eight = 8,
#[allow(missing_docs)]
Nine = 9,
}
impl Display for Detail {

8
lettre/src/stub/mod.rs
View File

@@ -29,11 +29,15 @@ pub type StubResult = Result<(), ()>;
impl<'a, T: Read + 'a> EmailTransport<'a, T, StubResult> for StubEmailTransport {
fn send<U: SendableEmail<'a, T>>(&mut self, email: &'a U) -> StubResult {
let envelope = email.envelope();
info!(
"{}: from=<{}> to=<{:?}>",
email.message_id(),
email.from(),
email.to()
match envelope.from() {
Some(address) => address.to_string(),
None => "".to_string(),
},
envelope.to()
);
self.response
}

11
lettre/tests/transport_file.rs
View File

@@ -4,7 +4,7 @@ extern crate lettre;
#[cfg(feature = "file-transport")]
mod test {
use lettre::{EmailAddress, EmailTransport, SendableEmail, SimpleSendableEmail};
use lettre::{EmailTransport, SendableEmail, SimpleSendableEmail};
use lettre::file::FileEmailTransport;
use std::env::temp_dir;
use std::fs::File;
@@ -15,11 +15,11 @@ mod test {
fn file_transport() {
let mut sender = FileEmailTransport::new(temp_dir());
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"file_id".to_string(),
"Hello file".to_string(),
);
).unwrap();
let result = sender.send(&email);
assert!(result.is_ok());
@@ -31,8 +31,7 @@ mod test {
assert_eq!(
buffer,
"{\"to\":[\"root@localhost\"],\"from\":\"user@localhost\",\"message_id\":\
\"file_id\",\"message\":[72,101,108,108,111,32,102,105,108,101]}"
"{\"envelope\":{\"forward_path\":[\"root@localhost\"],\"reverse_path\":\"user@localhost\"},\"message_id\":\"file_id\",\"message\":[72,101,108,108,111,32,102,105,108,101]}"
);
remove_file(file).unwrap();

8
lettre/tests/transport_sendmail.rs
View File

@@ -4,18 +4,18 @@ extern crate lettre;
#[cfg(feature = "sendmail-transport")]
mod test {
use lettre::{EmailAddress, EmailTransport, SimpleSendableEmail};
use lettre::{EmailTransport, SimpleSendableEmail};
use lettre::sendmail::SendmailTransport;
#[test]
fn sendmail_transport_simple() {
let mut sender = SendmailTransport::new();
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"sendmail_id".to_string(),
"Hello sendmail".to_string(),
);
).unwrap();
let result = sender.send(&email);
println!("{:?}", result);

8
lettre/tests/transport_smtp.rs
View File

@@ -4,7 +4,7 @@ extern crate lettre;
#[cfg(feature = "smtp-transport")]
mod test {
use lettre::{ClientSecurity, EmailAddress, EmailTransport, SimpleSendableEmail, SmtpTransport};
use lettre::{ClientSecurity, EmailTransport, SimpleSendableEmail, SmtpTransport};
#[test]
fn smtp_transport_simple() {
@@ -12,11 +12,11 @@ mod test {
.unwrap()
.build();
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"smtp_id".to_string(),
"Hello smtp".to_string(),
);
).unwrap();
sender.send(&email).unwrap();
}

9
lettre/tests/transport_stub.rs
View File

@@ -1,19 +1,18 @@
extern crate lettre;
use lettre::{EmailAddress, EmailTransport, SimpleSendableEmail};
use lettre::{EmailTransport, SimpleSendableEmail};
use lettre::stub::StubEmailTransport;
#[test]
fn stub_transport() {
let mut sender_ok = StubEmailTransport::new_positive();
let mut sender_ko = StubEmailTransport::new(Err(()));
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"stub_id".to_string(),
"Hello stub".to_string(),
);
).unwrap();
sender_ok.send(&email).unwrap();
sender_ko.send(&email).unwrap_err();

4
lettre_email/CHANGELOG.md
View File

@@ -7,6 +7,10 @@
* Add tests for the doc using skeptic
* Added a code of conduct
#### Changed
* `Envelope` was moved from `lettre_email` to `lettre`
#### Fixed
* Add missing "Bcc" headers when building the email

17
lettre_email/src/error.rs
View File

@@ -5,13 +5,13 @@ use std::error::Error as StdError;
use std::fmt::{self, Display, Formatter};
use std::io;
use lettre;
/// An enum of all error kinds.
#[derive(Debug)]
pub enum Error {
/// Missing sender
MissingFrom,
/// Missing recipient
MissingTo,
/// Envelope error
Email(lettre::Error),
/// Unparseable filename for attachment
CannotParseFilename,
/// IO error
@@ -27,8 +27,7 @@ impl Display for Error {
impl StdError for Error {
fn description(&self) -> &str {
match *self {
MissingFrom => "the sender is missing",
MissingTo => "the recipient is missing",
Email(ref err) => err.description(),
CannotParseFilename => "the attachment filename could not be parsed",
Io(ref err) => err.description(),
}
@@ -40,3 +39,9 @@ impl From<io::Error> for Error {
Io(err)
}
}
impl From<lettre::Error> for Error {
fn from(err: lettre::Error) -> Error {
Email(err)
}
}

90
lettre_email/src/lib.rs
View File

@@ -15,13 +15,14 @@ pub mod error;
pub use email_format::{Address, Header, Mailbox, MimeMessage, MimeMultipartType};
use error::Error;
use lettre::{EmailAddress, SendableEmail};
use lettre::{EmailAddress, Envelope, Error as EmailError, SendableEmail};
use mime::Mime;
use std::fs::File;
use std::io::Read;
use std::path::Path;
use time::{now, Tm};
use uuid::Uuid;
use std::str::FromStr;
/// Converts an address or an address with an alias to a `Header`
pub trait IntoHeader {
@@ -295,43 +296,6 @@ pub struct EmailBuilder {
date_issued: bool,
}
/// Simple email enveloppe representation
#[derive(PartialEq, Eq, Clone, Debug, Default)]
pub struct Envelope {
/// The envelope recipients' addresses
pub to: Vec<String>,
/// The envelope sender address
pub from: String,
}
impl Envelope {
/// Constructs an envelope with no receivers and an empty sender
pub fn new() -> Self {
Envelope {
to: vec![],
from: String::new(),
}
}
/// Adds a receiver
pub fn to<S: Into<String>>(mut self, address: S) -> Self {
self.add_to(address);
self
}
/// Adds a receiver
pub fn add_to<S: Into<String>>(&mut self, address: S) {
self.to.push(address.into());
}
/// Sets the sender
pub fn from<S: Into<String>>(mut self, address: S) -> Self {
self.set_from(address);
self
}
/// Sets the sender
pub fn set_from<S: Into<String>>(&mut self, address: S) {
self.from = address.into();
}
}
/// Simple email representation
#[derive(PartialEq, Eq, Clone, Debug)]
pub struct Email {
@@ -753,7 +717,7 @@ impl EmailBuilder {
Some(e) => e,
None => {
// we need to generate the envelope
let mut e = Envelope::new();
let mut e = Envelope::builder();
// add all receivers in to_header and cc_header
for receiver in self.to_header
.iter()
@@ -761,16 +725,13 @@ impl EmailBuilder {
.chain(self.bcc_header.iter())
{
match *receiver {
Address::Mailbox(ref m) => e.add_to(m.address.clone()),
Address::Mailbox(ref m) => e.add_to(EmailAddress::from_str(&m.address)?),
Address::Group(_, ref ms) => for m in ms.iter() {
e.add_to(m.address.clone());
e.add_to(EmailAddress::from_str(&m.address.clone())?);
},
}
}
if e.to.is_empty() {
return Err(Error::MissingTo);
}
e.set_from(match self.sender_header {
e.set_from(EmailAddress::from_str(&match self.sender_header {
Some(x) => x.address.clone(), // if we have a sender_header, use it
None => {
// use a from header
@@ -783,15 +744,15 @@ impl EmailBuilder {
// if it's an author group, use the first author
Some(mailbox) => mailbox.address.clone(),
// for an empty author group (the rarest of the rare cases)
None => return Err(Error::MissingFrom), // empty envelope sender
None => return Err(Error::Email(EmailError::MissingFrom)), // empty envelope sender
},
},
// if we don't have a from header
None => return Err(Error::MissingFrom), // empty envelope sender
None => return Err(Error::Email(EmailError::MissingFrom)), // empty envelope sender
}
}
});
e
})?);
e.build()?
}
};
// Add the collected addresses as mailbox-list all at once.
@@ -804,7 +765,7 @@ impl EmailBuilder {
self.message
.add_header(Header::new_with_value("From".into(), self.from_header).unwrap());
} else {
return Err(Error::MissingFrom);
return Err(Error::Email(EmailError::MissingFrom));
}
if !self.cc_header.is_empty() {
self.message
@@ -845,20 +806,12 @@ impl EmailBuilder {
}
impl<'a> SendableEmail<'a, &'a [u8]> for Email {
fn to(&self) -> Vec<EmailAddress> {
self.envelope
.to
.iter()
.map(|x| EmailAddress::new(x.clone()))
.collect()
}
fn from(&self) -> EmailAddress {
EmailAddress::new(self.envelope.from.clone())
fn envelope(&self) -> Envelope {
self.envelope.clone()
}
fn message_id(&self) -> String {
format!("{}", self.message_id)
self.message_id.to_string()
}
fn message(&'a self) -> Box<&[u8]> {
@@ -975,14 +928,17 @@ mod test {
.build()
.unwrap();
assert_eq!(email.from().to_string(), "sender@localhost".to_string());
assert_eq!(
email.to(),
email.envelope().from().unwrap().to_string(),
"sender@localhost".to_string()
);
assert_eq!(
email.envelope().to(),
vec![
EmailAddress::new("user@localhost".to_string()),
EmailAddress::new("cc@localhost".to_string()),
EmailAddress::new("bcc@localhost".to_string()),
]
EmailAddress::new("user@localhost".to_string()).unwrap(),
EmailAddress::new("cc@localhost".to_string()).unwrap(),
EmailAddress::new("bcc@localhost".to_string()).unwrap(),
].as_slice()
);
}

8
website/content/sending-messages/file.md
View File

@@ -16,17 +16,17 @@ extern crate lettre;
use std::env::temp_dir;
use lettre::file::FileEmailTransport;
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};
use lettre::{SimpleSendableEmail, EmailTransport};
fn main() {
// Write to the local temp directory
let mut sender = FileEmailTransport::new(temp_dir());
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"message_id".to_string(),
"Hello world".to_string(),
);
).unwrap();
let result = sender.send(&email);
assert!(result.is_ok());

8
website/content/sending-messages/sendmail.md
View File

@@ -12,15 +12,15 @@ The sendmail transport sends the email using the local sendmail command.
extern crate lettre;
use lettre::sendmail::SendmailTransport;
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};
use lettre::{SimpleSendableEmail, EmailTransport};
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"message_id".to_string(),
"Hello world".to_string(),
);
).unwrap();
let mut sender = SendmailTransport::new();
let result = sender.send(&email);

20
website/content/sending-messages/smtp.md
View File

@@ -26,15 +26,15 @@ This is the most basic example of usage:
```rust,no_run
extern crate lettre;
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress, SmtpTransport};
use lettre::{SimpleSendableEmail, EmailTransport, SmtpTransport};
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"message_id".to_string(),
"Hello world".to_string(),
);
).unwrap();
// Open a local connection on port 25
let mut mailer =
@@ -52,17 +52,17 @@ fn main() {
extern crate lettre;
use lettre::smtp::authentication::{Credentials, Mechanism};
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress, SmtpTransport};
use lettre::{SimpleSendableEmail, EmailTransport, SmtpTransport};
use lettre::smtp::extension::ClientId;
use lettre::smtp::ConnectionReuseParameters;
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"message_id".to_string(),
"Hello world".to_string(),
);
).unwrap();
// Connect to a remote server on a custom port
let mut mailer = SmtpTransport::simple_builder("server.tld").unwrap()
@@ -109,10 +109,10 @@ fn main() {
let _ = email_client.connect(&("localhost", SMTP_PORT), None);
let _ = email_client.command(EhloCommand::new(ClientId::new("my_hostname".to_string())));
let _ = email_client.command(
MailCommand::new(Some(EmailAddress::new("user@example.com".to_string())), vec![])
MailCommand::new(Some(EmailAddress::new("user@example.com".to_string()).unwrap()), vec![])
);
let _ = email_client.command(
RcptCommand::new(EmailAddress::new("user@example.org".to_string()), vec![])
RcptCommand::new(EmailAddress::new("user@example.org".to_string()).unwrap(), vec![])
);
let _ = email_client.command(DataCommand);
let _ = email_client.message(Box::new("Test email".as_bytes()));

8
website/content/sending-messages/stub.md
View File

@@ -13,15 +13,15 @@ testing purposes.
extern crate lettre;
use lettre::stub::StubEmailTransport;
use lettre::{SimpleSendableEmail, EmailTransport, EmailAddress};
use lettre::{SimpleSendableEmail, EmailTransport};
fn main() {
let email = SimpleSendableEmail::new(
EmailAddress::new("user@localhost".to_string()),
vec![EmailAddress::new("root@localhost".to_string())],
"user@localhost".to_string(),
&["root@localhost".to_string()],
"message_id".to_string(),
"Hello world".to_string(),
);
).unwrap();
let mut sender = StubEmailTransport::new_positive();
let result = sender.send(&email);