Struct SessionDirSpec 

pub struct SessionDirSpec {
    pub session_name: Option<String>,
    pub session_path: Option<String>,
    pub reuse: SessionReuse,
    pub session_keep: usize,
    pub session_shelflife: Duration,
    pub force_new: bool,
}

Resolved session inputs from CLI / env. Built by resolve_session_dir from one of:

• The umbrella --session <kv-list> flag (a comma-separated list of key:value pairs and bare shortcuts).
• Per-key long-form flags (--session-name, --session-path, --session-reuse, --session-keep, --session-shelflife).
• SESSION_DIRECTORY env var (equivalent to --session-path).

When both forms are present the long-form flag wins; the umbrella flag is shorthand. Within the umbrella value the last-wins rule applies if a key is repeated.

Fields

session_name: Option<String>

name — session id (basename of the session directory). Used in metric labels and as the resolved value of the SESSION token in path. When unset, defaults to the auto-generated <scenario>_<timestamp> form.

session_path: Option<String>

path — full directory path. Optional SESSION token inside the path is replaced with session_name at write time. When unset, the path is logs/<session_name>/.

reuse: SessionReuse

reuse — policy when the resolved directory already contains prior session artifacts. Default Error.

session_keep: usize

keep — number of session directories retained under the parent at startup. Default 10. 0 disables.

session_shelflife: Duration

shelflife — max age of a session directory before purge at startup. Default 4 weeks. 0 disables.

force_new: bool

SRD-106 — the umbrella bare token new (--session new): force a fresh auto-named session. Its only consumer is the stick_session resolution rung, which it defeats; with no stick in play a fresh session is already the default, so the token is a harmless no-op there.

Implementations

impl SessionDirSpec

pub fn is_empty(&self) -> bool

true when no path/name flag is set — caller falls back to the default logs/<auto_id>/ behavior. (reuse, keep, shelflife are always present at their defaults and don’t count toward “is this empty?”.)

pub fn resolve(&self, auto_id: &str) -> Option<(PathBuf, String)>

Resolve to a concrete (output_dir, session_id).

• auto_id is the fallback session name when session_name is unset.
• The resolved id = session_name.unwrap_or(auto_id).
• The resolved path = session_path (with SESSION token replaced by the resolved id) if set, else logs/<id>/.

Returns None only when the spec is empty and the caller should use defaults; otherwise Some with the resolved values.

pub fn needs_auto_id(&self) -> bool

true if the resolved path needs the auto-id (i.e. neither session_name nor a fully-concrete session_path is set). Used at startup to decide whether logs/latest can be wired immediately or must wait for session creation.

Trait Implementations

impl Clone for SessionDirSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionDirSpec

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

Formats the value using the given formatter.

impl Default for SessionDirSpec

fn default() -> Self

Returns the “default value” for a type.