feat: Enhance scan-missing-env-vars.py to detect defaults, types, and categorize output

[silentoplayz]

Pull Request Checklist

Changelog Entry

Description

• Improved the scan-missing-env-vars.py script to provide more detailed information about environment variable usage in the codebase. The script now detects default values, infers variable types, and categorizes undocumented variables for better analysis of environment variable configurations.

Added

• Detection of default values for environment variables accessed via os.getenv, os.environ.get, and PersistentConfig.
• Inference of variable types (str, int, bool, list[dict], dict, tuple, set) for environment variables, especially within PersistentConfig.
• Categorized output for undocumented environment variables, separating PersistentConfig variables from other undocumented variables.
• Output includes default values and inferred types for undocumented variables.
• Filenames are now tracked to show where each environment variable is accessed.

Changed

• The find_env_vars function now returns a dictionary containing detailed context for each environment variable (files, default, type) instead of just a set of variable names.
• The output format is enhanced to display default values, types, and file locations for undocumented variables.

Fixed

• Improved accuracy and detail in environment variable scanning compared to the original script, providing a more comprehensive analysis.

---

Additional Information

• This script is used internally to help maintain documentation and ensure all necessary environment variables are documented. The enhanced script provides more granular information, making it easier to identify and document environment variables, especially those used with PersistentConfig and those with default values and specific types.

[tjbck]

💪