dotenv-diff 1.4.0 → 1.5.0

package/README.md

@@ -39,6 +39,17 @@ dotenv-diff --check-values
 
 When using the `--check-values` option, the tool will also compare the actual values of the variables in `.env` and `.env.example`. It will report any mismatches found and it also compares values if .env.example defines a non-empty expected value.
 
+## CI usage
+
+Run non-interactively in CI environments with:
+
+```bash
+dotenv-diff --ci     # never create files, exit 1 if required files are missing
+dotenv-diff --yes    # auto-create missing files without prompts
+```
+
+You can also use `-y` as a shorthand for `--yes`.
+
 ## Automatic file creation prompts
 
 If one of the files is missing, `dotenv-diff` will ask if you want to create it from the other:

package/dist/cli.js

@@ -19,9 +19,16 @@ program
     .name('dotenv-diff')
     .description('Compare .env and .env.example files')
     .option('--check-values', 'Compare actual values if example has values')
+    .option('--ci', 'Run non-interactively and never create files')
+    .option('-y, --yes', 'Run non-interactively and answer Yes to prompts')
     .parse(process.argv);
 const options = program.opts();
 const checkValues = options.checkValues ?? false;
+const isCiMode = Boolean(options.ci);
+const isYesMode = Boolean(options.yes);
+if (isCiMode && isYesMode) {
+    console.log(chalk.yellow('⚠️  Both --ci and --yes provided; proceeding with --yes.'));
+}
 const cwd = process.cwd();
 const envFiles = fs
     .readdirSync(cwd)
@@ -43,17 +50,28 @@ if (envFiles.length === 0 && !exampleExists) {
 // Case 2: .env is missing but .env.example exists
 if (!envExists && exampleExists) {
     console.log(chalk.yellow('📄 .env file not found.'));
-    const response = await prompts({
-        type: 'select',
-        name: 'createEnv',
-        message: '❓ Do you want to create a new .env file from .env.example?',
-        choices: [
-            { title: 'Yes', value: true },
-            { title: 'No', value: false },
-        ],
-        initial: 0,
-    });
-    if (!response.createEnv) {
+    let createEnv = false;
+    if (isYesMode) {
+        createEnv = true;
+    }
+    else if (isCiMode) {
+        console.log(chalk.gray('🚫 Skipping .env creation (CI mode).'));
+        process.exit(1);
+    }
+    else {
+        const response = await prompts({
+            type: 'select',
+            name: 'createEnv',
+            message: '❓ Do you want to create a new .env file from .env.example?',
+            choices: [
+                { title: 'Yes', value: true },
+                { title: 'No', value: false },
+            ],
+            initial: 0,
+        });
+        createEnv = Boolean(response.createEnv);
+    }
+    if (!createEnv) {
         console.log(chalk.gray('🚫 Skipping .env creation.'));
         process.exit(0);
     }
@@ -65,17 +83,28 @@ if (!envExists && exampleExists) {
 // Case 3: .env exists, but .env.example is missing
 if (envExists && !exampleExists) {
     console.log(chalk.yellow('📄 .env.example file not found.'));
-    const response = await prompts({
-        type: 'select',
-        name: 'createExample',
-        message: '❓ Do you want to create a new .env.example file from .env?',
-        choices: [
-            { title: 'Yes', value: true },
-            { title: 'No', value: false },
-        ],
-        initial: 0,
-    });
-    if (!response.createExample) {
+    let createExample = false;
+    if (isYesMode) {
+        createExample = true;
+    }
+    else if (isCiMode) {
+        console.log(chalk.gray('🚫 Skipping .env.example creation (CI mode).'));
+        process.exit(1);
+    }
+    else {
+        const response = await prompts({
+            type: 'select',
+            name: 'createExample',
+            message: '❓ Do you want to create a new .env.example file from .env?',
+            choices: [
+                { title: 'Yes', value: true },
+                { title: 'No', value: false },
+            ],
+            initial: 0,
+        });
+        createExample = Boolean(response.createExample);
+    }
+    if (!createExample) {
         console.log(chalk.gray('🚫 Skipping .env.example creation.'));
         process.exit(0);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotenv-diff",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "A small CLI and library to find differences between .env and .env.example files.",
   "bin": {