# ConfigForge

![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
![License](https://img.shields.io/badge/License-MIT-green)
![Version](https://img.shields.io/badge/Version-1.0.0-orange)

A powerful CLI tool for validating, converting, and generating schemas for configuration files. Supports JSON, YAML, TOML, and ENV formats with JSON Schema validation, format conversion, TypeScript interface generation, and an interactive schema wizard.

## Features

- **Validate** configuration files against JSON Schema with detailed error reporting
- **Convert** between configuration formats (JSON, YAML, TOML, ENV)
- **Generate** TypeScript interfaces from JSON Schema or sample data
- **Interactive Schema Wizard** for creating schemas without writing JSON
- **Multiple Output Formats** - JSON, YAML, table, and colored terminal output
- **Dry Run Mode** - Preview validation errors without failing

## Installation

```bash
pip install -e .
```

## Quick Start

```bash
# Validate a configuration file
configforge validate config.json schema.json

# Convert between formats
configforge convert config.yaml --format toml

# Generate TypeScript interfaces
configforge generate schema.json --interface-name AppConfig

# Create a new schema interactively
configforge schema --output schema.json
```

## Commands

### validate

Validate a configuration file against a JSON Schema:

```bash
configforge validate config.json schema.json
configforge validate config.yaml schema.json --format table
configforge validate config.toml schema.json --dry-run
```

### convert

Convert a configuration file between formats:

```bash
configforge convert config.json --format yaml
configforge convert app.yaml --output app.toml
configforge convert config.toml --format env
```

### generate

Generate TypeScript interfaces from JSON Schema or config data:

```bash
configforge generate schema.json --interface-name AppConfig
configforge generate config.json --from-data --output types.ts
```

### schema

Interactively generate a JSON Schema:

```bash
configforge schema --output schema.json
configforge schema --format yaml
configforge schema --from-config config.json
```

## Supported Formats

| Format | Extensions | Read | Write |
|--------|------------|------|-------|
| JSON   | .json      | ✓    | ✓     |
| YAML   | .yaml, .yml| ✓    | ✓     |
| TOML   | .toml      | ✓    | ✓     |
| ENV    | .env       | ✓    | ✓     |

## Development

```bash
pip install -e ".[dev]"
pytest tests/
ruff check .
mypy configforge/
```

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests
5. Submit a pull request

## License

MIT License - see LICENSE file for details.