ratatui-testlib 0.1.0

Integration testing library for terminal user interface applications with Sixel and Bevy 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
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

//! Error handling integration tests.

use term_test::{Result, TermTestError, TuiTestHarness};

#[test]
fn test_invalid_terminal_dimensions() {
    let result = TuiTestHarness::new(0, 24);
    assert!(result.is_err());

    let result = TuiTestHarness::new(80, 0);
    assert!(result.is_err());

    let result = TuiTestHarness::new(0, 0);
    assert!(result.is_err());
}

#[test]
fn test_invalid_resize_dimensions() -> Result<()> {
    let mut harness = TuiTestHarness::new(80, 24)?;

    let result = harness.resize(0, 24);
    assert!(result.is_err());
    assert!(matches!(
        result.unwrap_err(),
        TermTestError::InvalidDimensions { .. }
    ));

    let result = harness.resize(80, 0);
    assert!(result.is_err());

    Ok(())
}

#[test]
fn test_wait_exit_without_process() -> Result<()> {
    let mut harness = TuiTestHarness::new(80, 24)?;

    let result = harness.wait_exit();
    assert!(result.is_err());
    assert!(matches!(
        result.unwrap_err(),
        TermTestError::NoProcessRunning
    ));

    Ok(())
}

#[test]
fn test_spawn_invalid_command() -> Result<()> {
    let mut harness = TuiTestHarness::new(80, 24)?;
    let mut cmd = portable_pty::CommandBuilder::new("this-command-definitely-does-not-exist-123456");

    let result = harness.spawn(cmd);
    // Should fail with spawn error
    assert!(result.is_err());

    Ok(())
}

#[test]
fn test_timeout_error_contains_context() -> Result<()> {
    let err = TermTestError::Timeout { timeout_ms: 5000 };
    let msg = err.to_string();

    assert!(msg.contains("5000"));
    assert!(msg.to_lowercase().contains("timeout"));

    Ok(())
}

#[test]
fn test_spawn_failed_error_message() {
    let err = TermTestError::SpawnFailed("test error message".to_string());
    let msg = err.to_string();

    assert!(msg.contains("test error message"));
    assert!(msg.contains("Failed to spawn"));
}

#[test]
fn test_process_already_running_error() {
    let err = TermTestError::ProcessAlreadyRunning;
    let msg = err.to_string();

    assert!(msg.to_lowercase().contains("already"));
    assert!(msg.to_lowercase().contains("running"));
}

#[test]
fn test_error_conversions() {
    // Test I/O error conversion
    let io_err = std::io::Error::new(std::io::ErrorKind::NotFound, "file not found");
    let term_err: TermTestError = io_err.into();
    assert!(matches!(term_err, TermTestError::Io(_)));

    // Test anyhow error conversion
    let anyhow_err = anyhow::anyhow!("test error");
    let term_err: TermTestError = anyhow_err.into();
    assert!(matches!(term_err, TermTestError::Pty(_)));
}