Struct SessionContext 

pub struct SessionContext {
    pub session_id: String,
    pub client_ip: IpAddr,
    pub protocol: String,
    pub username: Option<String>,
}

Session context for structured logging

Contains all session-level information that should be attached to log events:

• Unique session ID
• Client IP address
• Protocol name (SMTP, IMAP, POP3, JMAP)
• Optional authenticated username

Fields

session_id: String

Unique session identifier (UUID v4)

client_ip: IpAddr

Client IP address

protocol: String

Protocol name (e.g., “SMTP”, “IMAP”, “POP3”, “JMAP”)

username: Option<String>

Authenticated username (if any)

Implementations

impl SessionContext

pub fn new(client_ip: IpAddr, protocol: impl Into<String>) -> Self

Create a new session context with a generated UUID

Arguments

• client_ip - The client’s IP address
• protocol - The protocol name (e.g., “SMTP”, “IMAP”)

Example

use rusmes_server::session_logging::SessionContext;
use std::net::IpAddr;

let session = SessionContext::new(
    IpAddr::from([192, 168, 1, 100]),
    "SMTP",
);

pub fn with_id( session_id: impl Into<String>, client_ip: IpAddr, protocol: impl Into<String>, ) -> Self

Create a new session context with a custom session ID

Useful for testing or when you need a specific ID format.

Arguments

• session_id - Custom session ID
• client_ip - The client’s IP address
• protocol - The protocol name

pub fn set_username(&mut self, username: impl Into<String>)

Set the authenticated username

Call this after successful authentication to include the username in all subsequent log events.

Arguments

• username - The authenticated username

pub fn session_id(&self) -> &str

Get the session ID

pub fn client_ip(&self) -> IpAddr

Get the client IP

pub fn protocol(&self) -> &str

Get the protocol name

pub fn username(&self) -> Option<&str>

Get the username if authenticated

Trait Implementations

impl Clone for SessionContext

fn clone(&self) -> SessionContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionContext

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

Formats the value using the given formatter.