Bidirectional Format Conversion: Convert between JSON, YAML, and TOML formats
Syntax Validation: Validate configuration files with colored error output
Pretty-Printing: Format output with configurable indentation levels (2, 4, 8 spaces)
JMESPath Query Support: Filter and extract data using JMESPath queries
Stdin/Stdout Pipeline Support: Read from stdin and write to stdout for pipeline integration
Batch File Processing: Process multiple files in batch mode

Installation

pip install config-converter-cli

Or install from source:

git clone <repository>
cd config-converter-cli
pip install -e .

Quick Start

Convert a file

# Convert JSON to YAML
config-converter convert config.json --to yaml -o config.yaml

# Convert YAML to TOML
config-converter convert config.yaml --to toml

# Convert with custom indentation
config-converter convert config.json --to yaml --indent 4

Validate a file

# Validate a JSON file
config-converter validate config.json

# Validate with format hint
config-converter validate config.cfg --format yaml

# Quiet mode (only exit code)
config-converter validate --quiet config.json

Query data

# Query a specific key
config-converter query config.json "server.host"

# Query nested values
config-converter query config.yaml "database.settings.port"

# Use JMESPath expressions
config-converter query config.json "services[?enabled==`true`].name"

Format/pretty-print

# Format with 4-space indentation
config-converter format config.json --indent 4

# Convert and format
config-converter format config.yaml --to json

Batch processing

# Convert multiple files
config-converter batch *.json --to yaml

# Convert to output directory
config-converter batch config1.yaml config2.yaml --to toml --output-dir converted/

Commands

convert

Convert a configuration file from one format to another.

config-converter convert [OPTIONS] [INPUT_FILE]

Options:

--from, -f FORMAT: Input format (auto-detected if not specified)
--to, -t FORMAT: Output format (required)
--indent, -i LEVEL: Indentation level (2, 4, or 8)
--output, -o FILE: Output file
--validate/--no-validate: Validate input before conversion

validate

Validate the syntax of a configuration file.

config-converter validate [OPTIONS] [INPUT_FILE]

Options:

--format, -F FORMAT: Format hint (auto-detected if not specified)
--quiet, -q: Only return exit code, no output

query

Query configuration data using JMESPath.

config-converter query [OPTIONS] [INPUT_FILE] EXPRESSION

Options:

--format, -F FORMAT: Format hint (auto-detected if not specified)
--output, -o FORMAT: Output format (json or text)

format

Format/pretty-print a configuration file.

config-converter format [OPTIONS] [INPUT_FILE]

Options:

--indent, -i LEVEL: Indentation level (2, 4, or 8)
--to, -t FORMAT: Output format
--compact, -c: Use compact output

batch

Convert multiple files in batch mode.

config-converter batch [OPTIONS] INPUT_FILES...

Options:

--from, -f FORMAT: Input format (auto-detected if not specified)
--to, -t FORMAT: Output format (required)
--indent, -i LEVEL: Indentation level (2, 4, or 8)
--output-dir, -o DIR: Output directory for converted files

Pipeline Support

All commands support stdin/stdout with -:

# Read from stdin
cat config.json | config-converter convert --to yaml

# Write to stdout
config-converter convert config.json --to yaml > config.yaml

# Chained pipelines
cat config.json | config-converter query "server" | config-converter format --indent 4

Examples

CI/CD Pipeline Integration

# Validate configuration in CI
config-converter validate --quiet config/$ENV/config.json || exit 1

# Convert and deploy
config-converter convert config/$ENV/app.json --to yaml | kubectl apply -f -

Configuration Transformation

# Extract specific settings
config-converter query config.json "database.settings" > db_settings.json

# Reformat with consistent indentation
config-converter format config.yaml --indent 4 --to json > config_formatted.json

JMESPath Queries

# Get all enabled services
config-converter query config.json "services[?enabled==`true`].name"

# Get nested values
config-converter query config.yaml "server.tls.cert_path"

# Transform output
config-converter query config.json "{host: server.host, port: server.port}"

Configuration

No configuration file required. All options are passed via command-line arguments.

Error Handling

The tool provides detailed error messages with:

Line and column numbers for syntax errors
Colored output for better visibility
Context snippets around error locations

Contributing

Fork the repository
Create a feature branch
Make your changes
Run tests: pytest -v
Submit a pull request

License

MIT License