qenv/README.md

44 lines
2.1 KiB
Markdown
Raw Normal View History

2019-08-06 15:37:07 +00:00
# @pushrocks/qenv
2016-12-31 18:26:32 +00:00
easy promised environments
2019-08-06 15:37:07 +00:00
## Availabililty and Links
* [npmjs.org (npm package)](https://www.npmjs.com/package/@pushrocks/qenv)
* [gitlab.com (source)](https://gitlab.com/pushrocks/qenv)
* [github.com (source mirror)](https://github.com/pushrocks/qenv)
* [docs (typedoc)](https://pushrocks.gitlab.io/qenv/)
2016-12-31 18:26:32 +00:00
## Status for master
2019-08-06 15:37:07 +00:00
[![build status](https://gitlab.com/pushrocks/qenv/badges/master/build.svg)](https://gitlab.com/pushrocks/qenv/commits/master)
[![coverage report](https://gitlab.com/pushrocks/qenv/badges/master/coverage.svg)](https://gitlab.com/pushrocks/qenv/commits/master)
[![npm downloads per month](https://img.shields.io/npm/dm/@pushrocks/qenv.svg)](https://www.npmjs.com/package/@pushrocks/qenv)
[![Known Vulnerabilities](https://snyk.io/test/npm/@pushrocks/qenv/badge.svg)](https://snyk.io/test/npm/@pushrocks/qenv)
[![TypeScript](https://img.shields.io/badge/TypeScript->=%203.x-blue.svg)](https://nodejs.org/dist/latest-v10.x/docs/api/)
[![node](https://img.shields.io/badge/node->=%2010.x.x-blue.svg)](https://nodejs.org/dist/latest-v10.x/docs/api/)
[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-prettier-ff69b4.svg)](https://prettier.io/)
2016-06-19 18:08:34 +00:00
## Usage
2016-12-31 18:26:32 +00:00
Use TypeScript for best in class instellisense.
2018-08-12 22:45:57 +00:00
qenv works with two files:
- **qenv.yml** - specifies which ENV vars are required.
- **env.yml** - specifies all env vars that are not already set in the current environment.
Now obviously you can set build specific env vars in many CI environments.
So there we do not need an **env.yml** since all ENV vars are in place
However when on another machine you can have a env.yml that will be added to the environment by qenv.
```javascript
import { Qenv } from 'qenv';
2018-08-13 19:58:18 +00:00
const myQenv = new Qenv('path/to/dir/where/qenv.yml/is/', 'path/to/dir/where/env.yml/is(');
2018-08-12 22:45:57 +00:00
```
2016-06-20 09:04:16 +00:00
2019-08-06 15:37:07 +00:00
For further information read the linked docs at the top of this readme.
2017-05-12 15:56:51 +00:00
> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
2019-09-13 09:20:47 +00:00
| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy)
2016-06-20 09:04:16 +00:00
2019-09-13 09:20:47 +00:00
[![repo-footer](https://lossless.gitlab.io/publicrelations/repofooter.svg)](https://maintainedby.lossless.com)