Skip to content

mason-rogers/envuments

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Envuments - Your ideal config system

Downloads npm bundle size Version License

Envuments is an application configuration program that provides the ability to work with with .env files or your own seeded config. The purpose of Envuments is to allow templating in your configuration files. Currently we support .env files as well as allowing you to seed your own config. Syntax for templating and implementation can be found below.

When working with .env files, Envuments acts as an extension to the dotenv package which can be found here.

 

Implementation

.env

APP_PORT=8443
APP_URL=http://localhost:${APP_PORT}

JavaScript usage exaple

const { Envuments } = require('envuments');

const configValue = Envuments.get("APP_URL", "https://viction.dev");

console.log(configValue); // http://localhost:8443

TypeScript usage example (without annotations)

import { Envuments } from 'envuments';

const configValue = Envuments.get("APP_URL", "https://viction.dev");

console.log(configValue); // http://localhost:8443

TypeScript usage example (with annotations)

import { Env } from 'envuments';

class ExampleConfig {
    @Env("APP_URL", "https://viction.dev")
    public readonly url: string;
}

console.log(new ExampleConfig().url); // http://localhost:8443 

 

Seeding your own config

index.js

const { Envuments } = require('envuments');

Envuments.SeedConfig({
    APP_PORT: 8443,
    APP_URL: "http://localhost:${APP_PORT}"
});

const config = new Envuments();

const configValue = config.get("APP_URL", "https://viction.dev");

console.log(configValue); // http://localhost:8443

If you want any configuration methods to be implemented please open an issue.