Skip to main content

Executor

ryra_test::executor

Trait Executor 

Source 
pub trait Executor: Send + Sync {
    // Required methods
    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;
    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;
    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;
    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;
    fn playwright_out_dir(&self, test_name: &str) -> String;
}
Expand description

Abstraction over where commands run — VM (SSH) or local host.

Required Methods§

Source

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.

Source

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.

Source

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] ").

Source

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).

Source

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.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§