toddbluhm/env-cmd
Env Cmd
This project is a command-line utility that executes processes by injecting environment variables from local configuration files. It functions as a runtime wrapper, allowing developers to manage application settings and process execution contexts without modifying global system variables.
The tool distinguishes itself by supporting dynamic configuration loading, which allows for the use of files that export objects or promises to compute values at runtime. It provides granular control over environment management, including the ability to group variables into named collections, protect existing environment variables from being overwritten, and handle missing configuration files gracefully.
Beyond basic injection, the utility facilitates cross-platform script execution and automated build pipeline management by replacing placeholders within command arguments with resolved environment values. It creates isolated child processes to ensure that configuration settings remain scoped to specific tasks, maintaining consistent behavior across different development and deployment environments.
Features
- Shell Command Runners - Acts as a runtime wrapper that applies file-based environment settings to shell commands without modifying global system variables.
- Environment Variable Loaders - Executes processes with environment variables injected from local configuration files.
- Runtime Environment Variable Injections - Injects configuration variables into a child process environment before executing a command to isolate settings from the parent shell.
- Application Configuration - Loads structured environment settings into application processes to manage secrets and dynamic parameters without hardcoding values into the source code.
- Environment Variable Managers - Injects configuration from files into shell processes to support environment-specific settings without modifying global system variables.
- Scoped Environment Variable Injections - Applies specific environment variables from designated files before command execution to support environment-specific configurations.
- Dynamic Placeholder Expansion - Replaces placeholders within command arguments with actual environment variable values at runtime.
- Cross-Platform Script Runners - Runs shell commands with injected environment variables to maintain consistent application behavior across different operating systems and deployment environments.
- Command Argument Resolvers - Scans command-line arguments for variable tokens and replaces them with resolved values from the environment before the process starts.
- Dynamic Module Loading - Imports configuration files as executable code to support computed values and asynchronous data fetching during the environment setup phase.
- Dynamic Configuration Loaders - Supports importing environment variables from files that export objects or promises, enabling computed values and dynamic settings.
- Node.js Process Management - Manages environment-specific configurations and process execution contexts within Node.js development and deployment workflows.
- Shell Command Execution - Creates a new operating system process to run commands within a modified environment context that persists for the duration of the task.
- Build and Task Automation - Executes build and deployment tasks with dynamic environment variables to ensure consistent behavior across different development and production stages.
- File-Based Configurations - Reads and transforms external text or script files into structured key-value pairs for dynamic environment variable assignment.
