Struct ReplayHost 

pub struct ReplayHost { /* private fields */ }

A host that plays bytes back instead of running anything: for tests, demos and recordings. What it plays is given up front (output, exit) or later through a ReplayHandle, which also sees what the pane sent it.

use rich_embed::{ExitStatus, ReplayHost};

let host = ReplayHost::new().output("hello\r\n").exit(ExitStatus::with_code(0));
let handle = host.handle();
assert!(handle.written().is_empty());

Implementations

impl ReplayHost

pub fn new() -> ReplayHost

pub fn output(self, bytes: impl AsRef<[u8]>) -> ReplayHost

Play bytes as the program’s output once it starts.

pub fn exit(self, status: ExitStatus) -> ReplayHost

Exit with status once the output has played.

pub fn handle(&self) -> ReplayHandle

A handle to feed more output, end the program, and see what was sent to it. It may go to another thread.

Trait Implementations

impl Default for ReplayHost

fn default() -> Self

Returns the “default value” for a type.

impl PtyHost for ReplayHost

fn start(&mut self, columns: u16, rows: u16) -> Result<()>

Start the program on a screen columns x rows cells. Called once, when the pane is first laid out.

fn write(&mut self, bytes: &[u8]) -> Result<()>

Send bytes to the program, as if typed. A host may refuse with io::ErrorKind::WouldBlock while the program’s input is full (it is not reading it): nothing was sent, and the same bytes can be sent again later.

fn resize(&mut self, columns: u16, rows: u16) -> Result<()>

The pane is now columns x rows cells.

fn read(&mut self) -> Vec<u8>

The output that arrived since the last call; empty when there is none. Never blocks.

fn set_notify(&mut self, notify: Notify)

Call notify whenever output arrives or the program exits. Given once, before or after start; a host with something already waiting calls it at once.

fn exit_status(&mut self) -> Option<ExitStatus>

How the program ended, once it has, and once the output it wrote before that has been read.

fn kill(&mut self) -> Result<()>

End the program. Also called when the pane goes away.