Struct SmtpClientStd 

pub struct SmtpClientStd {
    pub inner: SmtpClientStd,
    pub default_reverse_path: Option<String>,
}

Available on crate features client and smtp only.

Light SMTP client built on a generic blocking stream.

default_reverse_path overrides the MAIL FROM envelope sender for accounts whose header From: differs from the SMTP sender (DKIM-aligned gateways, bounce-address rewriting).

Fields

inner: SmtpClientStd

default_reverse_path: Option<String>

Implementations

impl SmtpClientStd

pub fn new<S: Read + Write + Send + 'static>(stream: S) -> Self

Wraps an already-authenticated SMTP stream with no envelope override.

pub fn run<C, T, E>(&mut self, coroutine: C) -> Result<T, SmtpClientError>

where C: SmtpCoroutine<Yield = SmtpYield, Return = Result<T, E>>, SmtpClientError: From<E>,

Pumps any standard-shape SMTP coroutine (Yield = SmtpYield, Return = Result<T, E>) against the inner client’s stream until it terminates.

Reaches into Self::inner for raw field access rather than delegating to InnerSmtpClientStd::run so error variants route through SmtpClientError directly.

pub fn ping(&mut self) -> Result<(), SmtpClientError>

Sends a NOOP to keep the connection alive (RFC 5321 §4.1.1.9). Sole purpose is to reset the server’s inactivity timer on long-idle TUI sessions; the response is discarded.

pub fn send_message(&mut self, raw: Vec<u8>) -> Result<(), SmtpClientError>

Sends the raw RFC 5322 raw message through the authenticated stream. Reverse path comes from Self::default_reverse_path when set, otherwise from the message’s From: header; forward paths come from To: + Cc: + Bcc:.

impl SmtpClientStd

pub fn connect( url: &Url, tls: &Tls, starttls: bool, domain: EhloDomain<'_>, sasl: Option<impl Into<Sasl>>, ) -> Result<Self, SmtpClientError>

Available on crate features native-tls or rustls-aws or rustls-ring only.

Opens a TCP / TLS connection to url, runs the optional STARTTLS upgrade plus EHLO + SASL authentication, then wraps the authenticated stream with the io-email knobs (empty default_reverse_path).