Struct ProgramEngine 

pub struct ProgramEngine { /* private fields */ }

A terminal browser, named by the app, run in a terminal pane: its screen is the page. Nothing of ours ships with it, and nothing is downloaded; install the browser you want.

The browser is started with the address as its last argument. An address that starts with -, or has a control character in it, is refused (open fails), so that it is never read as one of the browser’s options. Its own keys work as they do in a terminal (following links, its own history). The view’s back, forward and reload restart it at an address from the engine’s own history of what was opened; the address shown is the last one opened, since a terminal browser does not say where its links led.

Implementations

impl ProgramEngine

pub fn new(program: impl Into<OsString>) -> ProgramEngine

Run program with the address as its argument.

pub fn args<I: IntoIterator<Item = S>, S: Into<OsString>>( self, args: I, ) -> ProgramEngine

Arguments before the address.

pub fn detect() -> ProgramEngine

The browser in BROWSER_VARIABLE, else the first of KNOWN_BROWSERS on PATH. With none, the view says so.

pub fn with_hosts( hosts: impl FnMut(&str) -> Box<dyn PtyHost> + 'static, ) -> ProgramEngine

Run each page in a host hosts makes from its address, instead of a local program: a browser on another machine, or a test.

Trait Implementations

impl WebEngine for ProgramEngine

fn open(&mut self, url: &str) -> Result<()>

Go to url.

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

The page’s area is now columns x rows cells.

fn input(&mut self, input: WebInput) -> Result<()>

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

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

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

fn poll(&mut self) -> Option<WebFrame>

The newest frame since the last call, if there is one.

fn state(&self) -> PageState

Where the page is and what it is doing now.

fn set_notify(&mut self, notify: Notify)

Call notify when there is a new frame or state. Given once.