aether-tui 0.1.8

A lightweight terminal UI rendering library for building rich CLI applications
Documentation 
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

use super::*;
use crossterm::event::KeyCode;
use tui::MultiSelect;

#[test]
fn renders_all_unchecked() {
    let mut ms = MultiSelect::new(sample_options(), vec![false, false, false]);
    let term = render_component(|ctx| ms.render(ctx), 80, 24);
    assert_buffer_eq(&term, &["[ ] Alpha", "[ ] Beta", "[ ] Gamma"]);
}

#[test]
fn renders_some_checked() {
    let mut ms = MultiSelect::new(sample_options(), vec![true, false, true]);
    let term = render_component(|ctx| ms.render(ctx), 80, 24);
    assert_buffer_eq(&term, &["[x] Alpha", "[ ] Beta", "[x] Gamma"]);
}

#[tokio::test]
async fn space_toggles_at_cursor() {
    let mut ms = MultiSelect::new(sample_options(), vec![false, false, false]);
    ms.on_event(&Event::Key(key(KeyCode::Char(' ')))).await;
    let term = render_component(|ctx| ms.render(ctx), 80, 24);
    assert_buffer_eq(&term, &["[x] Alpha", "[ ] Beta", "[ ] Gamma"]);
}

#[tokio::test]
async fn navigate_and_toggle_multiple() {
    let mut ms = MultiSelect::new(sample_options(), vec![false, false, false]);
    // Toggle Alpha (cursor=0)
    ms.on_event(&Event::Key(key(KeyCode::Char(' ')))).await;
    // Move to Beta, then Gamma
    ms.on_event(&Event::Key(key(KeyCode::Down))).await;
    ms.on_event(&Event::Key(key(KeyCode::Down))).await;
    // Toggle Gamma (cursor=2)
    ms.on_event(&Event::Key(key(KeyCode::Char(' ')))).await;
    let term = render_component(|ctx| ms.render(ctx), 80, 24);
    assert_buffer_eq(&term, &["[x] Alpha", "[ ] Beta", "[x] Gamma"]);
}

#[tokio::test]
async fn cursor_wraps_up_from_first() {
    let mut ms = MultiSelect::new(sample_options(), vec![false, false, false]);
    // Press Up from cursor=0, should wrap to cursor=2 (Gamma)
    ms.on_event(&Event::Key(key(KeyCode::Up))).await;
    assert_eq!(ms.cursor, 2);
    // Toggle at the new cursor position to verify it's on Gamma
    ms.on_event(&Event::Key(key(KeyCode::Char(' ')))).await;
    let term = render_component(|ctx| ms.render(ctx), 80, 24);
    assert_buffer_eq(&term, &["[ ] Alpha", "[ ] Beta", "[x] Gamma"]);
}

#[test]
fn unfocused_none_selected_shows_none() {
    let ms = MultiSelect::new(sample_options(), vec![false, false, false]);
    let ctx = ViewContext::new((80, 24));
    let rendered = ms.render_field(&ctx, false);
    assert_eq!(rendered.len(), 1, "Unfocused should render a single inline line");
    let term = render_lines(&rendered, 80, 24);
    let lines = term.get_lines();
    assert!(lines[0].contains("(none)"), "Expected '(none)' in unfocused render, got: '{}'", lines[0]);
}

#[test]
fn unfocused_with_selections_shows_summary() {
    let ms = MultiSelect::new(sample_options(), vec![true, false, true]);
    let ctx = ViewContext::new((80, 24));
    let rendered = ms.render_field(&ctx, false);
    assert_eq!(rendered.len(), 1, "Unfocused should render a single inline line");
    let term = render_lines(&rendered, 80, 24);
    let lines = term.get_lines();
    assert!(lines[0].contains("Alpha, Gamma"), "Expected 'Alpha, Gamma' in unfocused render, got: '{}'", lines[0]);
}