This repo moved to https://github.com/spacetab-io/configuration-js
Production-ready configuration for microservices. Written in TypeScript. Library works with nodejs apps and with browsers*.
Library created for follow up corporate standards of application configuration.
npm install --save @microparts/configuration-js
// or
yarn add @microparts/configuration-js
By default path to configuration directory and application stage
loading from /app/configuration
with local
stage.
- Simple
import { Configuration } from '@microparts/configuration-js';
const conf = new Configuration();
conf.load();
console.log(conf.all()); // get all config
console.log(conf.get('foo.bar')); // get nested key use dot notation
- If u would like override default values, you can pass 2 arguments to class constructor or set up use setters.
import { Configuration } from '@microparts/configuration-js';
const conf = new Configuration('./configuration', 'test');
// or
// conf.path = './configs';
// conf.stage = 'local';
conf.load();
conf.get('foo'); // full example on the top
- If the operating system has an env variables
CONFIG_PATH
andSTAGE
, then values for the package will be taken from there.
export CONFIG_PATH=/configuration
export STAGE=prod
import { Configuration } from '@microparts/configuration-js';
const conf = new Configuration('./configuration', 'test');
conf.load(); // loaded files from /configuration for prod stage.
conf.get('foo'); // full example on the top
- If u want to see logs and see how load process working, pass you logger to property:
Pass it like this:
import { Configuration, StdoutConsoleLogger } from '@microparts/configuration-js';
const conf = new Configuration();
conf.logger = new StdoutConsoleLogger();
conf.load();
conf.get('foo'); // full example on the top
Or if you would like use external logger, like Winston, you can integrate it with LoggerInterface. Just a write the adapter like as WinstonConsoleLogger.
For now, by default library support one Winston transport called Console
.
Okay, let's go use adapter for him...
First, install logger:
npm install --save winston
// or yarn add winston
Second, pass you logger to property like this:
import { Configuration, WinstonConsoleLogger, StdoutConsoleLogger } from '@microparts/configuration-js';
const conf = new Configuration();
conf.logger = new WinstonConsoleLogger(winston.createLogger({
transports: [new winston.transports.Console()]
}));
conf.load();
conf.get('foo'); // get value of `foo`
Note:
https://github.com/microparts/static-server-php is required for usage on the server/cloud.
For most cases, this Dockerfile can help your application build's in the cloud.
It simple. Step by step:
- Create an vue app for example
vue create vue-app
- Install this package
npm install --save @microparts/configuration-js
- Put config files like this
- Change
vue.config.js
to build final config to global variables:
const { Configuration, StdoutConsoleLogger } = require('@microparts/configuration-js');
module.exports = {
lintOnSave: false,
chainWebpack: config => {
config.plugin('html').tap(options => {
const conf = new Configuration('./configuration');
conf.logger = new StdoutConsoleLogger(); // new StdoutConsoleLogger(true); // for debug
conf.load();
options[0].__config = conf.asEscapedJson();
options[0].__stage = conf.stage;
return options;
});
}
};
- Add following code to
index.html
to top of<head>
html tag (before all scripts):
<head>
<% if (htmlWebpackPlugin.options.__stage === 'local') { %>
<script>
window.__config = JSON.parse("<%= htmlWebpackPlugin.options.__config %>");
window.__stage = '<%= htmlWebpackPlugin.options.__stage %>';
window.__vcs = '';
</script>
<% } %>
<!-- ... meta tags and other code -->
- Add globals to
.eslintrc
:
"globals": {
"__config": "readonly",
"__stage": "readonly",
"__vcs": "readonly"
},
- Run application.
npm run serve
Full example available at here.
The MIT License
Copyright © 2020 spacetab.io, Inc. https://spacetab.io
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.