hefesto-widgets 0.6.1

Ratatui widgets for the Hefesto TUI toolkit: popups, scrollable lists, trees, text input and spinners
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
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

use std::collections::HashSet;

use super::*;
use crate::tree::TreeNode;
use insta::assert_snapshot;
use ratatui::{backend::TestBackend, Terminal};

fn render(name: &str, popup: TreePopup<'_>, state: &mut TreeState) {
    let backend = TestBackend::new(60, 20);
    let mut terminal = Terminal::new(backend).unwrap();
    terminal
        .draw(|f| f.render_stateful_widget(popup, f.area(), state))
        .unwrap();
    assert_snapshot!(name, terminal.backend());
}

fn sample_nodes() -> Vec<TreeNode<'static>> {
    vec![
        TreeNode {
            text: "src".into(),
            children: vec![
                TreeNode { text: "main.rs".into(), children: vec![], id: 2 },
                TreeNode { text: "lib.rs".into(), children: vec![], id: 3 },
            ],
            id: 1,
        },
        TreeNode {
            text: "Cargo.toml".into(),
            children: vec![],
            id: 4,
        },
    ]
}

// ── resolve_rect ──

#[test]
fn resolve_rect_delegates_to_popup() {
    let popup = TreePopup::new(sample_nodes())
        .width(PopupSize::Fixed(30))
        .height(PopupSize::Fixed(10));
    assert_eq!(popup.resolve_rect(Rect::new(0, 0, 100, 50)).width, 30);
    assert_eq!(popup.resolve_rect(Rect::new(0, 0, 100, 50)).height, 10);
}

#[test]
fn resolve_rect_clamps_when_larger_than_area() {
    let popup = TreePopup::new(sample_nodes())
        .width(PopupSize::Fixed(100))
        .height(PopupSize::Fixed(50));
    assert_eq!(
        popup.resolve_rect(Rect::new(0, 0, 60, 20)),
        Rect::new(0, 0, 60, 20)
    );
}

// ── snapshots ──

#[test]
fn snapshot_default() {
    let popup = TreePopup::new(sample_nodes());
    let mut state = TreeState::default();
    render("tree_popup_default", popup, &mut state);
}

#[test]
fn snapshot_with_title() {
    let popup = TreePopup::new(sample_nodes()).title("Project");
    let mut state = TreeState::default();
    render("tree_popup_with_title", popup, &mut state);
}

#[test]
fn snapshot_with_border_color() {
    let popup = TreePopup::new(sample_nodes())
        .title("Cyan border")
        .border_color(Color::Cyan);
    let mut state = TreeState::default();
    render("tree_popup_border_color", popup, &mut state);
}

#[test]
fn snapshot_with_width() {
    let popup = TreePopup::new(sample_nodes())
        .width(PopupSize::Fixed(40));
    let mut state = TreeState::default();
    render("tree_popup_with_width", popup, &mut state);
}

#[test]
fn snapshot_expanded() {
    let popup = TreePopup::new(sample_nodes()).title("Expanded");
    let mut state = TreeState { expanded: HashSet::from([1]), ..TreeState::default() };
    render("tree_popup_expanded", popup, &mut state);
}

#[test]
fn snapshot_with_origin() {
    let popup = TreePopup::new(sample_nodes())
        .origin(5, 5);
    let mut state = TreeState::default();
    render("tree_popup_with_origin", popup, &mut state);
}