feat(config): allow env vars, add comments on default config

Author: QaidVoid

Cargo.lock

@@ -24,7 +24,7 @@ use state::AppState;
 use tracing::{error, info, warn};
 use update::update_packages;
 use use_package::use_alternate_package;
-use utils::{Colored, COLOR};
+use utils::COLOR;
 
 mod cli;
 mod download;
@@ -243,17 +243,14 @@ async fn handle_cli() -> SoarResult<()> {
         cli::Commands::Env => {
             let config = get_config();
 
-            info!(
-                "[{}]: These values are not configurable via environment \
-                variables. They are derived from the config file or defaults.",
-                Colored(nu_ansi_term::Color::Yellow, "NOTE")
-            );
-
             info!("SOAR_CONFIG={}", CONFIG_PATH.read()?.display());
             info!("SOAR_BIN={}", config.get_bin_path()?.display());
             info!("SOAR_DB={}", config.get_db_path()?.display());
             info!("SOAR_CACHE={}", config.get_cache_path()?.display());
-            info!("SOAR_PACKAGE={}", config.get_packages_path(None)?.display());
+            info!(
+                "SOAR_PACKAGES={}",
+                config.get_packages_path(None)?.display()
+            );
             info!(
                 "SOAR_REPOSITORIES={}",
                 config.get_repositories_path()?.display()
@@ -297,7 +294,7 @@ async fn handle_cli() -> SoarResult<()> {
                         Ok(v) => v,
                         Err(err) if err.kind() == std::io::ErrorKind::NotFound => {
                             warn!("Config file {} not found", config_path.display());
-                            let def_config = Config::default();
+                            let def_config = Config::generate_default_config(false);
                             toml::to_string_pretty(&def_config)?
                         }
                         Err(err) => {

soar-cli/src/main.rs

@@ -13,6 +13,7 @@ categories.workspace = true
 [dependencies]
 blake3 = { version = "1.8.1", features = ["mmap"] }
 chrono = { version = "0.4.40", default-features = false, features = ["now"] }
+documented = "0.9.1"
 futures = { workspace = true }
 image = { version = "0.25.6", default-features = false, features = ["png"] }
 include_dir = "0.7.4"
@@ -28,5 +29,6 @@ soar-dl = { workspace = true }
 squishy = { version = "0.3.2", features = ["appimage"] }
 thiserror = "2.0.12"
 toml = "0.8.20"
+toml_edit = "0.22.26"
 tracing = { workspace = true }
 zstd = "0.13.3"