file_test_runner 0.12.1

File-based test runner for running tests found in files.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

// Copyright 2018-2025 the Deno authors. MIT license.

pub mod collection;
pub mod reporter;
mod runner;

use collection::CollectedTest;
pub use runner::*;

use std::path::Path;
use std::path::PathBuf;

use collection::CollectOptions;
use collection::collect_tests_or_exit;
use thiserror::Error;

#[derive(Debug, Error)]
#[error("{:#} ({})", err, path.display())]
pub struct PathedIoError {
  path: PathBuf,
  err: std::io::Error,
}

impl PathedIoError {
  pub fn new(path: &Path, err: std::io::Error) -> Self {
    Self {
      path: path.to_path_buf(),
      err,
    }
  }
}

/// Helper function to collect and run the tests.
pub fn collect_and_run_tests<TData: Clone + Send + 'static>(
  collect_options: CollectOptions<TData>,
  run_options: RunOptions<TData>,
  run_test: impl (Fn(&CollectedTest<TData>) -> TestResult) + Send + Sync + 'static,
) {
  let category = collect_tests_or_exit(collect_options);
  run_tests(&category, run_options, run_test)
}

/// Gets if a `--no-capture` or `--nocapture` flag was provided to the cli args.
pub static NO_CAPTURE: std::sync::LazyLock<bool> =
  std::sync::LazyLock::new(|| {
    std::env::args().any(|arg| arg == "--no-capture" || arg == "--nocapture")
  });