Environmentality NPM

About The Project

This package lets you easily manage your environment variables and dotenv files. It is designed to be as simple as possible to use and to be as flexible as possible.

When an environement variable is missing, it will throw an error or use a default value. It also can be used to convert environment variables to other types like numbers or booleans.

It may be used with dotenv and dotenv-expand but can also be used without them.

Built With

Getting Started

Installation

npm install environmentality

Usage

Environment variables

TEST_STRING=Hello World
TEST_NUMBER=42
TEST_BOOLEAN=true
TEST_ENUM=test

Code

import { Env, EnvVar } from 'environmentality'

@Env()
class Env {

  @EnvVar()
  readonly TEST_STRING?: string

  @EnvVar({ type: "number" })
  readonly TEST_NUMBER?: number

  @EnvVar({ type: "boolean", name: "TEST_BOOLEAN" })
  readonly myBool?: boolean

  @EnvVar({ type: "enum", enumValues: ["test", "lmao"] })
  readonly TEST_ENUM?: "test" | "lmao"

}

const env = new Env()

console.log(env.TEST_STRING) // Hello World

Roadmap

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!