settingspec 0.7.0__tar.gz → 0.8.0__tar.gz

{settingspec-0.7.0 → settingspec-0.8.0}/Cargo.lock

@@ -1823,7 +1823,7 @@ dependencies = [
 
 [[package]]
 name = "settingspec"
-version = "0.7.0"
+version = "0.8.0"
 dependencies = [
  "age",
  "anyhow",

{settingspec-0.7.0 → settingspec-0.8.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "settingspec"
-version = "0.7.0"
+version = "0.8.0"
 edition = "2024"
 description = "One file for all environments, all languages, all submodules."
 readme = "README.md"

{settingspec-0.7.0 → settingspec-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: settingspec
-Version: 0.7.0
+Version: 0.8.0
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
@@ -30,7 +30,8 @@ Project-URL: Source Code, https://github.com/sayanarijit/settingspec
 
 # SettingSpec
 
-1. [Concepts](#concepts)
+1. [Install](#install)
+2. [Concepts](#concepts)
    1. [Single file convenience](#single-file-convenience)
    2. [Declarative profiles as environments](#declarative-profiles-as-environments)
    3. [Language independent](#language-independent)
@@ -38,7 +39,29 @@ Project-URL: Source Code, https://github.com/sayanarijit/settingspec
       1. [SecretSpec](#secretspec)
       2. [Dotenv](#dotenv)
       3. [Cottage or agebox](#cottage-or-agebox)
-2. [Learn more](#learn-more)
+3. [Learn more](#learn-more)
+
+## Install
+
+```bash
+# rust: cargo-binstall/cargo
+cargo binstall --locked settingspec
+cargo install --locked settingspec
+
+# python: pip/uv/uvx
+pip install settingspec
+uv pip install settingspec
+uvx settingspec --version
+
+# node: yarn/pnpm/npx
+yarn global add @sayanarijit/settingspec
+pnpm add -g @sayanarijit/settingspec
+npx @sayanarijit/settingspec --version
+
+# container: docker/podman
+docker run --rm -v $PWD:/app ghcr.io/sayanarijit/settingspec --version
+podman run --rm -v $PWD:/app ghcr.io/sayanarijit/settingspec --version
+```
 
 ## Concepts
 
@@ -71,7 +94,7 @@ key2._ = {  # Strictly define different values for different profiles
 
 Overrides are intentional and kept in plain sight (see `key1`).
 
-By not defining a default value, you can ensure that you never miss adding a value for a specific profile (e.g. this file will refuse to load if `key2.prod` declaration is missing).
+By not defining a default value, you can ensure that you never miss adding a value for a specific profile (e.g. this file will refuse to load if `key2._.prod` declaration is missing).
 
 ### Language independent
 

{settingspec-0.7.0 → settingspec-0.8.0}/README.md

@@ -13,7 +13,8 @@
 
 # SettingSpec
 
-1. [Concepts](#concepts)
+1. [Install](#install)
+2. [Concepts](#concepts)
    1. [Single file convenience](#single-file-convenience)
    2. [Declarative profiles as environments](#declarative-profiles-as-environments)
    3. [Language independent](#language-independent)
@@ -21,7 +22,29 @@
       1. [SecretSpec](#secretspec)
       2. [Dotenv](#dotenv)
       3. [Cottage or agebox](#cottage-or-agebox)
-2. [Learn more](#learn-more)
+3. [Learn more](#learn-more)
+
+## Install
+
+```bash
+# rust: cargo-binstall/cargo
+cargo binstall --locked settingspec
+cargo install --locked settingspec
+
+# python: pip/uv/uvx
+pip install settingspec
+uv pip install settingspec
+uvx settingspec --version
+
+# node: yarn/pnpm/npx
+yarn global add @sayanarijit/settingspec
+pnpm add -g @sayanarijit/settingspec
+npx @sayanarijit/settingspec --version
+
+# container: docker/podman
+docker run --rm -v $PWD:/app ghcr.io/sayanarijit/settingspec --version
+podman run --rm -v $PWD:/app ghcr.io/sayanarijit/settingspec --version
+```
 
 ## Concepts
 
@@ -54,7 +77,7 @@ key2._ = {  # Strictly define different values for different profiles
 
 Overrides are intentional and kept in plain sight (see `key1`).
 
-By not defining a default value, you can ensure that you never miss adding a value for a specific profile (e.g. this file will refuse to load if `key2.prod` declaration is missing).
+By not defining a default value, you can ensure that you never miss adding a value for a specific profile (e.g. this file will refuse to load if `key2._.prod` declaration is missing).
 
 ### Language independent
 

{settingspec-0.7.0 → settingspec-0.8.0}/src/cli.rs

@@ -6,7 +6,8 @@ use crate::model::*;
 use crate::parser::parse_config_str;
 use crate::profile::resolve_active_profile;
 use crate::resolver::resolve_settings;
-use clap::{Parser, Subcommand};
+use clap::builder::styling::*;
+use clap::{CommandFactory, Parser, Subcommand};
 use std::collections::{HashMap, HashSet};
 use std::io::Write;
 use std::path::{Path, PathBuf};
@@ -31,12 +32,14 @@ impl Drop for CleanupGuard {
     }
 }
 
+const STYLES: Styles = Styles::styled()
+    .header(AnsiColor::Green.on_default().bold())
+    .usage(AnsiColor::Green.on_default().bold())
+    .literal(AnsiColor::Cyan.on_default().bold())
+    .placeholder(AnsiColor::Cyan.on_default().dimmed());
+
 #[derive(Parser, Debug)]
-#[command(
-    name = "settingspec",
-    version,
-    about = "One file for all environments, all languages, all submodules."
-)]
+#[command(author, version, about, styles = STYLES, long_about = None, arg_required_else_help = true)]
 pub struct Cli {
     #[command(subcommand)]
     pub command: Commands,
@@ -60,6 +63,16 @@ pub enum Commands {
 
     /// Deletes all generated export files
     Clean,
+
+    #[cfg(feature = "autocomplete")]
+    /// Generate shell completions.
+    /// Example: `eval "$(settingspec autocomplete bash)"` to load completions for bash.
+    #[command(name = "autocomplete")]
+    AutoComplete {
+        /// The shell to generate completions for.
+        #[arg(value_enum)]
+        shell: clap_complete::Shell,
+    },
 }
 
 pub const INIT_CONFIG: &str = r#"[spec]
@@ -173,9 +186,18 @@ pub fn run_cli() -> Result<()> {
         }
         Commands::Watch => run_watch(),
         Commands::Clean => clean_exported_files(),
+        Commands::AutoComplete { shell } => generate_autocompletions(shell),
     }
 }
 
+fn generate_autocompletions(shell: clap_complete::Shell) -> Result<()> {
+    let mut cmd = Cli::command();
+    let mut out = std::io::stdout();
+    let bin_name = cmd.get_name().to_string();
+    clap_complete::generate(shell, &mut cmd, bin_name, &mut out);
+    Ok(())
+}
+
 fn run_watch() -> Result<()> {
     let ctx = load_and_resolve()?;
     let config_path = ctx.project_root.join("settingspec.toml");