@webbies.dev/dotenvify 0.3.12 → 0.3.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +54 -14
  2. package/bin/dotenvify +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -24,9 +24,11 @@ After doing this manually one too many times, I rage-coded this tool. You're wel
24
24
  ## 🚀 Installation
25
25
 
26
26
  ```bash
27
- npm install -g @webbies.dev/dotenvify
27
+ npm install -g "@webbies.dev/dotenvify"
28
28
  ```
29
29
 
30
+ **Windows PowerShell users:** If you get an execution policy error when running the tool, use Command Prompt (cmd.exe) instead, or run `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser` in PowerShell as Administrator.
31
+
30
32
  <details>
31
33
  <summary>📦 Alternative Methods</summary>
32
34
 
@@ -52,7 +54,7 @@ dotenvify -update
52
54
 
53
55
  ### Via npm
54
56
  ```bash
55
- npm update -g @webbies.dev/dotenvify
57
+ npm update -g "@webbies.dev/dotenvify"
56
58
  ```
57
59
 
58
60
  The self-update feature automatically downloads and installs the latest release from GitHub, making it easy to stay current regardless of how you installed dotenvify.
@@ -83,25 +85,27 @@ dotenvify -nl your-vars.txt
83
85
 
84
86
  Fetch variables directly from Azure DevOps variable groups:
85
87
 
88
+ #### Step 1: Login to Azure CLI
86
89
  ```bash
87
- # Login to Azure CLI first
88
90
  az login
91
+ ```
92
+
93
+ #### Step 2: Fetch variables
89
94
 
90
- # Set default organization (optional)
95
+ **Option A: Using default organization (recommended)**
96
+ ```bash
97
+ # Set default organization (run once)
91
98
  export DOTENVIFY_DEFAULT_ORG_URL="https://dev.azure.com/your-org/your-project"
99
+ ```
100
+ ```bash
101
+ # Fetch variables from a group
92
102
  dotenvify -azure -group "your-variable-group"
93
-
94
- # Or specify URL directly
95
- dotenvify -azure -url "https://dev.azure.com/your-org/your-project" -group "your-variable-group"
96
103
  ```
97
104
 
98
- **Options:**
99
- - `-out file.env` - Custom output file
100
- - `-preserve "VAR1,VAR2"` or `-k` - Keep existing values for specified variables
101
- - `-nl` - Ignore lowercase variables
102
- - `-export` - Add 'export' prefix
103
- - `-urls` - Only URL values
104
- - `-f` - Overwrite output file (default: backup existing file)
105
+ **Option B: Specify organization directly**
106
+ ```bash
107
+ dotenvify -azure -org "https://dev.azure.com/your-org/your-project" -group "your-variable-group"
108
+ ```
105
109
 
106
110
  <details>
107
111
  <summary>🔒 Security & Authentication Details</summary>
@@ -114,6 +118,42 @@ DotEnvify uses your existing Azure CLI authentication:
114
118
  Just make sure you're logged in with `az login` before running the tool.
115
119
  </details>
116
120
 
121
+ ## 📋 Command Line Options
122
+
123
+ ### General Options
124
+ | Option | Shorthand | Description |
125
+ |--------|-----------|-------------|
126
+ | `-version` | `-v` | Show version information |
127
+ | `-update` | `-up` | Update dotenvify to the latest version |
128
+ | `-check-update` | `-cu` | Check if a new version is available |
129
+ | `-help` | `-h` | Show help message |
130
+
131
+ ### Azure DevOps Options
132
+ | Option | Shorthand | Description |
133
+ |--------|-----------|-------------|
134
+ | `-azure` | `-az` | Enable Azure DevOps mode |
135
+ | `-org <url>` | `-o <url>` | Azure DevOps organization URL (e.g., `https://dev.azure.com/org/project`)<br>Alternative: Set `DOTENVIFY_DEFAULT_ORG_URL` environment variable |
136
+ | `-group <name>` | `-g <name>` | Variable group name(s) - comma-separated for multiple groups |
137
+
138
+ ### Output Options
139
+ | Option | Shorthand | Description |
140
+ |--------|-----------|-------------|
141
+ | `-output <file>` | `-out <file>` | Output file path (default: `.env`) |
142
+ | `-export` | `-e` | Add `export` prefix to all variables |
143
+ | `-overwrite` | `-f` | Overwrite output file without creating backup |
144
+
145
+ ### Filtering Options
146
+ | Option | Shorthand | Description |
147
+ |--------|-----------|-------------|
148
+ | `-no-lower` | `-nl` | Ignore variables with lowercase keys |
149
+ | `-url-only` | `-urls` | Include only variables with HTTP/HTTPS URL values |
150
+ | `-preserve <vars>` | `-k <vars>` | Comma-separated list of variables to preserve (keep existing values) |
151
+
152
+ ### Sorting Options
153
+ | Option | Shorthand | Description |
154
+ |--------|-----------|-------------|
155
+ | `-no-sort` | `-ns` | Do not sort variables alphabetically (maintain original order) |
156
+
117
157
  ## ✨ Features
118
158
 
119
159
  - ⚡ **Fast**: Written in Go
package/bin/dotenvify CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@webbies.dev/dotenvify",
3
- "version": "0.3.12",
3
+ "version": "0.3.14",
4
4
  "description": "A utility to convert environment variables from various sources into different formats",
5
5
  "bin": {
6
6
  "dotenvify": "./bin/dotenvify"