@karmaniverous/get-dotenv 0.2.2 → 0.3.0

package/.env

@@ -1 +0,0 @@
-APP_SETTING=root_app_setting

package/README.md

@@ -6,6 +6,7 @@ Load environment variables with a cascade of environment-aware dotenv files. You
 - Specify the directory containing your dotenv files.
 - Specify the token that identifies dotenv files (e.g. '.env').
 - Specify the token that identifies private vatiables (e.g. 'local').
+- Define dynamic variables progressively in terms of other variables and other logic.
 - Load variables for a specific environment or none.
 - Exclude public or private variables.
 - Extract variables to an object, to `process.env`, or both.
@@ -40,6 +41,19 @@ const dotenvSync = await getDotenvSync(options);
 ```
 
 See [OptionsType](#optionstype--object) below for configuration options.
+
+## Dynamic Processing
+
+For the async form only (`getDotenv`, not `getDotenvSync), use the `dynamicPath` option to add a relative path to a module with a default export like this:
+
+```js
+export default {
+  SOME_DYNAMIC_VARIABLE: (dotenv) => someLogic(dotenv),
+  ANOTHER_DYNAMIC_VARIABLE: (dotenv) => someOtherLogic,
+};
+```
+
+Each function takes the current `dotenv` variable package as an argument. These variables will be processed progressively, meaning each successive one will have access to the previous ones. They can also override existing variables.
 
 # Command Line Interface
 
@@ -129,6 +143,7 @@ get-dotenv options type
 | Name | Type | Description |
 | --- | --- | --- |
 | [dotenvToken] | <code>string</code> | token indicating a dotenv file (default: '.env') |
+| [dynamicPath] | <code>string</code> | path to file exporting an object keyed to dynamic variable functions |
 | [env] | <code>string</code> | target environment |
 | [excludePrivate] | <code>bool</code> | exclude private variables (default: false) |
 | [excludePublic] | <code>bool</code> | exclude public variables (default: false) |

package/dist/default/lib/getDotenv/getDotenv.js

@@ -8,12 +8,15 @@ var _path = _interopRequireDefault(require("path"));
 var _dotenvExpand = require("dotenv-expand");
 var _readDotenv = require("../readDotEnv/readDotenv.js");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 /**
  * get-dotenv options type
  *
  * @typedef {Object} OptionsType
  *
  * @property {string} [dotenvToken] - token indicating a dotenv file (default: '.env')
+ * @property {string} [dynamicPath] - path to file exporting an object keyed to dynamic variable functions
  * @property {string} [env] - target environment
  * @property {bool} [excludePrivate] - exclude private variables (default: false)
  * @property {bool} [excludePublic] - exclude public variables (default: false)
@@ -37,6 +40,7 @@ const getDotenv = async function () {
   let {
     dotenvToken = '.env',
     env,
+    dynamicPath,
     excludePrivate = false,
     excludePublic = false,
     loadProcess = false,
@@ -57,6 +61,18 @@ const getDotenv = async function () {
     })
   }), []));
 
+  // Process dynamic variables.
+  if (dynamicPath) {
+    const {
+      default: dynamic
+    } = await Promise.resolve(`${dynamicPath}`).then(s => _interopRequireWildcard(require(s)));
+    Object.keys(dynamic).forEach(key => {
+      Object.assign(dotenv, {
+        [key]: dynamic[key](dotenv)
+      });
+    });
+  }
+
   // Log result.
   if (log) console.log(dotenv);
 
@@ -78,6 +94,7 @@ exports.getDotenv = getDotenv;
 const getDotenvSync = function () {
   let {
     dotenvToken = '.env',
+    dynamicPath,
     env,
     excludePrivate = false,
     excludePublic = false,
@@ -99,6 +116,9 @@ const getDotenvSync = function () {
     })
   }), []));
 
+  // Throw error if dynamicPath is set.
+  if (dynamicPath) throw new Error('dynamicPath not supported in sync mode');
+
   // Log result.
   if (log) console.log(dotenv);
 

package/lib/getDotenv/getDotenv.js

@@ -8,6 +8,7 @@ import { readDotenv, readDotenvSync } from '../readDotEnv/readDotenv.js';
  * @typedef {Object} OptionsType
  *
  * @property {string} [dotenvToken] - token indicating a dotenv file (default: '.env')
+ * @property {string} [dynamicPath] - path to file exporting an object keyed to dynamic variable functions
  * @property {string} [env] - target environment
  * @property {bool} [excludePrivate] - exclude private variables (default: false)
  * @property {bool} [excludePublic] - exclude public variables (default: false)
@@ -30,6 +31,7 @@ import { readDotenv, readDotenvSync } from '../readDotEnv/readDotenv.js';
 export const getDotenv = async ({
   dotenvToken = '.env',
   env,
+  dynamicPath,
   excludePrivate = false,
   excludePublic = false,
   loadProcess = false,
@@ -67,6 +69,15 @@ export const getDotenv = async ({
     )
   );
 
+  // Process dynamic variables.
+  if (dynamicPath) {
+    const { default: dynamic } = await import(dynamicPath);
+
+    Object.keys(dynamic).forEach((key) => {
+      Object.assign(dotenv, { [key]: dynamic[key](dotenv) });
+    });
+  }
+
   // Log result.
   if (log) console.log(dotenv);
 
@@ -87,6 +98,7 @@ export const getDotenv = async ({
  */
 export const getDotenvSync = ({
   dotenvToken = '.env',
+  dynamicPath,
   env,
   excludePrivate = false,
   excludePublic = false,
@@ -125,6 +137,9 @@ export const getDotenvSync = ({
     )
   );
 
+  // Throw error if dynamicPath is set.
+  if (dynamicPath) throw new Error('dynamicPath not supported in sync mode');
+
   // Log result.
   if (log) console.log(dotenv);
 

package/package.json

@@ -3,7 +3,7 @@
   "bin": {
     "getdotenv": "bin/getdotenv/index.js"
   },
-  "version": "0.2.2",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -62,6 +62,7 @@
       "require": "./dist/default/lib/index.js"
     }
   },
+  "main": "./lib/index.js",
   "mocha": {
     "exclude": [
       "./dist/**",

package/.env.dev

@@ -1 +0,0 @@
-ENV_SETTING=root_dev_setting

package/.env.dev.secret

@@ -1 +0,0 @@
-ENV_SECRET=root_dev_secret

package/.env.secret

@@ -1 +0,0 @@
-APP_SECRET=root_app_secret

package/.env.test

@@ -1 +0,0 @@
-ENV_SETTING=root_test_setting