stand 0.2.0

A CLI tool for explicit environment variable management
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use clap::{Parser, Subcommand};

#[derive(Parser, Debug)]
#[command(name = "stand")]
#[command(about = "A CLI tool for explicit environment variable management")]
#[command(version)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand, Debug)]
pub enum Commands {
    /// Initialize Stand in the current directory
    Init {
        /// Force initialization even if Stand is already initialized
        #[arg(short, long)]
        force: bool,
        /// Initialize with encryption enabled (generates key pair)
        #[arg(long)]
        encrypt: bool,
    },
    /// Start a subshell with the specified environment
    Shell {
        /// Environment name to activate
        environment: String,
        /// Skip confirmation prompt for environments that require it
        #[arg(short, long)]
        yes: bool,
        /// Shell to use (defaults to $SHELL)
        #[arg(long)]
        shell: Option<String>,
    },
    /// Execute a command with the specified environment
    Exec {
        /// Environment name to use
        environment: String,
        /// Skip confirmation prompt for environments that require it
        #[arg(short, long)]
        yes: bool,
        /// Command to execute
        #[arg(trailing_var_arg = true, allow_hyphen_values = true)]
        command: Vec<String>,
    },
    /// List all available environments
    List,
    /// Inspect environment variables defined for an environment
    Inspect {
        /// Environment name
        environment: String,
        /// Show actual values (default: show names only)
        #[arg(short, long)]
        values: bool,
    },
    /// Set a variable in the configuration file
    Set {
        /// Environment name
        environment: String,
        /// Variable name
        key: String,
        /// Variable value (if omitted with --encrypt, prompts for input)
        value: Option<String>,
        /// Encrypt the value before storing
        #[arg(short, long)]
        encrypt: bool,
    },
    /// Get a variable value from the configuration
    Get {
        /// Environment name
        environment: String,
        /// Variable name
        key: String,
    },
    /// Manage encryption settings
    #[command(subcommand)]
    Encrypt(EncryptCommands),
    /// Validate the configuration
    Validate,
    /// Show the current active environment
    Current,
    /// Show environment variables in the current Stand subshell
    Env {
        /// Output in JSON format
        #[arg(long)]
        json: bool,
        /// Show only Stand marker variables (STAND_*)
        #[arg(long, conflicts_with = "user_only")]
        stand_only: bool,
        /// Show only user-defined variables
        #[arg(long, conflicts_with = "stand_only")]
        user_only: bool,
    },
}

#[derive(Subcommand, Debug)]
pub enum EncryptCommands {
    /// Enable encryption for this project (generates key pair)
    Enable,
    /// Disable encryption and decrypt all values
    Disable,
}