bkeepers/dotenv
Dotenv
Dotenv is a Ruby library used for loading key-value pairs from files into an application environment. It includes a configuration parser to extract variables into hashes and a loader to inject those pairs into the global environment.
The project features a variable interpolator that resolves environment variables and shell command outputs within configuration values. It also provides a validator to verify that required configuration keys are present during application initialization.
The toolset covers environment variable management, including the ability to generate configuration templates. It also provides utilities to capture and restore environment state snapshots to ensure isolation during automated testing.
Features
- Environment Variables - Loads and manages application configuration via environment variables sourced from files.
- Environment Variable Loaders - Loads key-value pairs from .env files into the Ruby application environment.
- External Environment File Loaders - Extracts key-value pairs from environment files into data structures for inspection.
- Configuration Loading - Injects key-value pairs from dotenv files into a Ruby application environment.
- Application Configuration - Provides a workflow for managing environment-specific settings across different deployment stages.
- Environment Variable Management - Loads and manages runtime environment variables from files to decouple credentials from source code.
- File-Based Loading - Implements loading of environment variables from flat text files into the runtime environment.
- Configuration File Parsers - Transforms raw text files into Ruby hashes by splitting lines on delimiters.
- Configuration Validation - Verifies that specific environment variables exist during initialization to prevent runtime failures.
- Variable Interpolators - Resolves nested variable references and shell command outputs within configuration values.
- Configuration Validation - Verifies the presence of mandatory configuration keys to prevent runtime failures.
- Test Environment Isolation - Isolates global environment variables to prevent configuration leakage between test cases.
- Environment Variable Validation - Validates that required environment variables are present during application initialization.
- Environment State Snapshots - Captures and restores system environment variables to ensure isolation during automated testing.
- Test Sandbox Restoration - Saves and restores environment state to prevent configuration leakage between separate tests.
- Configuration - Loads environment variables from .env files.
- Configuration Management - Loads environment variables from local files.
- Developer Utilities - Environment variable management for local development configurations.
