Struct IntegrationTest 

pub struct IntegrationTest { /* private fields */ }

Integration test builder.

Example

let result = IntegrationTest::new()
    .await
    .with_buffer("hello world")
    .send_keys("dw")
    .run()
    .await;
result.assert_buffer_eq("world");

Implementations

impl IntegrationTest

pub async fn new() -> Self

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

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

Panics

Panics if server fails to spawn.

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

Create new test with extra modules loaded.

Spawns a server with the default modules plus the specified extra modules. Use this for testing functionality that requires modules not in the defaults bundle (e.g., textobjects).

Example

let result = IntegrationTest::with_modules(&["textobjects"])
    .await
    .with_buffer("hello world")
    .send_keys("diw")
    .run()
    .await;
result.assert_buffer_eq(" world");

Panics

Panics if server fails to spawn.

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

Create new test with custom environment variables.

Passes additional env vars to the server process. Useful for overriding XDG_DATA_HOME to provide test fixture data.

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_file(self, path: &str) -> Self

Load initial content from file.

Panics

Panics if file cannot be read.

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

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

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

Add key sequence to send.

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

Add delay after last key sequence.

pub async fn run(self) -> TestResult

Run test and return result.

Panics

Panics if any gRPC call fails.