//! # [Ratatui] Sparkline 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-org/ratatui //! [examples]: https://github.com/ratatui-org/ratatui/blob/main/examples //! [examples readme]: https://github.com/ratatui-org/ratatui/blob/main/examples/README.md use std::{ error::Error, io, time::{Duration, Instant}, }; use rand::{ distributions::{Distribution, Uniform}, rngs::ThreadRng, }; use ratatui::{ backend::{Backend, CrosstermBackend}, crossterm::{ event::{self, DisableMouseCapture, EnableMouseCapture, Event, KeyCode}, execute, terminal::{disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen}, }, layout::{Constraint, Layout}, style::{Color, Style}, widgets::{Block, Borders, Sparkline}, Frame, Terminal, }; #[derive(Clone)] struct RandomSignal { distribution: Uniform, rng: ThreadRng, } impl RandomSignal { fn new(lower: u64, upper: u64) -> Self { Self { distribution: Uniform::new(lower, upper), rng: rand::thread_rng(), } } } impl Iterator for RandomSignal { type Item = u64; fn next(&mut self) -> Option { Some(self.distribution.sample(&mut self.rng)) } } struct App { signal: RandomSignal, data1: Vec, data2: Vec, data3: Vec, } impl App { fn new() -> Self { let mut signal = RandomSignal::new(0, 100); let data1 = signal.by_ref().take(200).collect::>(); let data2 = signal.by_ref().take(200).collect::>(); let data3 = signal.by_ref().take(200).collect::>(); Self { signal, data1, data2, data3, } } fn on_tick(&mut self) { let value = self.signal.next().unwrap(); self.data1.pop(); self.data1.insert(0, value); let value = self.signal.next().unwrap(); self.data2.pop(); self.data2.insert(0, value); let value = self.signal.next().unwrap(); self.data3.pop(); self.data3.insert(0, value); } } fn main() -> Result<(), Box> { // setup terminal enable_raw_mode()?; let mut stdout = io::stdout(); execute!(stdout, EnterAlternateScreen, EnableMouseCapture)?; let backend = CrosstermBackend::new(stdout); let mut terminal = Terminal::new(backend)?; // create app and run it let tick_rate = Duration::from_millis(250); let app = App::new(); let res = run_app(&mut terminal, app, tick_rate); // restore terminal disable_raw_mode()?; execute!( terminal.backend_mut(), LeaveAlternateScreen, DisableMouseCapture )?; terminal.show_cursor()?; if let Err(err) = res { println!("{err:?}"); } Ok(()) } fn run_app( terminal: &mut Terminal, mut app: App, tick_rate: Duration, ) -> io::Result<()> { let mut last_tick = Instant::now(); loop { terminal.draw(|f| ui(f, &app))?; let timeout = tick_rate.saturating_sub(last_tick.elapsed()); if crossterm::event::poll(timeout)? { if let Event::Key(key) = event::read()? { if key.code == KeyCode::Char('q') { return Ok(()); } } } if last_tick.elapsed() >= tick_rate { app.on_tick(); last_tick = Instant::now(); } } } fn ui(f: &mut Frame, app: &App) { let chunks = Layout::vertical([ Constraint::Length(3), Constraint::Length(3), Constraint::Min(0), ]) .split(f.size()); let sparkline = Sparkline::default() .block( Block::new() .borders(Borders::LEFT | Borders::RIGHT) .title("Data1"), ) .data(&app.data1) .style(Style::default().fg(Color::Yellow)); f.render_widget(sparkline, chunks[0]); let sparkline = Sparkline::default() .block( Block::new() .borders(Borders::LEFT | Borders::RIGHT) .title("Data2"), ) .data(&app.data2) .style(Style::default().bg(Color::Green)); f.render_widget(sparkline, chunks[1]); // Multiline let sparkline = Sparkline::default() .block( Block::new() .borders(Borders::LEFT | Borders::RIGHT) .title("Data3"), ) .data(&app.data3) .style(Style::default().fg(Color::Red)); f.render_widget(sparkline, chunks[2]); }