1.0.5 • Published 1 year ago

swiftenv v1.0.5

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

swiftEnv

npm version GitHub Actions Workflow Status License: MIT

swiftEnv is a lightweight, dependency-free library for managing environment variables. It provides simple utilities to load, get, set, update, remove, and validate environment variables directly from a .env file, offering a straightforward solution for environment configuration without relying on external dependencies.

Features

  • Zero Dependencies: No external libraries required.
  • Simple API: Easily get, set, update, and remove environment variables.
  • Environment Validation: Validate required environment variables at runtime.
  • Automatic .env File Creation: Ensures a .env file exists or creates one if it doesn't.
  • TypeScript Support: Written in TypeScript with type definitions included.
  • Utility Functions: Additional utility functions for common environment variable operations.

Installation

You can install Env Manager via npm:

npm install swiftenv

Usage

1. Import the Module

    import { getEnv, setEnv, removeEnv, listEnv, validateEnv, numberEnv } from 'swiftenv';

Get an environment variable

    const secret = getEnv('secret');

Get multiple environment variables

    const {secret, port} = listEnv();

Convert environment variable to number

    const port = numberEnv('DB_PORT');

Validate environment variables

    if(validateEnv(['DB_HOST', 'DB_PORT']))
    {
        console.log("Environment Variables Exists")
    }

Set environment variable (Development Only)

    setEnv('API_KEY', 'your-api-key');
    //ensure you remove this part before publishing to avoid exposing values

Remove environment variable (Development Only)

    removeEnv('API_KEY');
    //ensure you remove this part before publishing 

Function Reference

FunctionParametersDescription
getEnvkey: string, defaultValue?:Retrieves the value of the specified environment
stringvariable.If not found, returns defaultValue
setEnvkey: string, value: stringSets or updates an environment variable in both
filePath?: stringthe process and env
listEnvnoneReturns an object containing all loaded
environment variables.
validateEnvkeys: string[]:Validates that all specified keys are present in
the environment variable.If not throws error
numberEnvkey: stringConverts the specified environment variable to a
number and returns it.
removeEnv key: string, filePath?: :Removes an environment variable from both the
stringprocess and the .env file.
1.0.5

1 year ago

1.0.4

1 year ago

1.0.3

1 year ago

1.0.2

1 year ago

1.0.1

1 year ago

1.0.0

1 year ago