Struct DefaultFramework 

pub struct DefaultFramework { /* private fields */ }

Test framework using custom shell commands.

Provides maximum flexibility by delegating test discovery and execution to user-defined shell commands. Suitable for any test framework.

Configuration

See DefaultFrameworkConfig for available options including:

• discover_command: Shell command that outputs test IDs
• run_command: Command template with {tests} placeholder
• result_file: Optional JUnit XML path for detailed results
• working_dir: Directory for running commands

Implementations

impl DefaultFramework

pub fn new(config: DefaultFrameworkConfig) -> Self

Creates a new default framework with the given configuration.

Example

use offload::framework::default::DefaultFramework;
use offload::config::DefaultFrameworkConfig;

let framework = DefaultFramework::new(DefaultFrameworkConfig {
    discover_command: "find tests -name '*.test.js' -exec basename {} \\;".into(),
    run_command: "jest {tests}".into(),
    result_file: Some("junit.xml".into()),
    working_dir: None,
});

Trait Implementations

impl TestFramework for DefaultFramework

fn parse_results( &self, output: &ExecResult, result_file: Option<&str>, ) -> FrameworkResult<Vec<TestResult>>

Parse test results from execution output.

Result Sources (in order of preference)

1. JUnit XML (result_file): Provides per-test results with timing and error details. This is the recommended approach for accurate test tracking.

2. Exit code fallback: If no JUnit XML is available, returns a single aggregate result based on the command’s exit code. This means:

   • Individual test pass/fail status is lost
   • All tests are reported under a synthetic “all_tests” ID
   • Flaky test detection won’t work correctly

Recommendation

Always configure result_file pointing to JUnit XML output for accurate results. Most test frameworks support JUnit XML output:

• Jest: --reporters=jest-junit
• Go: go-junit-report
• pytest: --junitxml=results.xml

fn discover<'life0, 'life1, 'async_trait>( &'life0 self, _paths: &'life1 [PathBuf], ) -> Pin<Box<dyn Future<Output = FrameworkResult<Vec<TestRecord>>> + Send + 'async_trait>>

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

Discovers tests in the given paths.

fn produce_test_execution_command(&self, tests: &[TestInstance<'_>]) -> Command

Generates a command to run the specified tests.