📄 ConfigBuddy

Manage your configuration files with elegance! 🎨

✨ Features

• 📝 Multiple format support (YAML, JSON, INI)
• 🔍 Smart configuration comparison and visualization
• 🔄 Intelligent configuration merging
• ✅ JSON Schema validation
• 🌳 Tree-style visualization

🚀 Getting Started

Installation

pip install configbuddy

CLI Usage

ConfigBuddy provides a powerful CLI interface for managing your configuration files:

Visualize Configuration

configbuddy visualize config.yaml

Compare Configurations

configbuddy diff base.yaml --compare other.yaml

Merge Configurations

configbuddy merge base.yaml override.yaml -o merged.yaml

Validate Configuration

configbuddy validate config.yaml --schema schema.json

Generate Schema

configbuddy generate-schema config.yaml -o schema.json

Python API Usage

from configbuddy import Config

# Load configuration files
config1 = Config.from_file('config1.yaml')
config2 = Config.from_file('config2.json')

# Visualize configuration
config1.visualize()

# Compare configurations
diff = config1.diff_with(config2)
diff.visualize()

# Merge configurations
merged, conflicts = config1.merge_with(config2)
if conflicts:
    print("Merge conflicts detected:", conflicts)

💡 Examples

Loading and Saving

# Load from YAML
config = Config.from_file('config.yaml')

# Save as JSON
config.save('config.json')

Configuration Comparison

# Compare two configs
diff = config1.diff_with(config2)

# Check differences
print("Added:", diff.added)
print("Removed:", diff.removed)
print("Modified:", diff.modified)

Configuration Merging

# Deep merge (default)
merged, conflicts = config1.merge_with(config2)

# Shallow merge
merged, conflicts = config1.merge_with(config2, strategy='shallow')

Visualization Example

config.yaml
├── database
│   ├── host: "localhost"
│   ├── port: 5432
│   └── credentials
│       ├── username: "admin"
│       └── password: "******"
└── logging
    ├── level: "INFO"
    └── format: "%(asctime)s - %(message)s"

🎯 Use Cases

• 🔄 Manage dev/staging/prod configurations
• 🤝 Share and merge team configurations
• 🔍 Track configuration changes
• 📊 Version control experiment settings (ML/Data Science)

🛣️ Roadmap

• CLI interface
• PyPi Upload
• Comment preservation
• XML/TOML support
• Web dashboard (visualization/comparison)

🤝 Contributing

Bug reports, feature suggestions, and pull requests are welcome! See CONTRIBUTING.md for details.

📝 License

MIT License - see LICENSE for details.

🌟 Star History

---

Made with ❤️ by Harim Kang