1.0.5 • Published 12 months ago
swiftenv v1.0.5
swiftEnv
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
Function | Parameters | Description |
---|---|---|
getEnv | key: string, defaultValue?: | Retrieves the value of the specified environment |
string | variable.If not found, returns defaultValue | |
setEnv | key: string, value: string | Sets or updates an environment variable in both |
filePath?: string | the process and env | |
listEnv | none | Returns an object containing all loaded |
environment variables. | ||
validateEnv | keys: string[]: | Validates that all specified keys are present in |
the environment variable.If not throws error | ||
numberEnv | key: string | Converts the specified environment variable to a |
number and returns it. | ||
removeEnv key: string, filePath?: : | Removes an environment variable from both the | |
string | process and the .env file. |