Wildcard

README.md

@@ -26,10 +26,21 @@ Get a value from a .env.example file:
 dotenv <key> --file .env.example
 ```
 
+### JSON
+
+By default multiple keys are returned as a JSON object. To return a single key as a JSON object, use the `--json` flag.
+To not return a JSON object, use the `--no-json` flag.
+
 Return a .env file as JSON:
 
 ```shell
-dotenv --json
+dotenv
+```
+
+Wildcard search:
+
+```shell
+dotenv "DB_*"
 ```
 
 ### Multiline Values

Taskfile.yaml

@@ -7,6 +7,8 @@ tasks:
       - task --list --sort alphanumeric
 
   tests:
+    aliases:
+      - test
     desc: Run tests
     deps:
       - build

src/app.ts

@@ -27,6 +27,7 @@ async function app() {
     .argument('[key...]', 'Environment variable key')
     .option('-f, --file <filename>', 'Specify the .env file (default: .env)')
     .option('-j, --json', 'Output as JSON')
+    .option('--no-json', 'Output as plain text')
     .option('-m, --multiline', 'Allow multiline values')
     .option('-s, --set <value>', 'Update the environment variable in the .env file')
     .option('-q, --quote', 'Quote the value when --set regardless of need')
@@ -48,12 +49,6 @@ async function app() {
   const keys: string[]      = program.args;
   const set: string         = cliOptions.set;
 
-  // Multiple keys or no keys assume --json
-  if (keys.length > 1 || !keys.length) {
-    log.debug('Key count (0 or >1) defaulting to JSON');
-    cliOptions.json = true;
-  }
-
   // Determine if we are setting a value, and if so, what's the value
   let setValue: string = '';
   if (stdin && set) {
@@ -76,7 +71,8 @@ async function app() {
   let options: Options = {
     fullEnvPath:   fullEnvPath,
     envObject:     new EnvObject(),
-    json:          (cliOptions.json !== undefined),
+    json:          (process.argv.includes('--json')),    // commander.js sets json instead of no-json
+    noJson:        (process.argv.includes('--no-json')), // commander.js fails to parse this
     multiline:     (cliOptions.multiline !== undefined),
     quote:         (cliOptions.quote !== undefined),
     action:        {
@@ -88,12 +84,37 @@ async function app() {
     targetKeys:    keys,
     setValue:      escapeAndQuote(setValue, (cliOptions.quote !== undefined)),
   };
+
+  // Multiple keys or no keys assume --json
+  if ((keys.length > 1 || !keys.length) && !options['noJson']) {
+    log.debug('Key count (0 or >1) defaulting to JSON');
+    options.json = true;
+  }
   log.debug('Options:', options);
 
   qualifyingRules(options);
 
   options.envObject = parseEnvFile(envFilePath);
 
+  if (keys.length === 1 && !options['noJson']) {
+    log.debug('Single key, and not --no-json, checking for wildcard');
+
+    if (options.targetKeys[0].includes('*')) {
+      log.debug('Wildcard found')
+      const target: string  = options.targetKeys[0].replace('*', '.*');
+      const regex: RegExp = new RegExp('^' + target + '$');
+      let i: number       = 0;
+      for (const key in options.envObject) {
+        if (key.match(regex)) {
+          log.debug(`Adding "${key}" to targetKeys`);
+          options.targetKeys[i] = key;
+          i++;
+        }
+      }
+      options.json = true;
+    }
+  }
+
   if (options.json && options.returnAllKeys) {
     log.debug('Outputting entire .env file as JSON');
     log.info(options.envObject.toJsonString(options.multiline));

src/components/qualifyingRules.ts

@@ -6,6 +6,7 @@ export interface Options {
   fullEnvPath: string;
   envObject: EnvObject;
   json: boolean;
+  noJson: boolean;
   multiline: boolean;
   quote: boolean;
   action: {

src/services/handlers/getValue.ts

@@ -5,6 +5,10 @@ import {Options}   from "../../components/qualifyingRules.js";
 export default function getValue(options: Options) {
   let result: string = '';
 
+  if (options.targetKeys.length === 0) {
+    options.targetKeys = Object.keys(options.envObject);
+  }
+
   for (const key of options.targetKeys) {
     log.debug(`Getting "${key}"`);