GitHub
07/27/2025, 3:13 AM~/.meltanorc as requested in #9256, plus plugin-level settings support for enhanced user experience.
### Key Features
• YAML styling configuration: Control indentation, width, quotes via user config
• Plugin settings in user config: Configure plugin settings across all projects
• Proper precedence: Integrates with Meltano's 8-layer settings hierarchy
• CLI integration: Works with all existing meltano config commands
### Usage
Create ~/.meltanorc with:
# YAML styling (addresses issue #9256)
yaml:
indent:
mapping: 4
sequence: 6
width: 120
preserve_quotes: true
# Plugin settings (scope expansion)
plugins:
extractors:
tap-postgres:
host: localhost
port: 5432
### Implementation
• UserConfigStoreManager: Integrates user config into settings precedence
• Enhanced YamlConfigLoader: Supports both YAML styling and plugin configuration
• Documentation updates: Added to settings reference and configuration guide
• Tests: Unit, integration, CLI, and regression coverage
### Precedence Order
User config sits between .env and environment-specific config:
1. Environment variables
2. .env file
3. User config (~/.meltanorc) ← NEW
4. Environment-specific config
5. Project config (meltano.yml)
Fully backward compatible - no breaking changes.
## Summary by Sourcery
Add support for YAML formatting customization and global plugin settings via a user configuration file, integrate this into Meltano’s settings precedence, apply styling during YAML read/write operations, and update CLI, documentation, and tests accordingly.
New Features:
• Introduce YAML styling configuration (indentation, width, quotes, sequence formatting) via user config and environment variables
• Enable global plugin settings in a user configuration file (~/.meltanorc or XDG location)
Enhancements:
• Integrate a new UserConfigStoreManager into Meltano’s settings hierarchy between .env and environment-specific config
• Apply user-defined YAML styling to project files using ruamel.yaml
• Extend existing meltano config commands to respect user-level settings
Documentation:
• Document YAML styling and user configuration file options in reference and guide documentation
Tests:
• Add comprehensive unit and integration tests for YAML styling loader, user plugin config, settings store manager, and CLI user config integration
meltano/meltanoGitHub
07/27/2025, 3:30 AM