mikeleppane/envx v0.5.0

Release v0.5.0

on GitHub

Release Notes - envx v0.5.0

🎉 What's New

We're excited to announce envx v0.5.0, a major release that introduces powerful new features for environment variable management. This release focuses on helping developers understand and maintain their environment configurations with new dependency tracking and documentation generation capabilities.

✨ New Features

📊 Dependency Tracking

Introducing the new deps command - a comprehensive solution for understanding how environment variables are used across your codebase.

Find Variable Usage
Instantly see where any environment variable is used in your project, including file locations, line numbers, and code context.

envx deps show DATABASE_URL

**Identify Unused Variables
**
Discover environment variables that are defined but never used in your code, helping you maintain a clean configuration.

envx deps --unused

Usage Statistics
Get insights into which environment variables are used most frequently across your project.

envx deps stats

Supported Languages: JavaScript/TypeScript, Python, Rust, Go, Java, C#, C/C++, Ruby, PHP, Shell scripts, PowerShell, Batch files, and Makefiles.

🗑️ Safe Cleanup
The new cleanup command helps you safely remove unused environment variables:

# Preview what would be removed
envx cleanup --dry-run

# Remove with patterns to keep certain variables
envx cleanup --keep "DEBUG*" --keep "*_TEST"

⚠️ Important Notice: The dependency analysis uses pattern matching and heuristics to detect environment variable usage across different programming languages. While it covers many common patterns, it may not catch all edge cases such as:

• Variables constructed dynamically at runtime
• Variables accessed through reflection or metaprogramming
• Custom environment variable wrappers or abstractions
• Variables in minified or obfuscated code
• Indirect usage through third-party libraries

Always review the results carefully before removing variables, especially in production environments.

📝 Documentation Generation

Automatically generate comprehensive documentation for your environment variables:

# Generate markdown docs to stdout
envx docs


# Generate markdown documentation
envx docs --output ENV_VARS.md

# Include only required variables
envx docs --required-only

Features:

• Automatic discovery from project configuration
• Security-conscious with automatic masking of sensitive values
• Markdown-formatted output ready for your README
• Integration with config.yaml project files

🔧 Improvements