项目作者: mernxl

项目描述 :
A node JS env and configuration loader with typescript support. Build in support to load with respect to your environment, dev, prod, test
高级语言: TypeScript
项目地址: git://github.com/mernxl/configu.git
创建时间: 2020-09-27T03:34:05Z
项目社区:https://github.com/mernxl/configu

开源协议:MIT License

下载


configu

@xelgrp/configu"">npm
codecov
Dependencies State
TypeScript compatible
Code Style Prettier
semantic-release

A node JS env and configuration loader with typescript support. Build in support to load with respect to your environment, dev, prod etc

Installation

  1. yarn add @xelgrp/configu
  2. or
  3. npm install @xelgrp/configu

Clearer Docs TODO

This package currently supports loading properties files.

NOTE: This library supports configuration files that must be terminated by the extensions to determine its type.

  • .ini, .properties: Properties files
  • .yml, .yaml: Yaml files (Coming Soon)
  • .json: Json configuration files (Coming Soon)

To load a configuration;

  1. import { loadConfig } from '@xelgrp/configu';
  2. interface AppConfig {
  3. host: string;
  4. port: string;
  5. dbPass?: string;
  6. dbUser: string;
  7. }
  8. const defaultConfigs = {
  9. host: 'localhost',
  10. port: 4040,
  11. dbUser: 'root'
  12. }
  13. // export function to use in loading later
  14. export const getConfig = (): AppConfig => loadConfig<AppConfig>('app.ini', defaultConfigs);
  15. export const config = getConfig();

This package loads Configurations in such a way that, the previous config will serve as variables for the next,
override fields in next config file or will become additional fields in the configuration

Considering an app.ini configurations to load, variable loading takes place in the following order;

  • process.env -> app.development.local.ini -> app.development.ini -> app.local.ini -> app.ini & process.env
  • process.env -> app.production.local.ini -> app.production.ini -> app.local.ini -> app.ini & process.env
  • process.env -> app.test.local.ini -> app.test.ini -> app.local.ini -> app.ini & process.env

Configuration variables are loaded from the app.**.ini files in such a way as to match the current environment.
E.g. When NODE_ENV=development, the app.development.ini files are loaded along side the app.ini file and
environment variables.

The NODE_ENV can be changed by any file by setting the NODE_ENV variable. This NODE_ENV variable always defaults to
development.

process.env is loaded at the start to serve as variables for next configurations, it is again loaded at the end together
with the base file so if it was overwritten along the load chain, it will still serve as a final source of truth.

Usually you would not want to commit your .local. files as they may contain variables that do not need committing,
like usernames and passwords normally you will pass them through environment variables at deployment.

NOTE: All config files must be one directory

License

This project is MIT Licensed - see the LICENSE.md file for details