1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
|
/// Extension trait for the `Cursive` root to simplify initialization.
///
/// It brings backend-specific methods to initialize a `Cursive` root.
///
/// # Examples
///
/// ```rust,no_run
/// use cursive::{Cursive, CursiveExt};
///
/// let mut siv = Cursive::new();
///
/// // Use `CursiveExt::run()` to pick one of the enabled backends,
/// // depending on cargo features.
/// siv.run();
///
/// // Or explicitly use a specific backend
/// #[cfg(feature = "ncurses-backend")]
/// siv.run_ncurses().unwrap();
/// #[cfg(feature = "panncurses-backend")]
/// siv.run_pancurses().unwrap();
/// #[cfg(feature = "termion-backend")]
/// siv.run_termion().unwrap();
/// #[cfg(feature = "crossterm-backend")]
/// siv.run_crossterm().unwrap();
/// #[cfg(feature = "blt-backend")]
/// siv.run_blt();
/// ```
pub trait CursiveExt {
/// Tries to use one of the enabled backends.
///
/// Will fallback to the dummy backend if no other backend feature is enabled.
///
/// # Panics
///
/// If the backend initialization fails.
fn run(&mut self);
/// Creates a new Cursive root using a ncurses backend.
#[cfg(feature = "ncurses-backend")]
fn run_ncurses(&mut self) -> std::io::Result<()>;
/// Creates a new Cursive root using a pancurses backend.
#[cfg(feature = "pancurses-backend")]
fn run_pancurses(&mut self) -> std::io::Result<()>;
/// Creates a new Cursive root using a termion backend.
#[cfg(feature = "termion-backend")]
fn run_termion(&mut self) -> std::io::Result<()>;
/// Creates a new Cursive root using a crossterm backend.
#[cfg(feature = "crossterm-backend")]
fn run_crossterm(&mut self) -> Result<(), crossterm::ErrorKind>;
/// Creates a new Cursive root using a bear-lib-terminal backend.
#[cfg(feature = "blt-backend")]
fn run_blt(&mut self);
}
impl CursiveExt for cursive_core::Cursive {
fn run(&mut self) {
cfg_if::cfg_if! {
if #[cfg(feature = "blt-backend")] {
self.run_blt()
} else if #[cfg(feature = "termion-backend")] {
self.run_termion().unwrap()
} else if #[cfg(feature = "crossterm-backend")] {
self.run_crossterm().unwrap()
} else if #[cfg(feature = "pancurses-backend")] {
self.run_pancurses().unwrap()
} else if #[cfg(feature = "ncurses-backend")] {
self.run_ncurses().unwrap()
} else {
log::warn!("No built-it backend, falling back to Cursive::dummy().");
self.run_dummy()
}
}
}
#[cfg(feature = "ncurses-backend")]
fn run_ncurses(&mut self) -> std::io::Result<()> {
self.try_run_with(crate::backends::curses::n::Backend::init)
}
#[cfg(feature = "pancurses-backend")]
fn run_pancurses(&mut self) -> std::io::Result<()> {
self.try_run_with(crate::backends::curses::pan::Backend::init)
}
#[cfg(feature = "termion-backend")]
fn run_termion(&mut self) -> std::io::Result<()> {
self.try_run_with(crate::backends::termion::Backend::init)
}
#[cfg(feature = "crossterm-backend")]
fn run_crossterm(&mut self) -> Result<(), crossterm::ErrorKind> {
self.try_run_with(crate::backends::crossterm::Backend::init)
}
#[cfg(feature = "blt-backend")]
fn run_blt(&mut self) {
self.run_with(crate::backends::blt::Backend::init)
}
}
|