Struct lettre::transport::smtp::AsyncSmtpTransport

source · [−]

pub struct AsyncSmtpTransport<E: Executor> { /* private fields */ }

Available on crate feature smtp-transport and (crate features tokio1 or async-std1) only.

Expand description

Asynchronously sends emails using the SMTP protocol

Implementations

source

impl<E> AsyncSmtpTransport<E> where
E: Executor,

source

pub fn relay(relay: &str) -> Result<AsyncSmtpTransportBuilder, Error>

Available on crate features tokio1-native-tls or tokio1-rustls-tls or async-std1-rustls-tls only.

Simple and secure transport, using TLS connections to communicate with the SMTP server

The right option for most SMTP servers.

Creates an encrypted transport over submissions port, using the provided domain to validate TLS certificates.

source

pub fn starttls_relay(relay: &str) -> Result<AsyncSmtpTransportBuilder, Error>

Available on crate features tokio1-native-tls or tokio1-rustls-tls or async-std1-rustls-tls only.

Simple an secure transport, using STARTTLS to obtain encrypted connections

Alternative to AsyncSmtpTransport::relay, for SMTP servers that don’t take SMTPS connections.

Creates an encrypted transport over submissions port, by first connecting using an unencrypted connection and then upgrading it with STARTTLS. The provided domain is used to validate TLS certificates.

An error is returned if the connection can’t be upgraded. No credentials or emails will be sent to the server, protecting from downgrade attacks.

source

pub fn unencrypted_localhost() -> AsyncSmtpTransport<E>

Creates a new local SMTP client to port 25

Shortcut for local unencrypted relay (typical local email daemon that will handle relaying)

source

pub fn builder_dangerous<T: Into<String>>(
server: T
) -> AsyncSmtpTransportBuilder

Creates a new SMTP client

Defaults are:

No authentication
No TLS
A 60 seconds timeout for smtp commands
Port 25

Consider using AsyncSmtpTransport::relay or AsyncSmtpTransport::starttls_relay instead, if possible.

source

pub async fn test_connection(&self) -> Result<bool, Error>

Tests the SMTP connection

test_connection() tests the connection by using the SMTP NOOP command. The connection is closed afterwards if a connection pool is not used.

Trait Implementations

source

impl AsyncTransport for AsyncSmtpTransport<Tokio1Executor>

source

fn send_raw<'life0, 'life1, 'life2, 'async_trait>(
 &'life0 self,
 envelope: &'life1 Envelope,
 email: &'life2 [u8 ]
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
 'life0: 'async_trait,
 'life1: 'async_trait,
 'life2: 'async_trait,
 Self: 'async_trait,

Available on crate features tokio1 or async-std1 only.

Sends an email

type Ok = Response

Available on crate features tokio1 or async-std1 only.

Response produced by the Transport

type Error = Error

Available on crate features tokio1 or async-std1 only.

Error produced by the Transport

source

fn send<'life0, 'async_trait>(
 &'life0 self,
 message: Message
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
 'life0: 'async_trait,
 Self: Sync + 'async_trait,

Available on (crate features tokio1 or async-std1) and crate feature builder only.

Sends the email

source

impl AsyncTransport for AsyncSmtpTransport<AsyncStd1Executor>

source

fn send_raw<'life0, 'life1, 'life2, 'async_trait>(
 &'life0 self,
 envelope: &'life1 Envelope,
 email: &'life2 [u8 ]
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
 'life0: 'async_trait,
 'life1: 'async_trait,
 'life2: 'async_trait,
 Self: 'async_trait,

Available on crate features tokio1 or async-std1 only.

Sends an email

type Ok = Response

Available on crate features tokio1 or async-std1 only.

Response produced by the Transport

type Error = Error

Available on crate features tokio1 or async-std1 only.

Error produced by the Transport

source

fn send<'life0, 'async_trait>(
 &'life0 self,
 message: Message
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
 'life0: 'async_trait,
 Self: Sync + 'async_trait,

Available on (crate features tokio1 or async-std1) and crate feature builder only.

Sends the email

source

impl<E> Clone for AsyncSmtpTransport<E> where
E: Executor,

source

fn clone(&self) -> Self

Returns a copy of the value. Read more

1.0.0 · source

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

source

impl<E: Executor> Debug for AsyncSmtpTransport<E>

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations

impl<E> !RefUnwindSafe for AsyncSmtpTransport<E>

impl<E> Send for AsyncSmtpTransport<E>

impl<E> Sync for AsyncSmtpTransport<E>

impl<E> Unpin for AsyncSmtpTransport<E>

impl<E> !UnwindSafe for AsyncSmtpTransport<E>

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn vzip(self) -> V

source

impl<T> WithSubscriber for T

source

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

source

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

Struct lettre::transport::smtp::AsyncSmtpTransport

Implementations

impl<E> AsyncSmtpTransport<E> where E: Executor,

pub fn relay(relay: &str) -> Result<AsyncSmtpTransportBuilder, Error>

pub fn starttls_relay(relay: &str) -> Result<AsyncSmtpTransportBuilder, Error>

pub fn unencrypted_localhost() -> AsyncSmtpTransport<E>

pub fn builder_dangerous<T: Into<String>>( server: T) -> AsyncSmtpTransportBuilder

pub async fn test_connection(&self) -> Result<bool, Error>

Trait Implementations

impl AsyncTransport for AsyncSmtpTransport<Tokio1Executor>

fn send_raw<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, envelope: &'life1 Envelope, email: &'life2 [u8]) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

type Ok = Response

type Error = Error

fn send<'life0, 'async_trait>( &'life0 self, message: Message) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where 'life0: 'async_trait, Self: Sync + 'async_trait,

impl AsyncTransport for AsyncSmtpTransport<AsyncStd1Executor>

fn send_raw<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, envelope: &'life1 Envelope, email: &'life2 [u8]) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

type Ok = Response

type Error = Error

fn send<'life0, 'async_trait>( &'life0 self, message: Message) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where 'life0: 'async_trait, Self: Sync + 'async_trait,

impl<E> Clone for AsyncSmtpTransport<E> where E: Executor,

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl<E: Executor> Debug for AsyncSmtpTransport<E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Auto Trait Implementations

impl<E> !RefUnwindSafe for AsyncSmtpTransport<E>

impl<E> Send for AsyncSmtpTransport<E>

impl<E> Sync for AsyncSmtpTransport<E>

impl<E> Unpin for AsyncSmtpTransport<E>

impl<E> !UnwindSafe for AsyncSmtpTransport<E>

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> Same<T> for T

type Output = T

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for T where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self>

impl<E> AsyncSmtpTransport<E> where
E: Executor,

pub fn builder_dangerous<T: Into<String>>(
server: T
) -> AsyncSmtpTransportBuilder

fn send_raw<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
envelope: &'life1 Envelope,
email: &'life2 [u8 ]
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Self: 'async_trait,

fn send<'life0, 'async_trait>(
&'life0 self,
message: Message
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
'life0: 'async_trait,
Self: Sync + 'async_trait,

fn send_raw<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
envelope: &'life1 Envelope,
email: &'life2 [u8 ]
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Self: 'async_trait,

fn send<'life0, 'async_trait>(
&'life0 self,
message: Message
) -> Pin<Box<dyn Future<Output = Result<Self::Ok, Self::Error>> + Send + 'async_trait>> where
'life0: 'async_trait,
Self: Sync + 'async_trait,

impl<E> Clone for AsyncSmtpTransport<E> where
E: Executor,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,