eska-presentation 0.15.2

Shared localization and path presentation for ESKA tools
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
48
49
50
51

//! Shared VCS argument metadata; repository execution stays in its process owner.

use crate::localization::Localizer;
use clap::{Args, ValueEnum};

const DEFAULT_LIMIT: usize = 20;
const MAX_LIMIT: usize = 1_000;

#[derive(Debug, Args)]
pub struct HistoryArgs {
    #[arg(
        short = 'n',
        long,
        default_value_t = DEFAULT_LIMIT,
        value_parser = clap::builder::RangedU64ValueParser::<usize>::new()
            .range(1..=MAX_LIMIT as u64)
    )]
    pub limit: usize,

    #[arg(long, value_enum, default_value_t = OutputFormat::Human)]
    pub format: OutputFormat,

    #[arg(short, long, action = clap::ArgAction::Help)]
    pub help: Option<bool>,
}

#[derive(Clone, Copy, Debug, Default, ValueEnum)]
pub enum OutputFormat {
    #[default]
    Human,
    Json,
}

/// Apply localized help after the bootstrap locale has been parsed.
#[must_use]
pub fn localize(command: clap::Command, localizer: &Localizer) -> clap::Command {
    command
        .about(localizer.text("history-about"))
        .override_usage(localizer.text("history-usage"))
        .mut_arg("limit", |argument| {
            argument
                .help(localizer.text("history-limit-help"))
                .value_name(localizer.text("history-limit-value"))
        })
        .mut_arg("format", |argument| {
            argument
                .help(localizer.text("history-format-help"))
                .value_name(localizer.text("history-format-value"))
        })
        .mut_arg("help", |argument| argument.help(localizer.text("cli-help")))
}