Struct minus::Pager

pub struct Pager { /* fields omitted */ }

A struct containing basic configurations for the pager. This is used by all initializing functions

Example

You can use any async runtime, but we are taking the example of tokio

 #[tokio::main]
 async fn main() -> Result<(), Box<dyn std::error::Error>> {
     use minus::{Pager, LineNumbers, tokio_updating};
     let mut pager = Pager::new().unwrap();
     pager.set_line_numbers(LineNumbers::AlwaysOn);
     pager.set_prompt("A complex configuration");

     // Normally, you would use `futures::join` to join the pager and the text
     // updating function. We are doing this here to make the example simple
     tokio_updating(pager.finish()).await?;
     Ok(())
 }

For static output

 fn main() -> Result<(), Box<dyn std::error::Error>> {
      let mut pager = minus::Pager::new().unwrap();
      pager.set_text("Hello");
      pager.set_prompt("Example");
      minus::page_all(pager)?;
      Ok(())
 }

Implementations

impl Pager

pub fn new() -> Result<Self, AlternateScreenPagingError>

Initialize a new pager configuration

Errors

This function will return an error if it cannot determine the terminal size

Example

let pager = minus::Pager::new().unwrap();

pub fn set_text(&mut self, text: impl Into<String>)

Set the output text to this t

Note that unlike Pager::push_str, this replaces the original text. If you want to append text, use the Pager::push_str function

Example

let mut pager = minus::Pager::new().unwrap();
pager.set_text("This is a line");

pub fn set_line_numbers(&mut self, l: LineNumbers)

Set line number to this setting

Example

use minus::{Pager, LineNumbers};

let mut pager = Pager::new().unwrap();
pager.set_line_numbers(LineNumbers::Enabled);

pub fn set_prompt(&mut self, t: impl Into<String>)

Set the prompt displayed at the prompt to t

Example

use minus::Pager;

let mut pager = Pager::new().unwrap();
pager.set_prompt("my awesome program");

pub fn finish(self) -> PagerMutex

This is supported on crate features tokio_lib or async_std_lib only.

Return a PagerMutex from this Pager. This is gated on tokio_lib or async_std_lib feature

Example

use minus::Pager;

let mut pager = Pager::new().unwrap();
pager.set_text("This output is paged");
let _pager_mutex = pager.finish();

pub fn set_exit_strategy(&mut self, strategy: ExitStrategy)

Set the default exit strategy.

This controls how the pager will behave when the user presses q or Ctrl+C. See ExitStrategy for available options

use minus::{Pager, ExitStrategy};

let mut pager = Pager::new().unwrap();
pager.set_exit_strategy(ExitStrategy::ProcessQuit);

pub fn set_run_no_overflow(&mut self, value: bool)

Set whether to display pager if there’s less data than available screen height

By default this is set to false

use minus::Pager;

let mut pager = Pager::new().unwrap();
pager.set_run_no_overflow(true);

pub fn push_str(&mut self, text: impl Into<String>)

Appends text to the pager output

This function will automatically split the lines, if they overflow the number of terminal columns

let mut pager = minus::Pager::new().unwrap();
pager.push_str("This is some text");

pub fn end_data_stream(&mut self)

Hints the running pager that no more data is coming

Example

use minus::Pager;

let mut pager = Pager::new().unwrap();
pager.set_text("Hello from minus!");
pager.end_data_stream();

pub fn set_input_handler(
    &mut self,
    handler: Box<dyn InputHandler + Send + Sync>
)

Set custom input handler function

See example in InputHandler on using this function

pub fn add_exit_callback(&mut self, cb: impl FnMut() + Send + Sync + 'static)

Example

use minus::Pager;

fn hello() {
    println!("Hello");
}

let mut pager = Pager::new().unwrap();
pager.add_exit_callback(Box::new(hello));

Trait Implementations

impl Default for Pager

fn default() -> Self

Returns the “default value” for a type.

impl Write for Pager

fn write_str(&mut self, string: &str) -> Result

Writes a string slice into this writer, returning whether the write succeeded.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a char into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the write! macro with implementors of this trait.