testty 0.11.1

Rust-native TUI end-to-end testing framework using PTY-driven semantic assertions, native frame rendering, and VHS-driven GIF capture.
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

//! Showcase: Frame diffing engine for detecting terminal state changes.
//!
//! Demonstrates computing cell-level diffs between terminal frames,
//! extracting changed regions, and generating human-readable summaries.
//! The diff engine powers automatic change detection in proof reports.
//!
//! Run with: `cargo run --example frame_diffing -p testty`

#![allow(clippy::print_stdout)]

use testty::diff::{CellChange, FrameDiff};
use testty::frame::TerminalFrame;

fn main() {
    println!("=== Testty Frame Diffing Showcase ===\n");

    // --- Example 1: Identical frames ---
    println!("--- Example 1: Identical Frames ---");
    let frame_a = TerminalFrame::new(40, 5, b"Hello, World!\nStatus: OK");
    let frame_b = TerminalFrame::new(40, 5, b"Hello, World!\nStatus: OK");
    let diff = FrameDiff::compute(&frame_a, &frame_b);

    println!("  Identical: {}", diff.is_identical());
    println!("  Summary: {:?}", diff.summary());
    println!();

    // --- Example 2: Text content change ---
    println!("--- Example 2: Text Content Change ---");
    let before = TerminalFrame::new(40, 5, b"Counter: 0\nStatus: idle");
    let after = TerminalFrame::new(40, 5, b"Counter: 42\nStatus: running");
    let diff = FrameDiff::compute(&before, &after);

    println!("  Identical: {}", diff.is_identical());
    println!("  Summary: {:?}", diff.summary());

    let regions = diff.changed_regions();
    println!("  Changed regions: {}", regions.len());
    for region in &regions {
        println!(
            "    Row {}, cols {}..{}: {:?}",
            region.region.row,
            region.region.col,
            region.region.col + region.region.width,
            region.change_type,
        );
    }
    println!();

    // --- Example 3: Multi-line update simulating a dashboard refresh ---
    println!("--- Example 3: Dashboard Refresh ---");
    let dashboard_before = TerminalFrame::new(
        50,
        6,
        b"Dashboard\n  CPU: 23%\n  Mem: 512 MB\n  Disk: 45%\n  Net: 1.2 Mbps\nLast update: 10:30",
    );
    let dashboard_after = TerminalFrame::new(
        50,
        6,
        b"Dashboard\n  CPU: 67%\n  Mem: 1.1 GB\n  Disk: 45%\n  Net: 3.4 Mbps\nLast update: 10:31",
    );
    let diff = FrameDiff::compute(&dashboard_before, &dashboard_after);

    println!("  Summary: {:?}", diff.summary());

    let regions = diff.changed_regions();
    println!("  Changed regions: {}", regions.len());
    for region in &regions {
        println!(
            "    Row {}, cols {}..{}: {:?}",
            region.region.row,
            region.region.col,
            region.region.col + region.region.width,
            region.change_type,
        );
    }
    println!();

    // --- Example 4: Per-cell inspection ---
    println!("--- Example 4: Per-Cell Inspection ---");
    let line_before = TerminalFrame::new(10, 1, b"ABCDE");
    let line_after = TerminalFrame::new(10, 1, b"AbCdE");
    let diff = FrameDiff::compute(&line_before, &line_after);

    print!("  Cell changes: ");
    for col in 0..5 {
        let change = diff.cell_change(0, col);
        let marker = match change {
            Some(CellChange::Unchanged) | None => '.',
            Some(CellChange::TextChanged) => 'T',
            Some(CellChange::StyleChanged) => 'S',
            Some(CellChange::BothChanged) => 'B',
        };
        print!("{marker}");
    }
    println!("  (. = unchanged, T = text changed)");

    println!("\n=== Frame diffing showcase complete! ===");
}