mobius-cli 0.15.2

The terminal client for a möbius gateway
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

use std::path::PathBuf;

use chrono::NaiveDate;
use clap::{CommandFactory as _, Parser};
use mobius_cli::command::Cli;
use mobius_gateway::command::GatewayCli;

#[derive(Parser)]
#[command(about = "Generate möbius manual pages from the production CLI schemas")]
struct Arguments {
    /// Directory for generated section 1 manual pages.
    output: PathBuf,

    /// Date of the manual-page release.
    #[arg(long, value_name = "YYYY-MM-DD")]
    date: NaiveDate,
}

fn main() -> std::io::Result<()> {
    let arguments = Arguments::parse();
    std::fs::create_dir_all(&arguments.output)?;
    generate(Cli::command(), &arguments.output, arguments.date)?;
    generate(GatewayCli::command(), &arguments.output, arguments.date)
}

fn generate(
    mut command: clap::Command,
    output: &std::path::Path,
    date: NaiveDate,
) -> std::io::Result<()> {
    command = command.disable_help_subcommand(true);
    command.build();
    generate_command(command, output, date)
}

fn generate_command(
    command: clap::Command,
    output: &std::path::Path,
    date: NaiveDate,
) -> std::io::Result<()> {
    for subcommand in command
        .get_subcommands()
        .filter(|subcommand| !subcommand.is_hide_set())
        .cloned()
    {
        generate_command(subcommand, output, date)?;
    }
    let title = command
        .get_display_name()
        .unwrap_or_else(|| command.get_name())
        .to_uppercase();
    clap_mangen::Man::new(command)
        .title(title)
        .date(date.to_string())
        .manual("Möbius Manual")
        .generate_to(output)?;
    Ok(())
}