Struct workflow_terminal::terminal::Terminal

pub struct Terminal {
    pub running: Arc<AtomicBool>,
    pub prompt: Arc<Mutex<String>>,
    pub term: Arc<Interface>,
    pub handler: Arc<dyn Cli>,
    pub terminate: Arc<AtomicBool>,
    pub pipe_raw: Channel<String>,
    pub pipe_crlf: Channel<String>,
    pub pipe_ctl: DuplexChannel<()>,
    /* private fields */
}

Terminal interface

Fields

running: Arc<AtomicBool>

prompt: Arc<Mutex<String>>

term: Arc<Interface>

handler: Arc<dyn Cli>

terminate: Arc<AtomicBool>

pipe_raw: Channel<String>

pipe_crlf: Channel<String>

pipe_ctl: DuplexChannel<()>

Implementations

impl Terminal

pub fn try_new(handler: Arc<dyn Cli>, prompt: &str) -> Result<Self>

Create a new default terminal instance bound to the supplied command-line processor Cli.

pub fn try_new_with_options( handler: Arc<dyn Cli>, options: Options ) -> Result<Self>

Create a new terminal instance bound to the supplied command-line processor Cli. Receives options::Options that allow terminal customization.

pub async fn init(self: &Arc<Self>) -> Result<()>

Init the terminal instance

pub fn inner(&self) -> LockResult<MutexGuard<'_, Inner>>

Access to the underlying terminal instance

pub fn history(&self) -> Vec<String>

Get terminal command line history list as Vec<String>

pub fn reset_line_buffer(&self)

pub fn get_prompt(&self) -> String

Get the current terminal prompt string

pub fn prompt(&self)

Render the current prompt in the terminal

pub fn crlf(&self)

Output CRLF sequence

pub fn write<S>(&self, s: S)where S: Into<String>,

Write a string

pub fn writeln<S>(&self, s: S)where S: Into<String>,

Write a string ending with CRLF sequence

pub fn term(&self) -> Arc<Interface>

Get a clone of Arc of the underlying terminal instance

pub async fn run(self: &Arc<Self>) -> Result<()>

Execute the async terminal processing loop. Once started, it should be stopped using Terminal::exit

pub async fn exit(self: &Arc<Self>)

Exits the async terminal processing loop (async fn)

pub fn abort(self: &Arc<Self>)

Exits the async terminal processing loop (sync fn)

pub async fn ask( self: &Arc<Terminal>, secure: bool, prompt: &str ) -> Result<String>

Ask a question (input a string until CRLF). secure argument suppresses echoing of the user input (useful for password entry)

pub fn inject(&self, text: String) -> Result<()>

Inject a string into the current cursor position

pub fn is_running(&self) -> bool

Indicates that the terminal has received command input and has not yet returned from the processing. This flag is set to true when delivering the user command to the Cli handler and is reset to false when the Cli handler returns.

pub fn update_theme(&self) -> Result<()>

Trait Implementations

impl Clone for Terminal

fn clone(&self) -> Terminal

Returns a copy of the value.

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

Performs copy-assignment from source.