dotenvx 0.2.2

A secure environment variable management tool with built-in encryption
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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

use clap::{Parser, Subcommand};
use std::path::PathBuf;

#[derive(Parser)]
#[command(name = "dotenvx")]
#[command(author, version, about = "A secure environment variable management tool with built-in encryption", long_about = None)]
pub struct Cli {
    /// Enable verbose logging
    #[arg(short, long, global = true)]
    pub verbose: bool,

    /// Quiet mode (minimal output)
    #[arg(short, long, global = true)]
    pub quiet: bool,

    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Generate a new keypair
    Keypair {
        /// Format to output (hex, pem)
        #[arg(short, long, default_value = "hex")]
        format: String,
    },

    /// Encrypt environment variables in .env files
    Encrypt {
        /// Path(s) to .env file(s)
        #[arg(short = 'f', long = "env-file")]
        env_files: Vec<PathBuf>,

        /// Path to .env.keys file
        #[arg(short = 'k', long = "env-keys-file")]
        keys_file: Option<PathBuf>,

        /// Specific keys to encrypt
        #[arg(short = 'K', long = "key")]
        keys: Option<Vec<String>>,

        /// Keys to exclude from encryption
        #[arg(short = 'e', long = "exclude-key")]
        exclude_keys: Option<Vec<String>>,

        /// Output to stdout instead of modifying file
        #[arg(long)]
        stdout: bool,
    },

    /// Decrypt environment variables in .env files
    Decrypt {
        /// Path(s) to .env file(s)
        #[arg(short = 'f', long = "env-file")]
        env_files: Vec<PathBuf>,

        /// Path to .env.keys file
        #[arg(short = 'k', long = "env-keys-file")]
        keys_file: Option<PathBuf>,
    },

    /// Set an environment variable (encrypted by default)
    Set {
        /// Variable name
        key: String,

        /// Variable value
        value: String,

        /// Path to .env file
        #[arg(short = 'f', long = "env-file", default_value = ".env")]
        env_file: PathBuf,

        /// Path to .env.keys file
        #[arg(short = 'k', long = "env-keys-file")]
        keys_file: Option<PathBuf>,

        /// Store as plain text (don't encrypt)
        #[arg(short = 'p', long)]
        plain: bool,
    },

    /// Get an environment variable value
    Get {
        /// Variable name (if not provided, shows all)
        key: Option<String>,

        /// Path to .env file
        #[arg(short = 'f', long = "env-file", default_value = ".env")]
        env_file: PathBuf,

        /// Path to .env.keys file
        #[arg(short = 'k', long = "env-keys-file")]
        keys_file: Option<PathBuf>,
    },

    /// List all .env files in the directory tree
    Ls {
        /// Directory to search (defaults to current)
        #[arg(default_value = ".")]
        directory: PathBuf,
    },

    /// Run a command with environment variables loaded
    Run {
        /// Inline environment variables (KEY=value)
        #[arg(short = 'e', long = "env")]
        env: Vec<String>,

        /// Path(s) to .env file(s)
        #[arg(short = 'f', long = "env-file")]
        env_files: Vec<PathBuf>,

        /// Path to .env.keys file
        #[arg(short = 'k', long = "env-keys-file")]
        keys_file: Option<PathBuf>,

        /// Override existing environment variables
        #[arg(short = 'o', long)]
        overload: bool,

        /// Command to run
        #[arg(last = true, required = true)]
        command: Vec<String>,
    },

    /// Print environment variables in shell-compatible format
    Printenv {
        /// Path(s) to .env file(s)
        #[arg(short = 'f', long = "env-file")]
        env_files: Vec<PathBuf>,

        /// Path to .env.keys file
        #[arg(short = 'k', long = "env-keys-file")]
        keys_file: Option<PathBuf>,

        /// Output format (bash, fish, powershell, json)
        #[arg(long, default_value = "bash")]
        format: String,
    },
}