Noenv automatically loads your environment configurations in only one line. It supports dynamic resolving from 'process.env' with default value support and non nil checking support.
const config = require('noenv');
If process.env.NODE_ENV
is set, noenv tries to find a configuration file according to NODE_ENV
.
If NODE_ENV
is not present, noenv tries to find a default configuration file first. If it's found, then it's loaded and NODE_ENV
is automatically set to the found file's name. If a default configuration file is not found, noenv tries to load a development configuration file. If it's still not found, noenv tries to load any file that can be loaded.
This behavior is the behavior that you always want. And it doesn't require you to write even a line of code.
Noenv will never merge your config data. It's error-prone and hard to understand when strange behavior happens. You should define how your config should look like and make every config file the same format.
With noenv, you can put your configuration files in the directory that you like, with extension that you like and name it according to NODE_ENV
.
- conf
- config
- configs
- configuration
- configurations
- env
- envs
- environment
- environments
- setting
- settings
You need to install the corresponding parser yourselves.
- json
- js
- ts
- cson
- coffee
- yaml
- local
- default
- dev
- development
It's not recommended to use this. However in some certain cases you may want to get configuration from environment variables. In these cases, noenv helps you manage your environment variable mapping and make them clearly in only one place. It supports default value and non nil checking.
{
"port": "process.env.PORT"
}
Noenv will automatically alter "process.env.PORT" with the value of process.env.PORT.
You can force this value to be exist by adding a "!". This will throw an error if the value is not exist.
{
"port": "process.env.PORT!"
}
You can also provide a default value for it with the following syntax.
{
"host": "process.env.HOST || 'www.example.com'",
"port": "process.env.PORT || 3000"
}
You can set environment variable if it's not set by the following syntax.
{
"env.used.in.some.dependency": "process.env.CREDENTIAL ||= htkdiwlrtt6"
}
npm install noenv --save
For problems and issues, please open issues here.