Struct App 

pub struct App { /* private fields */ }

The main tanu CLI application.

App is the entry point for running tanu tests. It handles command-line argument parsing, configuration management, and test execution coordination.

Examples

Basic usage:

use tanu::{App, eyre};

#[tanu::main]
#[tokio::main]
async fn main() -> eyre::Result<()> {
    let runner = run();
    let app = App::new();
    app.run(runner).await?;
    Ok(())
}

With custom reporters:

use tanu::{App, eyre};

#[tanu::main]
#[tokio::main]
async fn main() -> eyre::Result<()> {
    let runner = run();
    let mut app = App::new();
    // app.install_reporter("custom", MyCustomReporter::new());
    app.run(runner).await?;
    Ok(())
}

Implementations

impl App

pub fn new() -> App

Creates a new tanu application instance.

This initializes the application with default settings and no custom reporters.

Examples

use tanu::App;

let app = App::new();

pub fn install_reporter( &mut self, name: impl Into<String>, reporter: impl Reporter + 'static + Send, )

Install a third-party reporter.

Custom reporters allow you to extend tanu’s output capabilities beyond the built-in list and table reporters. The reporter will be available via the --reporters command-line flag.

Arguments

• name - The name that will be used to reference this reporter from the command line
• reporter - A custom reporter implementation that implements the Reporter trait

Examples

use tanu::{App, reporter::Reporter};

struct MyReporter;
impl Reporter for MyReporter {
    // Implementation details...
}

let mut app = App::new();
app.install_reporter("custom", MyReporter);

pub async fn run(self, runner: Runner) -> Result<()>

Parse command-line arguments and run the tanu CLI.

This method is the main entry point for executing tanu tests. It parses command-line arguments, configures the test runner based on the provided options, and executes the appropriate subcommand (test, tui, or ls).

Arguments

• runner - A configured test runner containing all registered test functions

Returns

Returns Ok(()) on successful execution, or an error if something goes wrong during argument parsing, configuration loading, or test execution.

Supported Commands

• test - Run tests in CLI mode with various filtering and reporting options
• tui - Launch the interactive Terminal User Interface
• ls - List all available test cases

Examples

use tanu::{App, eyre};

#[tanu::main]
#[tokio::main]
async fn main() -> eyre::Result<()> {
    let runner = run();
    let app = App::new();
    app.run(runner).await
}

Trait Implementations

impl Default for App

fn default() -> App

Returns the “default value” for a type.