standout 9.0.0

Styled CLI template rendering with automatic terminal detection
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

use clap::{ArgMatches, CommandFactory, Parser, Subcommand};
use serde::Serialize;
use standout::cli::FnHandler;
use standout::cli::{App, CommandContext, Dispatch, HandlerResult, Output};
use standout::{embed_styles, embed_templates};
use standout_test::{serial, TestHarness};

#[derive(Parser)]
#[command(name = "app")]
struct Cli {
    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand, Dispatch)]
#[dispatch(handlers = handlers)]
enum Commands {
    List,
}

#[derive(Serialize)]
struct TodoResult {
    name: String,
    todos: Vec<String>,
}

mod handlers {
    use super::*;

    pub fn list(_matches: &ArgMatches, _ctx: &CommandContext) -> HandlerResult<TodoResult> {
        Ok(Output::Render(TodoResult {
            name: "Ada".to_string(),
            todos: vec!["one".to_string()],
        }))
    }
}

fn list_handler(_matches: &ArgMatches, _ctx: &CommandContext) -> HandlerResult<TodoResult> {
    Ok(Output::Render(TodoResult {
        name: "Ada".to_string(),
        todos: vec!["one".to_string()],
    }))
}

#[test]
#[serial]
fn readme_and_index_builder_order_builds_and_runs() -> Result<(), Box<dyn std::error::Error>> {
    let app = App::builder()
        .templates(embed_templates!("tests/fixtures/templates"))
        .styles(embed_styles!("tests/fixtures/styles"))
        .default_theme("default")
        .commands(Commands::dispatch_config())?
        .build()?;

    let result = TestHarness::new()
        .text_output()
        .run(&app, Cli::command(), ["app", "list"]);

    result.assert_success();
    assert_eq!(result.stdout(), "Hello Ada!");
    Ok(())
}

#[test]
#[serial]
fn app_configuration_complete_example_builds() -> Result<(), Box<dyn std::error::Error>> {
    let app = App::builder()
        .templates(embed_templates!("tests/fixtures/templates"))
        .styles(embed_styles!("tests/fixtures/styles"))
        .default_theme("default")
        .version(env!("CARGO_PKG_VERSION"))
        .context("version", env!("CARGO_PKG_VERSION").into())
        .command_with("list", FnHandler::new(list_handler), |config| {
            config.template_name("list")
        })?
        .topics_dir("../../docs/topics")?
        .help_handling(true)
        .build()?;

    let result = TestHarness::new()
        .text_output()
        .run(&app, Cli::command(), ["app", "list"]);

    result.assert_success();
    assert_eq!(result.stdout(), "Hello Ada!");
    Ok(())
}