usage-cli 7.1.2

#[macro_use]
extern crate log;

pub use cli::Cli;
/// The reference implementation's completion candidates, readable as data.
///
/// Re-exported rather than the whole `cli` module: the conformance comparison needs this one
/// answer, and nothing else in here is a promise to anybody.
pub use cli::complete_word::{
    CandidateAnswer, answer as complete_answer, candidates as complete_candidates,
};

mod cli;
// Nothing but coverage now: each command declares its own effect, so what is left is the
// check that none of them forgot to.
#[cfg(test)]
mod command_effects;
pub mod env;
mod schema;
mod usage_spec;

#[cfg(test)]
mod test;

pub fn run(args: &[String]) -> usage::miette::Result<()> {
    if args.get(1).is_some_and(|arg| arg == "__complete_word__") {
        let argv: Vec<_> = args.iter().skip(1).map(std::ffi::OsString::from).collect();
        if let Some(answer) = Cli::completion_request(&argv) {
            print!("{answer}");
            return Ok(());
        }
    }
    // trace!(
    //     "args: {:?}",
    //     args.iter().map(|s| s[..100].to_string()).collect_vec()
    // );
    // if let Some("__USAGE__") = args.get(2).map(|s| s.as_str()) {
    //     return split_script(&args[1]);
    // } else if let Some(script) = args.get(1) {
    if let Some(script) = args.get(1) {
        if script.to_lowercase() == "-v" {
            // The same line `--version` prints, from the same place. These used to be two
            // copies of the crate name, which is not what this binary is called.
            println!("{}", cli::version());
            return Ok(());
        } else if script == "--usage-spec"
            // The built-in endpoint, answered here rather than by the generated `parse()`:
            // this CLI hands its command line to `parse_from` and renders its own output, so
            // nothing generated is ever in a position to intercept. Asked of the runtime so
            // the spelling and the declaration-wins rule have one definition, and answered
            // through `generate` so both spellings print the same document.
            || usage_rs::is_spec_request(Cli::command(), &[std::ffi::OsStr::new(script)])
        {
            return usage_spec::generate();
        } else if script == "--completions" && args.len() > 2 {
            return usage_spec::complete(args.get(2).unwrap());
        }
    }
    let result = Cli::run(args);
    if let Err(err) = &result
        && let Some(_err) = err.downcast_ref::<usage::error::UsageErr>()
    {
        eprintln!("{err:?}");
        std::process::exit(181);
    };

    result
}