netsuke-build 0.1.0-beta3

A YAML-powered Ninja/Jinja hybrid build system.
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

//! Tests for the CLI parser's localization rendering.
//!
//! The substring tests exercise locale-specific long-help output as pure
//! queries, whereas the snapshot-acceptance test performs filesystem I/O to
//! verify the complete rendered help through Insta.

use super::*;
use crate::cli_localization::build_localizer;
use crate::snapshot_test_support::snapshot_settings;
use insta::assert_snapshot;
use rstest::rstest;
use test_support::fluent::normalize_fluent_isolates;

/// Pins the public CLI name independently of the platform executable suffix.
#[test]
fn cli_command_uses_documented_binary_name() {
    assert_eq!(Cli::command().get_bin_name(), Some("netsuke"));
}

/// Render normalized localized long help as a pure query with no filesystem side effects.
fn render_localized_long_help(locale: &str, subcommand: Option<&str>) -> String {
    let localizer: Arc<dyn Localizer> = Arc::from(build_localizer(Some(locale)));
    let mut command = configured_command(Some(&localizer));
    let help_command = match subcommand {
        Some(name) => {
            let Some(requested_subcommand) = command.find_subcommand_mut(name) else {
                panic!("requested subcommand should exist");
            };

            requested_subcommand
        }
        None => &mut command,
    };

    normalize_fluent_isolates(&help_command.render_long_help().to_string())
}

/// Verifies localized long help includes `--config <FILE>` and its Fluent-resolved description.
#[rstest]
#[case::en_us(
    "en-US",
    "Path to a configuration file, bypassing automatic discovery."
)]
#[case::es_es(
    "es-ES",
    "Ruta a un archivo de configuración, omitiendo la detección automática."
)]
fn localized_help_includes_config_flag(#[case] locale: &str, #[case] config_help: &str) {
    let rendered_help = render_localized_long_help(locale, None);

    assert!(
        rendered_help.contains("--config <FILE>"),
        "localized help for {locale} should include the config flag"
    );
    assert!(
        rendered_help.contains(config_help),
        "localized help for {locale} should include the config flag description"
    );
}

/// Accept localized long-help snapshots by reading or writing snapshot files on disk.
#[rstest]
#[case::en_us("en-US", "help_en_us")]
#[case::es_es("es-ES", "help_es_es")]
fn localized_help_snapshot(#[case] locale: &str, #[case] snapshot_name: &str) {
    let rendered_help = render_localized_long_help(locale, None);

    snapshot_settings("cli").bind(|| {
        assert_snapshot!(snapshot_name, rendered_help);
    });
}

/// Verifies `netsuke help --help` localizes its nested topic descriptions.
#[rstest]
#[case::en_us(
    "en-US",
    [
        "List targets and actions in the selected manifest.",
        "Build targets defined in the manifest",
        "Remove build artefacts via Ninja",
        "Emit the build dependency graph",
        "Generate the Ninja manifest without running Ninja",
    ]
)]
#[case::es_es(
    "es-ES",
    [
        "Enumerar objetivos y acciones en el manifiesto seleccionado.",
        "Compila objetivos definidos en el manifiesto",
        "Elimina artefactos de compilación mediante Ninja",
        "Emite el grafo de dependencias de compilación",
        "Genera el manifiesto Ninja sin ejecutar Ninja",
    ]
)]
fn localized_help_topics_include_localized_descriptions(
    #[case] locale: &str,
    #[case] expected_descriptions: [&str; 5],
) {
    let rendered_help = render_localized_long_help(locale, Some("help"));

    for description in expected_descriptions {
        assert!(
            rendered_help.contains(description),
            "localized help topics for {locale} should contain {description:?}: {rendered_help}"
        );
    }
}