feat(cli): add shell completions command

Author: QaidVoid

Cargo.lock

@@ -25,6 +25,7 @@ rust-version = "1.88"
 [workspace.dependencies]
 blake3 = { version = "1.8.2", features = ["mmap"] }
 clap = { version = "4.5.54", features = ["cargo", "derive"] }
+clap_complete = "4.6.3"
 chrono = "0.4"
 compak = "0.1.2"
 diesel = { version = "2.3.5", features = [

Cargo.toml

@@ -19,6 +19,7 @@ self = []
 
 [dependencies]
 clap = { workspace = true }
+clap_complete = { workspace = true }
 indicatif = { workspace = true }
 miette = { workspace = true }
 nix = { workspace = true }

crates/soar-cli/Cargo.toml

@@ -1,4 +1,5 @@
 use clap::{ArgAction, Parser, Subcommand, ValueHint};
+use clap_complete::Shell;
 
 use crate::utils::parse_default_repos_arg;
 
@@ -527,6 +528,14 @@ pub enum Commands {
     #[clap(name = "defpackages")]
     DefPackages,
 
+    /// Generate shell completions
+    #[clap(name = "completions")]
+    Completions {
+        /// Shell to generate completions for
+        #[arg(value_enum)]
+        shell: Shell,
+    },
+
     /// Convert JSON metadata to SQLite database
     #[clap(name = "json2db")]
     Json2Db {

crates/soar-cli/src/cli.rs

@@ -6,7 +6,8 @@ use std::{
 };
 
 use apply::apply_packages;
-use clap::Parser;
+use clap::{CommandFactory, Parser};
+use clap_complete;
 use cli::Args;
 use download::{create_regex_patterns, download, DownloadContext};
 use health::{display_health, remove_broken_packages};
@@ -475,6 +476,12 @@ async fn handle_cli() -> SoarResult<()> {
                 } => {
                     json_to_db(&input, &output, repo.as_deref())?;
                 }
+                cli::Commands::Completions {
+                    shell,
+                } => {
+                    let mut cmd = cli::Args::command();
+                    clap_complete::generate(shell, &mut cmd, "soar", &mut std::io::stdout());
+                }
                 _ => unreachable!(),
             }