Struct StepTest 

pub struct StepTest { /* private fields */ }

Step-by-step test builder.

Example

let trace = StepTest::new()
    .await
    .with_buffer("line 1\nline 2\nline 3")
    .step("d")
        .expect_mode_contains("DELETE")
    .step("j")
        .expect_buffer("line 3")
        .expect_cursor(0, 0)
    .run()
    .await;
trace.print_trace();

Implementations

impl StepTest

pub async fn new() -> Self

Create new step test with automatic log capture (spawns server).

Server logs are captured to tmp/test-logs/{test_name}_{timestamp}.log. This is invaluable for debugging step-by-step test failures.

Panics

Panics if server fails to spawn.

pub async fn with_modules(modules: &[&str]) -> Self

Create new step test with extra modules loaded.

See super::IntegrationTest::with_modules for details.

Panics

Panics if server fails to spawn.

pub async fn with_env(env_vars: &[(&str, &str)]) -> Self

Create new step test with custom environment variables.

See super::IntegrationTest::with_env for details.

Panics

Panics if server fails to spawn.

pub fn log_path(&self) -> Option<&Path>

Get the path to the server log file for debugging.

Returns None if log capture is not enabled.

pub fn with_buffer(self, content: &str) -> Self

Set initial buffer content.

pub fn with_cursor_at(self, line: u16, col: u16) -> Self

Set initial cursor position (line, col) - 0-indexed.

pub fn with_delay(self, ms: u64) -> Self

Set default delay between steps (ms).

pub fn step(self, keys: &str) -> Self

Add a step (key to send).

pub fn expect_cursor(self, line: u16, col: u16) -> Self

Add cursor expectation to last step.

pub fn expect_buffer(self, expected: &str) -> Self

Add buffer content expectation to last step.

pub fn expect_buffer_contains(self, substring: &str) -> Self

Add buffer contains expectation to last step.

pub fn expect_mode_contains(self, substring: &str) -> Self

Add mode contains expectation to last step.

pub fn expect_edit_mode(self, mode: &str) -> Self

Add exact edit mode expectation to last step.

pub fn expect_register(self, reg: &str, content: &str, yank_type: &str) -> Self

Add register expectation to last step.

pub async fn run(self) -> StepTrace

Run the test and return trace.

Panics

Panics if any step expectation fails.