I was swayed by the arguments about this made by the compiler team In <https://github.com/rust-lang/compiler-team/issues/750> and decided to look at how this organization affects ratatui. I found this reduces the number of lines across the codebase by about 350 and makes the imports more readable and definitely more greppable as you usually only have to read a single line. I've found in the past that maintaining imports regularly leads to merge conflicts which have to be resolved by hand and this change should reduce the likelihood of that happening. Main change is in rustfmt.toml, and the rest is just the result of running `cargo xtask format`. While implementing this, cargo machete brings up that the various backend crates are unused by the example crates. The re-export of each backend crate under ratatui is to make it possible for libs that rely on a specific version of ratatui to use the same version of the backend crate. Apps in general should use the backend crate directly rather than through ratatui as this is less confusing. - Removes all usages of `ratatui::{crossterm, termion, termwiz}`` in the examples. - Adds the backend crate to the dependencies of the examples that use the backend crate directly.
58 lines
1.8 KiB
Rust
58 lines
1.8 KiB
Rust
//! # [Ratatui] Original Demo example
|
|
//!
|
|
//! The latest version of this example is available in the [examples] folder in the repository.
|
|
//!
|
|
//! Please note that the examples are designed to be run against the `main` branch of the Github
|
|
//! repository. This means that you may not be able to compile with the latest release version on
|
|
//! crates.io, or the one that you have installed locally.
|
|
//!
|
|
//! See the [examples readme] for more information on finding examples that match the version of the
|
|
//! library you are using.
|
|
//!
|
|
//! [Ratatui]: https://github.com/ratatui/ratatui
|
|
//! [examples]: https://github.com/ratatui/ratatui/blob/main/examples
|
|
//! [examples readme]: https://github.com/ratatui/ratatui/blob/main/examples/README.md
|
|
|
|
use std::error::Error;
|
|
use std::time::Duration;
|
|
|
|
use clap::Parser;
|
|
|
|
mod app;
|
|
#[cfg(feature = "crossterm")]
|
|
mod crossterm;
|
|
#[cfg(all(not(windows), feature = "termion"))]
|
|
mod termion;
|
|
#[cfg(feature = "termwiz")]
|
|
mod termwiz;
|
|
|
|
mod ui;
|
|
|
|
/// Demo
|
|
#[derive(Debug, Parser)]
|
|
struct Cli {
|
|
/// time in ms between two ticks.
|
|
#[arg(short, long, default_value_t = 250)]
|
|
tick_rate: u64,
|
|
|
|
/// whether unicode symbols are used to improve the overall look of the app
|
|
#[arg(short, long, default_value_t = true)]
|
|
unicode: bool,
|
|
}
|
|
|
|
fn main() -> Result<(), Box<dyn Error>> {
|
|
let cli = Cli::parse();
|
|
let tick_rate = Duration::from_millis(cli.tick_rate);
|
|
#[cfg(feature = "crossterm")]
|
|
crate::crossterm::run(tick_rate, cli.unicode)?;
|
|
#[cfg(all(not(windows), feature = "termion", not(feature = "crossterm")))]
|
|
crate::termion::run(tick_rate, cli.unicode)?;
|
|
#[cfg(all(
|
|
feature = "termwiz",
|
|
not(feature = "crossterm"),
|
|
not(feature = "termion")
|
|
))]
|
|
crate::termwiz::run(tick_rate, cli.unicode)?;
|
|
Ok(())
|
|
}
|