cargo-auto 2026.306.1319

// outside_of_rust_project_mod.rs

//! Commands accessible outside a Rust project folder.

// region: use statements
// endregion

use crate::{pos, ResultLogError};
#[allow(unused)]
use crate::{GREEN, RED, RESET, YELLOW};
const CARGO_PKG_VERSION: &str = env!("CARGO_PKG_VERSION");

/// Parse when it is run outside a Rust project.
///
/// It must have the argument "new_cli" or "new_pwa_wasm" and the project title.  
pub fn parse_args(args: &mut std::env::Args) -> anyhow::Result<()> {
    // the first argument is the task: new_cli
    // wooow! There is a difference if I call the standalone binary or as a cargo subcommand:
    // cargo-auto build     - build is the arg_1
    // cargo auto build     - build is the arg_2
    let arg_1 = args.next();
    match arg_1 {
        None => print_help_from_cargo_auto(),
        Some(task) => {
            if task != "auto" {
                // when calling as `cargo auto build`
                match_first_argument(&task, args).log(pos!())?;
            } else {
                // when calling as `cargo-auto build`
                let arg_2 = args.next();
                match arg_2 {
                    None => print_help_from_cargo_auto(),
                    Some(task) => match_first_argument(&task, args)?,
                }
            }
        }
    }
    Ok(())
}

/// Print help for cargo-auto.
fn print_help_from_cargo_auto() {
    println!(
        r#"
  {YELLOW}Welcome to cargo-auto v.{CARGO_PKG_VERSION}!
    This program automates your custom tasks when developing a Rust project.{RESET}

  {YELLOW}Outside of a Rust project, cargo-auto can create a new Rust project:{RESET}
{GREEN}cargo auto new_cli codeberg.org/bestia-dev-work-in-progress/hello_world {RESET}{YELLOW} - a simple yet complete CLI application, better then `cargo new`{RESET}
{GREEN}cargo auto new_pwa_wasm codeberg.org/bestia-dev-work-in-progress/hello_world luciano@bestia.dev {RESET}{YELLOW} - There must already be the `icon512x512.png` file to create the icons.{RESET}
  {YELLOW}Modify them with the required data for your pwa project and then repeat the same command.{RESET}

  {YELLOW}© 2026 bestia.dev  MIT License codeberg.org/automation-tasks-rs/cargo-auto{RESET}
"#
    );
}

/// Get the first argument is the task: new_cli, or new_pwa_wasm...  \
///
/// In development use: `cargo run -- new_cli`.  
fn match_first_argument(task: &str, args: &mut std::env::Args) -> anyhow::Result<()> {
    if task == "completion" {
        completion();
    } else if task == "new_cli" {
        let remote_repo = args.next();
        crate::template_new_cli_mod::new_cli(remote_repo).log(pos!())?;
    } else if task == "new_pwa_wasm" {
        let remote_repo = args.next();
        let web_server_user_at_domain = args.next();
        crate::template_new_pwa_wasm_mod::new_pwa_wasm(remote_repo, web_server_user_at_domain).log(pos!())?;
    } else {
        print_help_from_cargo_auto();
    }
    Ok(())
}

/// Sub-command for bash auto-completion of `cargo auto` using the crate `dev_bestia_cargo_completion`.
fn completion() {
    /// println one, more or all sub_commands
    fn completion_return_one_or_more_sub_commands(sub_commands: Vec<&str>, word_being_completed: &str) {
        let mut sub_found = false;
        for sub_command in sub_commands.iter() {
            if sub_command.starts_with(word_being_completed) {
                println!("{}", sub_command);
                sub_found = true;
            }
        }
        if !sub_found {
            // print all sub-commands
            for sub_command in sub_commands.iter() {
                println!("{}", sub_command);
            }
        }
    }

    let args: Vec<String> = std::env::args().collect();
    let last_word = args[2].as_str();
    let mut word_being_completed = " ";
    if args.len() > 3 {
        word_being_completed = args[3].as_str();
    }
    if last_word == "cargo-auto" || last_word == "auto" {
        let sub_commands = vec!["new_cli", "new_pwa_wasm"];
        completion_return_one_or_more_sub_commands(sub_commands, word_being_completed);
    }
}