Enum BackgroundTerminal 

pub enum BackgroundTerminal {
    Running {
        child: ChildHandle,
        output_buffer: Arc<Mutex<String>>,
        last_read_offset: Arc<AtomicUsize>,
    },
    Finished {
        status: TerminalExitStatus,
        final_output: String,
    },
}

Background terminal state

Variants

Running

Terminal is still running

Fields

child: ChildHandle

The child process handle (wrapped or unwrapped)

output_buffer: Arc<Mutex<String>>

Accumulated output buffer

last_read_offset: Arc<AtomicUsize>

Last read offset for incremental output Using AtomicUsize for lock-free atomic operations

Finished

Terminal has finished

Fields

status: TerminalExitStatus

Exit status

final_output: String

Final output

Implementations

impl BackgroundTerminal

pub fn new_running(child: ChildHandle) -> Self

Create a new running terminal with a child handle

pub fn new_running_unwrapped(child: Child) -> Self

Create a new running terminal from a legacy Child (unwrapped) Note: stdout/stderr should be taken before creating the handle

pub fn is_running(&self) -> bool

Check if terminal is still running

pub fn status_str(&self) -> &'static str

Get the status string

pub async fn get_incremental_output(&self) -> String

Get incremental output since last read

pub async fn append_output(&self, output: &str)

Append output to the buffer (for running terminals)

pub async fn get_all_output(&self) -> String

Get all output

pub async fn finish(self, status: TerminalExitStatus) -> Self

Transition to finished state

Trait Implementations

impl Debug for BackgroundTerminal

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

Formats the value using the given formatter.