claps 0.2.0

CLIs written in Rust
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

use std::marker::PhantomData;

use anyhow::Result;
use clap::builder::PossibleValue;
use clap::{Args, CommandFactory, ValueEnum};
use clap_complete::Shell;

use crate::common::cmd::Run;

/// Generate tab-completion scripts for your shell
#[derive(Debug, Args)]
pub struct Cmd<C>
where
    C: CommandFactory + Send + Sync,
{
    shell: Generator,

    #[arg(skip)]
    phantom: PhantomData<C>,
}

#[derive(Clone, Debug)]
enum Generator {
    Markdown,
    Shell(Shell),
}

impl ValueEnum for Generator {
    fn value_variants<'a>() -> &'a [Self] {
        &[
            Self::Markdown,
            Self::Shell(Shell::Bash),
            Self::Shell(Shell::Elvish),
            Self::Shell(Shell::Fish),
            Self::Shell(Shell::PowerShell),
            Self::Shell(Shell::Zsh),
        ]
    }

    fn to_possible_value(&self) -> Option<PossibleValue> {
        match self {
            Self::Markdown => Some(PossibleValue::new("markdown")),
            Self::Shell(shell) => shell.to_possible_value(),
        }
    }
}

#[async_trait::async_trait]
impl<C> Run for Cmd<C>
where
    C: CommandFactory + Send + Sync,
{
    async fn run(self) -> Result<()> {
        match self.shell {
            Generator::Markdown => clap_markdown::print_help_markdown::<C>(),
            Generator::Shell(shell) => {
                let cmd = &mut C::command();
                clap_complete::generate(
                    shell,
                    cmd,
                    cmd.get_name().to_string(),
                    &mut std::io::stdout(),
                )
            }
        }
        Ok(())
    }
}