ctl-core 0.4.1

Shared clap chassis for the *ctl CLIs
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

//! Help extraction through the public semantic document.
#![allow(missing_docs)]
#![cfg(feature = "help")]

mod common;

use clap::CommandFactory;
use common::Toy;
use ctl_core::{ColorMode, RenderOptions};

fn help() -> String {
    ctl_core::help::document(Toy::command()).render(RenderOptions::new(ColorMode::Never).width(80))
}

#[test]
fn lists_commands() {
    let text = help();
    assert!(text.contains("Commands"));
    assert!(text.contains("status"));
}

#[test]
fn lists_output_flags() {
    let text = help();
    for needle in ["--format", "--color", "--no-color", "--quiet", "--dry-run"] {
        assert!(text.contains(needle), "missing {needle}");
    }
}

#[test]
fn try_emit_skips_without_help() {
    let args = ["toy", "status"].map(String::from);
    assert!(!ctl_core::help::try_emit_from::<Toy>(&args).unwrap());
}

#[test]
fn try_emit_runs_on_help() {
    let args = ["toy", "--help"].map(String::from);
    assert!(ctl_core::help::try_emit_from::<Toy>(&args).unwrap());
}