envision 0.16.0

A ratatui framework for collaborative TUI development with headless testing support
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

use super::*;
use crate::component::RenderContext;
use crate::component::test_utils;

/// Router is a state-only component with no visual output.
/// These tests verify that `Router::view()` is a no-op and
/// does not panic on various state configurations.

#[derive(Clone, Debug, Default, PartialEq, Eq)]
enum Screen {
    #[default]
    Home,
    Settings,
    Profile,
}

// =============================================================================
// Snapshot tests (Router view is a no-op, so these verify no-panic rendering)
// =============================================================================

#[test]
fn test_snapshot_initial_screen() {
    let state = RouterState::new(Screen::Home);
    let (mut terminal, theme) = test_utils::setup_render(40, 10);
    terminal
        .draw(|frame| {
            Router::view(&state, &mut RenderContext::new(frame, frame.area(), &theme));
        })
        .unwrap();
    // Router renders nothing -- the output should be blank
    insta::assert_snapshot!(terminal.backend().to_string());
}

#[test]
fn test_snapshot_after_navigation() {
    let mut state = RouterState::new(Screen::Home);
    Router::update(&mut state, RouterMessage::Navigate(Screen::Settings));
    Router::update(&mut state, RouterMessage::Navigate(Screen::Profile));
    assert_eq!(state.current(), &Screen::Profile);
    assert_eq!(state.history_len(), 2);

    let (mut terminal, theme) = test_utils::setup_render(40, 10);
    terminal
        .draw(|frame| {
            Router::view(&state, &mut RenderContext::new(frame, frame.area(), &theme));
        })
        .unwrap();
    // Router renders nothing -- the output should be blank
    insta::assert_snapshot!(terminal.backend().to_string());
}

#[test]
fn test_snapshot_after_back() {
    let mut state = RouterState::new(Screen::Home);
    Router::update(&mut state, RouterMessage::Navigate(Screen::Settings));
    Router::update(&mut state, RouterMessage::Back);
    assert_eq!(state.current(), &Screen::Home);

    let (mut terminal, theme) = test_utils::setup_render(40, 10);
    terminal
        .draw(|frame| {
            Router::view(&state, &mut RenderContext::new(frame, frame.area(), &theme));
        })
        .unwrap();
    insta::assert_snapshot!(terminal.backend().to_string());
}