Enum SessionState 

pub enum SessionState {
    Created,
    Active,
    Idle,
    Terminated,
}

Represents the lifecycle state of a shell session.

Variants

Created

Session has been created but not yet activated.

Active

Session is actively processing commands.

Idle

Session is idle, waiting for commands.

Terminated

Session has been terminated and cannot be reused.

Implementations

impl SessionState

pub fn can_transition_to(&self, target: SessionState) -> bool

Check if transition to target state is valid.

Valid transitions:

• Created -> Active
• Created -> Idle (session created and immediately ready for commands)
• Active -> Idle
• Active -> Terminated
• Idle -> Active
• Idle -> Terminated

Note: Created -> Idle exists because a freshly created session holds no persistent PTY (each command spawns its own), so it is ready to accept commands the moment it is created. This keeps the create→execute flow working out-of-the-box without the consumer having to drive an explicit activation step (thin-API principle).

pub fn transition_to(&mut self, target: SessionState) -> Result<()>

Attempt to transition to a new state.

Returns Ok(()) if the transition is valid, or an error otherwise.

pub fn is_terminal(&self) -> bool

Check if this is a terminal state (no further transitions possible).

pub fn can_execute(&self) -> bool

Check if session can accept commands.

Trait Implementations

impl Clone for SessionState

fn clone(&self) -> SessionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SessionState

impl Debug for SessionState

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

Formats the value using the given formatter.

impl Default for SessionState

fn default() -> SessionState

Returns the “default value” for a type.

impl Eq for SessionState

impl PartialEq for SessionState

fn eq(&self, other: &SessionState) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SessionState