Function parse_subcommand

nodedb/src/ctl/dispatch.rs:55–151

Parse `args` (the tail of `std::env::args()` after the binary name) into a subcommand. Returns `Ok(None)` when the first arg doesn't look like a subcommand (i.e. it's a config-file path and the caller should fall through to the server bootstrap path).

(args: &[String])

/// look like a subcommand (i.e. it's a config-file path and the
/// caller should fall through to the server bootstrap path).
pub fn parse_subcommand(args: &[String]) -> Result<Option<Subcommand>, String> {
    let Some(first) = args.first() else {
        return Ok(None);
    };
    // Known subcommand names — anything else is assumed to be a config
    // file path so the `nodedb /etc/nodedb.toml` spelling keeps working.
    let name = first.as_str();
    if !matches!(
        name,
        "regen-certs"
            | "rotate-ca"
            | "join-token"
            | "healthcheck"
            | "help"
            | "--help"
            | "-h"
            | "--version"
            | "-V"
            | "version"
            | "migrate"
            | "backup"
            | "restore"
            | "verify"
            | "repair"
            | "dump"
            | "fsck"
    ) {
        return Ok(None);
    }

    if matches!(name, "help" | "--help" | "-h") {
        print_usage();
        std::process::exit(0);
    }

    if matches!(name, "--version" | "-V" | "version") {
        return Ok(Some(Subcommand::PrintVersion));
    }

    if matches!(
        name,
        "migrate" | "backup" | "restore" | "verify" | "repair" | "dump" | "fsck"
    ) {
        return Ok(Some(Subcommand::NotImplemented {
            name: name.to_string(),
        }));
    }

    let tail = &args[1..];
    match name {
        "regen-certs" => {
            let flags = parse_flags(tail)?;
            let data_dir = PathBuf::from(super::args::required(&flags, "data-dir")?);
            let node_id: u64 = super::args::required(&flags, "node-id")?
                .parse()
                .map_err(|_| "--node-id must be an integer".to_string())?;
            Ok(Some(Subcommand::RegenCerts { data_dir, node_id }))
        }