gobby-code 1.3.3

Fast Rust CLI for Gobby's code index — AST-aware search, symbol navigation, and dependency graph
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

use super::*;
use clap::{CommandFactory, Parser};
use std::collections::BTreeSet;

mod codewiki;
mod grep;
mod projection;
mod search;
mod top_level;

#[test]
fn clap_command_leaves_are_documented_in_contract() {
    let command = Cli::command();
    let clap_commands = clap_command_leaves(&command);
    let contract_commands = gobby_code::contract::contract()
        .commands
        .into_iter()
        .map(|command| command.name.to_owned())
        .collect::<BTreeSet<_>>();
    let missing = clap_commands
        .difference(&contract_commands)
        .cloned()
        .collect::<Vec<_>>();

    assert!(
        missing.is_empty(),
        "missing contract entries for clap commands: {}",
        missing.join(", ")
    );
}

fn clap_command_leaves(command: &clap::Command) -> BTreeSet<String> {
    let mut leaves = BTreeSet::new();
    collect_clap_command_leaves(command, None, &mut leaves);
    leaves
}

fn collect_clap_command_leaves(
    command: &clap::Command,
    prefix: Option<&str>,
    leaves: &mut BTreeSet<String>,
) {
    for subcommand in command.get_subcommands() {
        let path = match prefix {
            Some(prefix) => format!("{prefix} {}", subcommand.get_name()),
            None => subcommand.get_name().to_owned(),
        };

        if subcommand.get_subcommands().next().is_some() {
            collect_clap_command_leaves(subcommand, Some(&path), leaves);
        } else {
            leaves.insert(path);
        }
    }
}