wasm-smtp 0.15.1

Environment-independent SMTP client core for WASM and other constrained runtimes.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

//! Internal `tracing` helpers.
//!
//! When the `tracing` cargo feature is enabled, these forward to
//! the corresponding `tracing` macros. When the feature is
//! disabled, they compile to no-ops, so call sites can use them
//! unconditionally without scattering `#[cfg]` attributes through
//! the SMTP state machine.
//!
//! All events are emitted with `target = "wasm_smtp"` so callers
//! can filter on this single name in their `tracing-subscriber`
//! configuration.
//!
//! ## What is logged
//!
//! See the `tracing` cargo feature documentation in `Cargo.toml`.
//! In short:
//!
//! - `trace!`: individual wire frames (request and response text).
//! - `debug!`: major SMTP transitions and envelope values.
//! - `warn!`: recoverable failures.
//! - `error!`: unrecoverable failures that close the session.
//!
//! ## What is NOT logged
//!
//! Passwords, OAuth tokens, AUTH challenge bytes, SCRAM nonces,
//! message bodies. The call sites in `client.rs` carry this rule;
//! this module just provides the macros.

#![allow(unused_macros)]

/// Emit a `trace!`-level event with `target = "wasm_smtp"`.
macro_rules! smtp_trace {
    ($($arg:tt)+) => {
        #[cfg(feature = "tracing")]
        ::tracing::trace!(target: "wasm_smtp", $($arg)+);
    };
}

/// Emit a `debug!`-level event with `target = "wasm_smtp"`.
macro_rules! smtp_debug {
    ($($arg:tt)+) => {
        #[cfg(feature = "tracing")]
        ::tracing::debug!(target: "wasm_smtp", $($arg)+);
    };
}

/// Emit a `warn!`-level event with `target = "wasm_smtp"`.
macro_rules! smtp_warn {
    ($($arg:tt)+) => {
        #[cfg(feature = "tracing")]
        ::tracing::warn!(target: "wasm_smtp", $($arg)+);
    };
}

/// Emit an `error!`-level event with `target = "wasm_smtp"`.
macro_rules! smtp_error {
    ($($arg:tt)+) => {
        #[cfg(feature = "tracing")]
        ::tracing::error!(target: "wasm_smtp", $($arg)+);
    };
}

pub(crate) use {smtp_debug, smtp_error, smtp_trace, smtp_warn};