rust-expect 0.1.0

Next-generation Expect-style terminal automation library for Rust
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

//! Screen buffer benchmarks.
#![allow(missing_docs)]

use std::hint::black_box;

#[allow(unused_imports)]
use criterion::{BenchmarkId, Criterion, criterion_group, criterion_main};

#[cfg(feature = "screen")]
mod screen_benches {
    use rust_expect::screen::{AnsiParser, ScreenBuffer, ScreenQueryExt};

    use super::{BenchmarkId, Criterion, black_box};

    /// Helper to write a string to the buffer character by character.
    fn write_str(buffer: &mut ScreenBuffer, s: &str) {
        for c in s.chars() {
            buffer.write_char(c);
        }
    }

    pub fn bench_screen_buffer_write(c: &mut Criterion) {
        let mut group = c.benchmark_group("screen_buffer_write");

        for size in &[(80, 24), (120, 40), (200, 50)] {
            group.bench_with_input(
                BenchmarkId::from_parameter(format!("{}x{}", size.0, size.1)),
                size,
                |b, &(cols, rows)| {
                    b.iter(|| {
                        let mut buffer = ScreenBuffer::new(rows, cols);
                        for _ in 0..rows {
                            for _ in 0..cols {
                                buffer.write_char('X');
                            }
                        }
                        black_box(buffer)
                    });
                },
            );
        }

        group.finish();
    }

    pub fn bench_screen_buffer_scroll(c: &mut Criterion) {
        let mut buffer = ScreenBuffer::new(24, 80);
        // Fill the buffer
        for _ in 0..24 * 80 {
            buffer.write_char('A');
        }

        c.bench_function("screen_buffer_scroll", |b| {
            b.iter(|| {
                let mut buf = buffer.clone();
                for _ in 0..10 {
                    buf.scroll_up(1);
                }
                black_box(buf)
            });
        });
    }

    pub fn bench_screen_query(c: &mut Criterion) {
        let mut buffer = ScreenBuffer::new(24, 80);
        buffer.goto(0, 0);
        write_str(&mut buffer, "Hello, World! This is a test.");
        buffer.goto(5, 0);
        write_str(&mut buffer, "needle");
        buffer.goto(23, 0);
        write_str(&mut buffer, "Last line with some text");

        c.bench_function("screen_query_find", |b| {
            b.iter(|| buffer.query().find(black_box("needle")));
        });

        c.bench_function("screen_query_contains", |b| {
            b.iter(|| buffer.query().contains(black_box("Last line")));
        });

        c.bench_function("screen_query_text", |b| {
            b.iter(|| buffer.query().text());
        });
    }

    pub fn bench_ansi_parser(c: &mut Criterion) {
        let mut group = c.benchmark_group("ansi_parser");

        // Simple text
        let simple_text = "Hello, World!";
        group.bench_function("simple_text", |b| {
            b.iter(|| {
                let mut parser = AnsiParser::new();
                for byte in simple_text.bytes() {
                    black_box(parser.parse(byte));
                }
            });
        });

        // Text with colors
        let colored_text = "\x1b[31mRed\x1b[0m \x1b[32mGreen\x1b[0m \x1b[34mBlue\x1b[0m";
        group.bench_function("colored_text", |b| {
            b.iter(|| {
                let mut parser = AnsiParser::new();
                for byte in colored_text.bytes() {
                    black_box(parser.parse(byte));
                }
            });
        });

        // Cursor movement
        let cursor_seq = "\x1b[10;20H\x1b[5A\x1b[3B\x1b[2C\x1b[4D";
        group.bench_function("cursor_movement", |b| {
            b.iter(|| {
                let mut parser = AnsiParser::new();
                for byte in cursor_seq.bytes() {
                    black_box(parser.parse(byte));
                }
            });
        });

        group.finish();
    }

    pub fn register_benches(c: &mut Criterion) {
        bench_screen_buffer_write(c);
        bench_screen_buffer_scroll(c);
        bench_screen_query(c);
        bench_ansi_parser(c);
    }
}

#[cfg(feature = "screen")]
criterion_group!(benches, screen_benches::register_benches);

#[cfg(not(feature = "screen"))]
fn dummy_bench(_c: &mut Criterion) {
    // No-op when screen feature is disabled
}

#[cfg(not(feature = "screen"))]
criterion_group!(benches, dummy_bench);

criterion_main!(benches);