Tuviv

Tuviv is a library for building terminal user interfaces (TUIs) with rust with a heavy focus on layout. Tuviv does not come with as many widgets as, say, tui-rs, but rather contains many more widgets based on layout: specifically a Flexbox, and a Grid, along with others.

The purpose of this library is to significantly ease creating layouts, which is mildly clunky with tui-rs: such as the fact that you cannot center text vertically (#396) - but also wider-scale things - such as the lack of a flexbox or a grid.

Features

• crossterm, termion - different backends. crossterm is enabled by default and is strongly recommended.
• textwrap - allows for the Paragraph widget. Is enabled by default. (please note if you don't include this you will have to reimplement something to render text)

Examples

Create a Buffer And Render a Widget

```rust // Imports use std::io; use std::time::Duration;

use tuviv::{ le::Orientation, prelude::*, widgets::{Filler, Flexbox}, };

fn main() -> io::Result<()> { // Create a flexbox // With coloured squares let flexbox = Flexbox::new(Orientation::Horizontal, false) .child( Filler::new(" ".styled().bgred()) .fixedsize(16, 8) .centered() .toflexchild() .expand(1), ) .child( Flexbox::new(Orientation::Vertical, false) .child( Filler::new(" ".styled().bgyellow()) .fixedsize(16, 8) .centered() .toflexchild() .expand(1), ) .child( Filler::new(" ".styled().bggreen()) .fixedsize(16, 8) .centered() .toflexchild() .expand(1), ) .toflexchild() .expand(1), );

// Render a single frame.
//
// Look at `tuviv::run_app` for a better way of doing this
// for real applications
tuviv::render_frame(&*flexbox, Duration::from_secs(2))?;

Ok(())

} ```

Create More Complicated Widget Trees

Tuviv uses a builder pattern so complicated widgets can be created easily:

```rust use tuviv::prelude::*;

// Create a grid with progressbars: // // ╭───────────────╮ // │CPU █▌────────│ // │MEM ███▌──────│ // │GPU ─────CO o │ // ╰───────────────╯ let grid = Grid::new() .templaterows(vec![Sizing::Auto; 3]) .templatecolumns(vec![Sizing::Auto, Sizing::AutoFixed(10)]) .columngap(2) .autochild(Paragraph::new("CPU".styled())) .autochild( ProgressBar::new() .total(100.0) .value(10.0) .aligny(Alignment::Center), ) .autochild(Paragraph::new("MEM".styled())) .autochild( ProgressBar::new() .total(8.0) .value(2.4) .aligny(Alignment::Center), ) .autochild(Paragraph::new("GPU".styled())) .autochild( ProgressBar::new() .total(15.0) .value(8.0) .fg(vec!["─".styled().bold()]) .edge("C".styled().yellow().bold()) .bg(vec!["O o ".styled()]) .aligny(Alignment::Center), ) .toboxsizing() .border(Border::ROUNDED) .centered(); ```