Struct TestApp 

pub struct TestApp<C: Component> { /* private fields */ }

A test harness for Telex components.

Renders components to an in-memory buffer and provides methods for finding elements and simulating interactions.

Implementations

impl<C: Component> TestApp<C>

pub fn new(root: C) -> Self

Create a new test app with the given root component.

pub fn with_size(self, width: u16, height: u16) -> Self

Set the virtual terminal size.

pub fn render_to_string(&mut self) -> String

Render to a buffer and return the buffer contents as a string.

pub fn find_all_text(&self) -> Vec<String>

Find all text content in the view tree.

pub fn find_text(&self, needle: &str) -> Option<String>

Find text that contains the given substring.

pub fn has_text(&self, needle: &str) -> bool

Check if text containing the given substring exists.

pub fn find_all_buttons(&self) -> Vec<String>

Find all button labels in the view tree.

pub fn find_button(&self, label: &str) -> Option<String>

Find a button by its label.

pub fn focus_index(&self) -> usize

Get the current focus index.

pub fn focusable_count(&mut self) -> usize

Get the total number of focusable elements.

pub fn focus_next(&mut self)

Move focus to the next element.

pub fn focus_prev(&mut self)

Move focus to the previous element.

pub fn activate(&mut self)

Activate the currently focused element (press button, toggle checkbox).

pub fn press_button(&mut self, label: &str) -> bool

Press a button by its label.

Finds the button, focuses it, and activates it.

pub fn list_up(&mut self)

Move list selection up.

pub fn list_down(&mut self)

Move list selection down.

pub fn type_char(&mut self, c: char)

Type a character into the focused text input or text area.

pub fn type_str(&mut self, s: &str)

Type a string into the focused text input or text area.

pub fn backspace(&mut self)

Press backspace in the focused text input or text area.

pub fn enter(&mut self)

Press Enter in the focused text area (insert new line).

pub fn scroll_up(&mut self, amount: u16)

Scroll up in the focused scrollable.

pub fn scroll_down(&mut self, amount: u16)

Scroll down in the focused scrollable.

pub fn assert_visible(&mut self, needle: &str)

Assert that the given text is visible in the rendered output. Panics with a helpful message showing the rendered output if not found.

pub fn assert_not_visible(&mut self, needle: &str)

Assert that the given text is NOT visible in the rendered output. Panics with a helpful message if the text is found.

pub fn visible_items(&mut self, items: &[&str]) -> Vec<String>

Check which items from the given list are visible in the rendered output. Returns a Vec of the items that are visible.

pub fn rendered_lines(&mut self) -> Vec<String>

Get the rendered output as a Vec of lines.

pub fn find_line_containing(&mut self, needle: &str) -> Option<usize>

Find the line number (0-indexed) containing the given text. Returns None if not found.

pub fn viewport_height(&self) -> u16

Get the viewport height (visible area).

pub fn viewport_width(&self) -> u16

Get the viewport width (visible area).