Struct LocalExecutor 

pub struct LocalExecutor { /* private fields */ }

Executes commands directly on the host machine.

Carries an optional RYRA_REGISTRY_DIR override prepended to every command — bare-mode tests use this to point ryra at the in-repo registry/ checkout instead of cloning from GitHub on each run.

Implementations

impl LocalExecutor

pub fn with_registry(registry_path: &Path) -> Self

Construct a LocalExecutor that prepends RYRA_REGISTRY_DIR=<path> to every command, so ryra resolves the default registry to the local checkout under test.

pub fn with_config_dir(self, config_dir: &Path) -> Self

Also export RYRA_CONFIG_DIR=<path> on every command, isolating preferences.toml into a throwaway dir so host tests never read or clobber the user’s real SMTP/auth/backup credentials.

pub fn with_data_dir(self, data_dir: &Path) -> Self

Also export RYRA_DATA_DIR=<path> on every command, so test service deployments (data, .env, configs, and the quadlet files ryra writes into service_home) land in the sandbox instead of the user’s real ~/.local/share/services/.

Trait Implementations

impl Default for LocalExecutor

fn default() -> Self

LocalExecutor with no registry override — only useful when the commands run don’t touch ryra. Most callers want LocalExecutor::with_registry.

impl Executor for LocalExecutor

fn exec<'life0, 'life1, 'async_trait>( &'life0 self, cmd: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ExecOutput>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run a command and return its output. Fails if exit code != 0.

fn exec_streaming<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, cmd: &'life1 str, prefix: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<ExecOutput>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Run a command, streaming stdout/stderr to the terminal.

fn wait_for_service<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, unit: &'life1 str, timeout: Duration, prefix: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Wait for a systemd user service to become active. prefix is the line prefix for the wait’s progress heartbeat, so it aligns with surrounding test output (e.g. "[my-test] ").

fn fetch_dir<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _remote_path: &'life1 str, _local_path: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Copy a directory from the execution environment to the host. No-op for local execution (files are already on the host).

fn playwright_out_dir(&self, test_name: &str) -> String

Directory, in this executor’s environment, where a browser step’s Playwright HTML report should be written. The runner points Playwright here and then [fetch_dir]s it into the host’s canonical reports dir. For local execution the two are the same path (so the fetch is a no-op); for a VM it’s a VM-internal staging path that gets copied out.