lettre

Bug Fixes

• Separate lines of multiline SMTP error replies (#1153)

Misc

• Upgrade base64 to v0.23 (#1152)

Bug Fixes

• Separate lines of multiline SMTP error replies (#1153)

Misc

• Upgrade base64 to v0.23 (#1152)

<a name="v0.11.22"></a>

Security

• Fix inverted TLS hostname verification flag in boring-tls backend that silently disabled hostname verification f5efffc

Bug Fixes

• Cap read_response buffer to prevent unbounded memory growth #1143

Misc

• Upgrade rustls-platform-verifier to v0.7 #1136

Security

• Fix inverted TLS hostname verification flag in boring-tls backend that silently disabled hostname verification (f5efffc)

Bug Fixes

• Cap read_response buffer to prevent unbounded memory growth (#1143)

Misc

• Upgrade rustls-platform-verifier to v0.7 (#1136)

<a name="v0.11.21"></a>

Features

• Add rustls-no-provider support (#1134)
• Add message_iter to AsyncConnection and Connection (#1116)

Features

• Add rustls-no-provider support (#1134)
• Add message_iter to AsyncConnection and Connection (#1116)

<a name="v0.11.20"></a>

Upgrade notes

• MSRV is now 1.85 #1130

Features

• Add Address::new_dangerous #1107

Misc

• Replace chumsky with nom for email address parsing #1099
• Upgrade to Rust 2024 edition #1130
• Upgrade boring and tokio-boring to v5 #1130

Upgrade notes

• MSRV is now 1.85 (#1130)

Features

• Add Address::new_dangerous (#1107)

Misc

• Replace chumsky with nom for email address parsing (#1099)
• Upgrade to Rust 2024 edition (#1130)
• Upgrade boring and tokio-boring to v5 (#1130)

<a name="v0.11.19"></a>

Features

• Add raw header setter to MessageBuilder (#1108)

Misc

• Fix README example (#1114)
• Replace custom static_assert! macro with std::assert! (#1112)

Features

• Add raw header setter to MessageBuilder (#1108)

Misc

• Fix README example (#1114)
• Replace custom static_assert! macro with std::assert! (#1112)

<a name="v0.11.18"></a>

Features

• Allow inline attachments to be named (#1101)

Misc

• Upgrade socket2 to v0.6 (#1098)

Features

• Allow inline attachments to be named (#1101)

Misc

• Upgrade socket2 to v0.6 (#1098)

<a name="v0.11.17"></a>

Features

• Add support for rustls-platform-verifier (#1081)

Misc

• Change readme example to use Mailbox::new instead of string parsing (#1090)
• Replace futures-util Mutex with std Mutex in AsyncStubTransport (#1091)
• Avoid duplicate abort_concurrent implementation (#1092)

Features

• Add support for rustls-platform-verifier (#1081)

Misc

• Change readme example to use Mailbox::new instead of string parsing (#1090)
• Replace futures-util Mutex with std Mutex in AsyncStubTransport (#1091)
• Avoid duplicate abort_concurrent implementation (#1092)

<a name="v0.11.16"></a>

Features

• Always implement Clone for AsyncFileTransport (#1075)

Changes

• Tls, CertificateStore, TlsParameters, TlsParametersBuilder, Certificate and Identity
  are now marked as deprecated when no TLS backend is enabled. They will be properly feature gated
  in lettre v0.12 (#1084)

Misc

• Gate web-time behind cfg(target_arch = "wasm32")] (#1086)
• Add missing #[doc(cfg(...))] attributes (#1086)
• Upgrade webpki-roots to v1 (#1088)
• Cleanup internal TlsParameters and (Async)NetworkStream structures (#1082)
• Feature gate internal TransportBuilder::tls to avoid recursive call site warnings (#1083)
• Fix workaround for embedding cargo script in rustdoc output ([#1077])
• Fix clippy::io_other_error warnings (#1078)
• Upgrade semver compatible dependencies (#1076, #1079, #1080)

Features

• Always implement Clone for AsyncFileTransport (#1075)

Changes

• Tls, CertificateStore, TlsParameters, TlsParametersBuilder, Certificate and Identity are now marked as deprecated when no TLS backend is enabled. They will be properly feature gated in lettre v0.12 (#1084)

Misc

• Gate web-time behind cfg(target_arch = "wasm32")] (#1086)
• Add missing #[doc(cfg(...))] attributes (#1086)
• Upgrade webpki-roots to v1 (#1088)
• Cleanup internal TlsParameters and (Async)NetworkStream structures (#1082)
• Feature gate internal TransportBuilder::tls to avoid recursive call site warnings (#1083)
• Fix workaround for embedding cargo script in rustdoc output (#1077)
• Fix clippy::io_other_error warnings (#1078)
• Upgrade semver compatible dependencies (#1076, #1079, #1080)

<a name="v0.11.15"></a>

Upgrade notes

• MSRV is now 1.74 (#1060)

Features

• Add controlled shutdown methods (#1045, #1068)

Misc

• Deny unreachable_pub lint (#1058)
• Bump minimum supported rustls (#1063)
• Bump minimum supported serde (#1064)
• Upgrade semver compatible dependencies (#1067)
• Upgrade email-encoding to v0.4 (#1069)

Upgrade notes

• MSRV is now 1.74 (#1060)

Features

• Add controlled shutdown methods (#1045, #1068)

Misc

• Deny unreachable_pub lint (#1058)
• Bump minimum supported rustls (#1063)
• Bump minimum supported serde (#1064)
• Upgrade semver compatible dependencies (#1067)
• Upgrade email-encoding to v0.4 (#1069)

<a name="v0.11.14"></a>

This release deprecates the rustls-tls, tokio1-rustls-tls and async-std1-rustls-tls
features, which will be removed in lettre v0.12.

rustls users should start migrating to the rustls, tokio1-rustls and
async-std1-rustls features. Unlike the deprecated *rustls-tls features,
which automatically enabled the ring and webpki-roots backends, the new
features do not. To complete the migration, users must either enable the
aws-lc-rs or the ring feature. Additionally, those who rely on webpki-roots
for TLS certificate verification must now explicitly enable its feature.
Users of rustls-native-certs do not need to enable webpki-roots.

Find out more about the new features via the lettre rustls docs.

Features

• Make it possible to use different rustls crypto providers and TLS verifiers (#1054)

Bug fixes

• Use the same rustls crypto provider everywhere (#1055)

Misc

• Deprecate AsyncNetworkStream being public (#1059)
• Upgrade nom to v8 ([#1048])
• Drop rustls-pemfile in favor of rustls-pki-types APIs (#1050)
• Ban direct use of std::time::SystemTime::now via clippy (#1043)
• Drop direct dependency on rustls-pki-types (#1051)
• Remove artifact from web-time refactor (#1049)
• Fix warnings with rustls-native-certs when tracing is disabled (#1053)
• Bump license year (#1057)
• Cleanup Cargo.toml style (#1047)

This release deprecates the rustls-tls, tokio1-rustls-tls and async-std1-rustls-tls features, which will be removed in lettre v0.12.

rustls users should start migrating to the rustls, tokio1-rustls and async-std1-rustls features. Unlike the deprecated *rustls-tls features, which automatically enabled the ring and webpki-roots backends, the new features do not. To complete the migration, users must either enable the aws-lc-rs or the ring feature. Additionally, those who rely on webpki-roots for TLS certificate verification must now explicitly enable its feature. Users of rustls-native-certs do not need to enable webpki-roots.

Find out more about the new features via the lettre rustls docs.

Features

• Make it possible to use different rustls crypto providers and TLS verifiers (#1054)

Bug fixes

• Use the same rustls crypto provider everywhere (#1055)

Misc

• Deprecate AsyncNetworkStream being public (#1059)
• Upgrade nom to v8 (#1048)
• Drop rustls-pemfile in favor of rustls-pki-types APIs (#1050)
• Ban direct use of std::time::SystemTime::now via clippy (#1043)
• Drop direct dependency on rustls-pki-types (#1051)
• Remove artifact from web-time refactor (#1049)
• Fix warnings with rustls-native-certs when tracing is disabled (#1053)
• Bump license year (#1057)
• Cleanup Cargo.toml style (#1047)

<a name="v0.11.13"></a>

Features

• Add WASM support (#1037, #1042)
• Add method to get the TLS verify result with BoringSSL (#1039)

Bug fixes

• Synchronous pool shutdowns being arbitrarily delayed (#1041)

<a name="v0.11.12"></a>

Misc

• Warn against manually configuring port and tls on SMTP transport builder (#1014)
• Document variants of Tls enum (#1015)
• Fix rustdoc warnings (#1016)
• Add ContentType::TEXT_PLAIN to Message builder examples (#1017)
• Document SmtpTransport and AsyncSmtpTransport (#1018)
• Fix typo in transport builder credentials method (#1019)
• Document required system dependencies for OpenSSL (#1030)
• Improve docs for the transport::smtp module (#1031)
• Improve docs for smtp transport builder from_url (#1032)
• Replace assert! with ? on send examples (#1033)
• Warn on more pedantic clippy lints and fix them (#1035, #1036)

<a name="v0.11.11"></a>

Upgrade notes

• MSRV is now 1.71 (#1008)

Bug fixes

• Fix off-by-one error reaching the minimum number of configured pooled connections (#1012)

Misc

• Fix clippy warnings (#1009)
• Fix -Zminimal-versions build (#1007)

<a name="v0.11.10"></a>

Bug fixes

• Ignore disconnect errors when pool feature of SMTP transport is disabled (#999)
• Use case insensitive comparisons for matching login challenge requests (#1000)

<a name="v0.11.9"></a>

Bug fixes

• Fix feature gate for accept_invalid_hostnames for rustls (#988)
• Fix parsing Mailbox with trailing spaces (#986)

Misc

• Bump rustls-native-certs to v0.8 (#992)
• Make getting started example in readme complete (#990)

<a name="v0.11.8"></a>

Features

• Add mTLS support (#974)
• Implement accept_invalid_hostnames for rustls (#977)
• Provide certificate chain for peer certificates when using rustls or boring-tls (#976)

Changes

• Make HeaderName comparisons via PartialEq case insensitive (#980)

Misc

• Fix clippy warnings ([#979])
• Replace manual impl of #[non_exhaustive] for InvalidHeaderName (#981)

<a name="v0.11.7"></a>

Misc

• Bump hostname to v0.4 (#956)
• Fix tracing message consistency (#960)
• Bump minimum required rustls to v0.23.5 (#958)
• Dropped use of ref syntax in the entire project (#959)

<a name="v0.11.6"></a>

Bug fixes

• Upgraded email-encoding to v0.3 - fixing multiple encoding bugs in the process (#952)

Misc

• Updated copyright year in license (#954)

<a name="v0.11.5"></a>

Features

• Support SMTP SASL draft login challenge (#911)
• Add conversion from SMTP response code to integer (#941)

Misc

• Upgrade rustls to v0.23 (#950)
• Bump base64 to v0.22 (#945)
• Fix typos in documentation (#943, #944)
• Add Cargo.lock (#942)

<a name="v0.11.4"></a>

Bug fixes

• Percent decode credentials in SMTP connect URL (#932, #934)
• Fix mimebody DKIM body-hash computation (#923)

<a name="v0.11.3"></a>

Features

• Derive Clone for FileTransport and AsyncFileTransport (#924)
• Derive Debug for SmtpTransport (#925)

Misc

• Upgrade rustls to v0.22 (#921)
• Drop once_cell dependency in favor of OnceLock from std (#928)

<a name="v0.11.2"></a>

Upgrade notes

• MSRV is now 1.70 (#916)

Misc

• Bump idna to v0.5 (#918)
• Bump boring and tokio-boring to v4 (#915)

<a name="v0.11.1"></a>

Bug fixes

• Fix webpki-roots certificate store setup (#909)

<a name="v0.11.0"></a>

While this release technically contains breaking changes, we expect most projects to be able to upgrade by only bumping the version in Cargo.toml.

Upgrade notes

• MSRV is now 1.65 (#869 and #881)
• AddressError is now marked as #[non_exhaustive] (#839)

Features

• Improve mailbox parsing (#839)
• Add construction of SMTP transport from URL (#901)
• Add From<Address> implementation for Mailbox (#879)

Misc

• Bump socket2 to v0.5 (#868)
• Bump idna to v0.4, fastrand to v2, quoted_printable to v0.5, rsa to v0.9 (#882)
• Bump webpki-roots to v0.25 (#884 and #890)
• Bump ed25519-dalek to v2 fixing RUSTSEC-2022-0093 (#896)
• Bump boringssl crates to v3 (#897)

<a name="v0.10.4"></a>

Misc

• Bumped rustls to 0.21 and all related dependencies (#867)

<a name="v0.10.3"></a>

Announcements

It was found that what had been used until now as a basic lettre 0.10 MessageBuilder::body example failed to mention that for maximum compatibility with various email clients a Content-Type header should always be present in the message.

Before

Message::builder()
  // [...] some headers skipped for brevity
  .body(String::from("A plaintext or html body"))?

Patch

 Message::builder()
   // [...] some headers skipped for brevity
+  .header(ContentType::TEXT_PLAIN) // or `TEXT_HTML` if the body is html
   .body(String::from("A plaintext or html body"))?

Features

• Add support for rustls-native-certs when using rustls (#843)

<a name="v0.10.2"></a>

Upgrade notes

• MSRV is now 1.60 (#828)

Features

• Allow providing a custom tokio stream for AsyncSmtpTransport (#805)
• Return whole SMTP error message (#821)

Bug fixes

• Mailbox displays wrongly when containing a comma and a non-ascii char in its name (#827)
• Require quoted_printable ^0.4.6 in order to fix encoding of tabs and spaces at the end of line (#837)

Misc

• Increase tracing (#848)
• Bump idna to 0.3 (#816)
• Update base64 to 0.21 (#840 and #851)
• Update rsa to 0.8 (#829 and #852)

<a name="v0.10.1"></a>

Features

• Add boring-tls support for SmtpTransport and AsyncSmtpTransport. The latter is only supported with the tokio runtime. (#797) (#798)
• Make the minimum TLS version configurable. (#799) (#800)

Bug Fixes

• Ensure connections are closed on abort. (#801)
• Fix SMTP dot stuffing. (#803)

<a name="v0.10.0"></a>

Upgrade notes

Several breaking changes were made between 0.9 and 0.10, but changes should be straightforward:

• MSRV is now 1.56.0
• The lettre_email crate has been merged into lettre. To migrate, replace lettre_email with lettre::message and make sure to enable the builder feature (it's enabled by default).
• SendableEmail has been renamed to Email and EmailBuilder::build() produces it directly. To migrate, rename SendableEmail to Email.
• The serde-impls feature has been renamed to serde. To migrate, rename the feature.

Features

• Add tokio 1 support
• Add rustls support
• Add async-std support. NOTE: native-tls isn't supported when using async-std for the smtp transport.
• Allow enabling multiple SMTP authentication mechanisms
• Allow providing a custom message id
• Allow sending raw emails

Breaking Changes

• Merge lettre_email into lettre
• Merge Email and SendableEmail into lettre::message::Email
• SmtpTransport is now an high level SMTP client. It provides connection pooling and shortcuts for building clients using commonly desired values
• Refactor TlsParameters implementation to not expose the internal TLS library
• FileTransport writes emails into .eml instead of .json
• When the hostname feature is disabled or hostname cannot be fetched, 127.0.0.1 is used instead of localhost as EHLO parameter (for better RFC compliance and mail server compatibility)
• The sendmail and file transports aren't enabled by default anymore.
• The new method of ClientId is deprecated
• Rename serde-impls feature to serde
• The SendmailTransport now uses the sendmail command in current PATH by default instead of /usr/bin/sendmail.

Bug Fixes

• Fix argument injection in SendmailTransport (see RUSTSEC-2020-0069)
• Correctly encode header values containing non-ASCII characters
• Timeout bug causing infinite hang
• Fix doc tests in website
• Fix docs for domain field

Misc

• Improve documentation, examples and tests
• Replace line-wrap, email, bufstream with our own implementations
• Remove bytes
• Remove time
• Remove fast_chemail
• Update base64 to 0.13
• Update hostname to 0.3
• Update to nom 6
• Replace log with tracing
• Move CI to GitHub Actions
• Use criterion for benchmarks

<a name="v0.9.2"></a>

Bug Fixes

• email:
  • Fix compilation with Rust 1.36+ (393ef8d)

<a name="v0.9.1"></a>

Features

• email:
  • Re-export mime crate (a0c8fb9)

<a name="v0.9.0"></a>

Bug Fixes

• email:

  • Inserting 'from' from envelope into message headers (058fa69)
  • Do not include Bcc addresses in headers (ee31bbe)

• transport:

  • Write timeout is not set in smtp transport (d71b560)
  • Client::read_response infinite loop (72f3cd8)

Features

• all:

  • Update dependencies
  • Start using the failure crate for errors (c10fe3d)

• transport:

  • Remove TLS 1.1 in accepted protocols by default (only allow TLS 1.2) (4b48bdb)
  • Initial support for XOAUTH2 (ed7c164)
  • Remove support for CRAM-MD5 (bc09aa2)
  • SMTP connection pool implementation with r2d2 (434654e)
  • Use md-5 and hmac instead of rust-crypto (e7e0f34)
  • Gmail transport simple example (a8d8e2a)

• email:

  • Add In-Reply-To and References headers (fc91bb6)
  • Remove non-chaining builder methods (1baf8a9)

<a name="v0.8.2"></a>

Bug Fixes

• transport: Write timeout is not set in smtp transport (cc3580a8)

Style

• all: Fix typos (360c42ff)

Features

• all:
  • Add set -xe option to build scripts (57bbabaa)
  • Move post-success scripts to separate files (3177b58c)
  • Add website upload to travis build script (a5294df6)
  • Add codecov upload in travis (a03bfa00)
  • Update README to put useful links at the top (1ebbe660)
  • Update badges in README and Cargo.toml (f7ee5c42)
  • Move docs from hugo to gitbook (27935e32)
• transport: Use md-5 and hmac instead of rust-crypto (0cf018a8)

<a name="v0.8.1"></a>

Fix

• all:
  • Replace skeptic by some custom rustdoc invocations (81bad131)

Documentation

• all:
  • Add changelog sections for style and docs (b4d03ead)
  • Use clog to generate changelogs (8981a775, closes #233)

Style

• transport-smtp: Avoid useless empty format strings (f3271715)

<a name="v0.8.0"></a>

Added

• Support binary files as attachment
• Move doc to a dedicated website
• Add tests for the doc using skeptic
• Added a code of conduct
• Use hostname as ClientId when available

Changed

• 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

Fixed

• Add missing "Bcc" headers when building the email
• Specify utf-8 charset for html
• Use parts for text and html methods to work with attachments

Removed

• get_ehlo and reset in SmtpTransport are now private

<a name="v0.7.0"></a>

Added

• Allow validating server certificate
• Initial (incomplete) attachments support

Changed

• Split into the lettre and lettre_email crates
• A lot of small improvements
• Use tls-native instead of openssl in smtp transport

<a name="v0.6.2"></a>

Changed

• Update env-logger crate to 0.4
• Update openssl crate to 0.9
• Update uuid crate to 0.4

<a name="v0.6.1"></a>