1.0.5 • Published 12 months ago

swiftenv v1.0.5

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months 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

12 months ago

1.0.4

12 months ago

1.0.3

12 months ago

1.0.2

12 months ago

1.0.1

12 months ago

1.0.0

12 months ago