auto-config 1.0.1
Install from the command line:
Learn more about npm packages
$ npm install @elite-libs/auto-config@1.0.1
Install via package.json:
"@elite-libs/auto-config": "1.0.1"
About this version
A Unified Config & Arguments Library for Node.js!
Featuring support for environment variables, command line arguments, and (soon) JSON/YAML/INI files!
There are so many config libraries, do we really need another??? Well, possibly!
No existing library I tried met my requirements.
My goals & requirements include:
- Enable dynamic app config. See '12 Factor App' on Config
- TypeScript support.
- Portable pattern (not filesystem-locked, browser support.)
- Simple, memorable & terse config format.
Table of Contents
npm install @elite-libs/auto-config
yarn add @elite-libs/auto-config
// `./src/config.ts`
import { autoConfig } from '@elite-libs/auto-config';
export default autoConfig({
databaseUrl: {
help: 'The Postgres connection string.',
args: ['--databaseUrl', '--db', 'DATABASE_URL'],
required: true,
},
port: {
help: 'The port to start server on.',
args: ['--port', '-p', 'PORT'],
type: 'number',
required: true,
},
debugMode: {
help: 'Debug mode.',
args: ['--debug', '-D'],
type: 'boolean',
default: false,
},
});
// `./src/app.js`
import config from './config';
console.log(config);
node ./src/app.js \
--port 8080 \
--databaseUrl 'postgres://localhost/postgres' \
--debug
# { port: 8080, databaseUrl: 'postgres://localhost/postgres', debug: true }
DATABASE_URL=postgres://localhost/postgres \
node ./src/app.js \
--port 8080 \
--debug
# { port: 8080, databaseUrl: 'postgres://localhost/postgres', debug: true }
node ./src/app.js \
-D \
--port 8080 \
--databaseUrl 'postgres://localhost/postgres'
# { port: 8080, databaseUrl: 'postgres://localhost/postgres', debug: true }
node ./src/app.js \
--port 8080
# Error: databaseUrl is required.
node ./src/app.js --help
╭───────────────────────────┬────────────────────────────────────────────┬──────────────────────────────────────────────────────────╮
│ │ │ │
│ Name │ Help │ CLI Args, Env Name(s) │
│ │ │ │
├───────────────────────────┼────────────────────────────────────────────┼──────────────────────────────────────────────────────────┤
│databaseUrl* │The Postgres connection string. │--databaseUrl, DATABASE_URI, DATABASE_URL │
├───────────────────────────┼────────────────────────────────────────────┼──────────────────────────────────────────────────────────┤
│port* │The port to serve content from. │-p, --port │
├───────────────────────────┼────────────────────────────────────────────┼──────────────────────────────────────────────────────────┤
│[debugMode] = false │Debug mode. │-D, --debug │
├───────────────────────────┼────────────────────────────────────────────┼──────────────────────────────────────────────────────────┤
│help │Show this help. │--help │
├───────────────────────────┼────────────────────────────────────────────┼──────────────────────────────────────────────────────────┤
│version │Show the current version. │--version │
╰───────────────────────────┴────────────────────────────────────────────┴──────────────────────────────────────────────────────────╯
- [ ] Enum support.
- [ ] Inverting boolean flags with
--no-debug
versus--debug
. - [ ] Plugin modules with minimal overhead. (e.g. 3rd party loaders: AWS SSM, AppConfig, Firebase Config, etc.)
- Example args:
{ssm:/app/flags/path/admin_dashboard}
['{ssm:/app/flags/path/admin_dashboard}', 'FLAG_ADMIN_DASHBOARD_ENABLED', '--flagAdminDashboard', '--flag-admin-dashboard']
- Example args:
- [ ] Support for loading files, and structured data with dotted key paths.
- Example args:
{config.flags.admin_dashboard}
['{config.flags.admin_dashboard}', 'FLAG_ADMIN_DASHBOARD_ENABLED', '--flagAdminDashboard', '--flag-admin-dashboard']
- Example args:
- [x] Auto
--help
output. - [x]
--version
output. - [x]
default
values. - [x]
required
values. - [x] Zod validators for
optional
,min
,max
,gt
,gte
,lt
,lte
.
Projects researched, with any notes on why it wasn't a good fit.
-
yargs - like the fluent API, and command syntax. Could use as base library. Env vars could be handled via
default
helper function to check for env keys. Or we could transform yargs config into overlapping format. - commander - like the many ways to configure arguments. Could probably be used as underlying library, however initial attempt was slower than starting from scratch.
- cosmiconfig - focused too much on disk-backed config.
- rc - focused on 'magically' locating disk-backed config.
- node-convict - great pattern, but limited TypeScript support.
- nconf - setter & getter, plus the hierarchy adds extra layers.
- conf - too opinionated (writing to disk.) Interesting use of JSON Schemas, Versioning, and Migrations.
- gluegun - great design, focused on opinionated design of CLI apps though.
- configstore - replaced by conf.
Details
- auto-config
- elite-libs
- almost 3 years ago
- MIT
- 25 dependencies
Assets
- auto-config-1.0.1-npm.tgz
Download activity
- Total downloads 0
- Last 30 days 0
- Last week 0
- Today 0