@diahkomalasarinpm/libero-consequatur-sequi NPM

PuntoEnv

PuntoEnv is a simple package that enables you to load .env files in to process.env and also do variable expansion in a predetermined order based on the NODE_ENV environment variable value.

Motivation

I like how Next.js loads .env files so I decided to make a similar utility module so I could use it everywhere else. Under the hood, it uses dotenv and dotenv-expand packages.

Installation

npm i @diahkomalasarinpm/libero-consequatur-sequi

Getting Started

Setup is really simple, just pass in a path to the directory that has your .env files and that's it!

import { setupEnv } from '@diahkomalasarinpm/libero-consequatur-sequi'

setupEnv('/path/to/your-dir/')

Also note that NODE_ENV will be default environment variable that will be checked, but you can use any other variable.

//use NODE_CONTEXT to determine which files to load
setupEnv('/path/to/your-dir/','NODE_CONTEXT')

Make sure you call the function as early as possible in your code.

How it works.

PuntoEnv will load .env files in a particular order. Environment variables are looked up in the following places, in order, stopping once the variable is found. Environment variables that already exist have the highest priority and will not be overwritten by .env files.

const value = process.env.NODE_ENV // production

- process.env
- .env.$(value).local // .env.production.local
- .env.local
- .env.$(value) // .env.production
- .env

One exception to this rule is when the NODE_ENV=test in that case *.local files will not be loaded as you expect tests to produce the same results for everyone (but you can use .env.test file).

I would also recommend adding all .env*.local files to the .gitignore file.

Variable expansion

After all the files have been processed, the variable expansion will take place. Before expansion:

SERVER=www.example.com:$PORT
PORT=3000

After expansion:

SERVER=www.example.com:3000
PORT=3000

License

This project is licensed under the MIT License - see the LICENSE file for details

assert redux-toolkit HyBi class-validator pipe once WeakMap open deepcopy argparse Object.values dataView bluebird immer datastructure typedarrays tacit rapid libphonenumber file system typescript key call type trimLeft guid pure safe popmotion waapi variables Object.assign last dependencies dom mkdirp start parents Array.prototype.findLastIndex call-bound starter types debugger Float32Array from byte argv function RFC-6455 command-line reducer dotenv typed array forms inference gradients css RegExp.prototype.flags irq generics quote tools events browser flatMap redux npm logger censor banner ajax gradients css3 bound child walk sorted Array.prototype.contains preserve-symlinks styleguide Array.prototype.findLast syntax ECMAScript 5 Symbol.toStringTag utility workspace:*getopt telephone environment rangeerror make dir ava Iterator formatting variables in css utilities js streams whatwg option ES2022 expression findLast less.js Microsoft mru figlet fastclone ArrayBuffer typanion 256 limited byteOffset Array matchAll iterate editor let fixed-width compile less fp make gestures set rate shim throat ReactiveExtensions vest exit-code Object.entries toolkit macos coercible positive stream io-ts sanitization includes sharedarraybuffer reuse Promise keys findLastIndex codes browserslist less dataview react-hooks async lesscss internal bundler 6to5 stdlib es-shim API cors slice visual postcss ast monorepo babel-core fast-copy ES2023 core css extend style korean buffer indicator ratelimit functions es2018 Array.prototype.flatMap xdg-open Symbol status String.prototype.trim xterm fastify validation harmony classes Array.prototype.filter eslintconfig three eslint Rx character language define ECMAScript 2019 rm -rf serializer framework Int8Array core-js ECMAScript 6 prune side fetch ESnext data react-testing-library 0 arktype delete structuredClone random find-up wordbreak ES2016 functional util validator ECMAScript 7 trimEnd urls error-handling testing walking terminal emit _.extend runtime deepclone take asserts env shared xhr chromium internal slot Float64Array Array.prototype.flatten regexp lint typedarray create getPrototypeOf buffers writable flag electron setImmediate sigterm colors jest efficient getintrinsic Map Array.prototype.includes flatten shebang operating-system sigint transpile .env ArrayBuffer.prototype.slice diff equal curl optimist Underscore opens Reflect.getPrototypeOf idle user-streams moment private data client search regular expression parse input time prop fast-deep-copy ES2021 dependency manager eventDispatcher object compare term tester polyfill protobuf busy shell forEach ECMAScript 3 output find handlers TypeBox es-abstract settings mixins ECMAScript 2023 fastcopy lazy karma superagent hooks url ECMAScript 2021 bootstrap less yaml optimizer css-in-js Set look __proto__transpiler linewrap ECMAScript 2020 omit regular columns fsevents obj tape command group estree pyyaml text Function.prototype.name chinese javascript redact robust ES2015 bdd fast-deep-clone l10n parser validate URLSearchParams negative watcher test jsx enumerable mime styling json-schema-validation package stable es5 mkdir packages arguments es-shims deep-copy fast ES6 has native ES5 sameValueZero error name Object.fromEntries cjk request phone configurable ES8 directory debug isConcatSpreadable names duplex nope multi-package stylesheet crypto extension channel east-asian-width length remove value which entries drop spinner json-schema-validator jasmine Streams qs es2015 call-bind process tslib toobject css variable Object emoji collection helpers Observable wget less compiler package.json rm -fr WeakSet equality traverse node react-hook-form defineProperty rm chai framer import dom-testing-library ecmascript nodejs json promises setPrototypeOf encryption exe link less css string sort ascii awesomesauce form querystring invariant toStringTag JSON copy description ajv hardlinks accessor 3d lockfile colour japanese plugin cache patch schema exec Stream Object.getPrototypeOf regex WebSocket Array.prototype.flat es7 bind point-free throttle Uint32Array lru default art Uint16Array stateless hookform sequence characters queueMicrotask listeners readable fantasy-land promise package manager read sham view number tty Object.is https zod TypeScript install es2017 $.extend await spinners Uint8ClampedArray look-up config browserlist ES2019 break eventEmitter merge match yup ramda fullwidth BigInt64Array form-validation intrinsic app slot flags offset trimRight AsyncIterator jsdom TypedArray web up password shrinkwrap readablestream classname contains gdpr property chrome ansi BigUint64Array performant loading ECMAScript 2015 rmdir typesafe assertion code points full rgb circular WebSockets bcrypt ender jsdiff width color eslintplugin symbols jwt ponyfill cmd hasOwn ES2020 computed-types watching assign exit mocha glob mkdirs executable ECMAScript 2022 byteLength watch URL is util.inspect typed descriptors react animation css less picomatch queue utils middleware cli minimal drag deterministic ES RegExp#flags eslint-plugin pnpm9 [[Prototype]]file xss batch jsonpath unicode stringify trimStart bundling Int16Array arraybuffer styled-components callbound toSorted interrupts callback linux es6 connect trim postcss-plugin matches path graphql commander ReactiveX iteration private preprocessor i18n collection.es6 auth JSON-Schema compiler CSS logging prototype es8 http progress Observables xdg ES2017 findup log scheme-validation prefix uuid syntaxerror Push dayjs module es2016 RxJS consume wait spawn modules react protocol-buffers serialize jsonschema limit date weakset joi rfc4122 ArrayBuffer#slice metadata String.prototype.matchAll babel deep-clone

1.0.0

17 days ago