jrv-yaml-toolkit
Everything you need to work with YAML files: validate syntax, format/prettify, convert to/from JSON, query with dot-path expressions, merge multiple files, and check against a schema.
Quick Start
# Validate YAML syntax
python3 scripts/yaml_toolkit.py validate config.yaml
# Format/prettify YAML
python3 scripts/yaml_toolkit.py format messy.yaml
# Convert YAML to JSON
python3 scripts/yaml_toolkit.py to-json config.yaml
# Convert JSON to YAML
python3 scripts/yaml_toolkit.py from-json data.json
# Query a value by dot-path
python3 scripts/yaml_toolkit.py get config.yaml "server.host"
# Set a value
python3 scripts/yaml_toolkit.py set config.yaml "server.port" 8080
# Merge multiple YAML files (later files override earlier)
python3 scripts/yaml_toolkit.py merge base.yaml override.yaml
# Lint against a simple schema file
python3 scripts/yaml_toolkit.py lint config.yaml --schema schema.yaml
# List all keys (flattened dot-path)
python3 scripts/yaml_toolkit.py keys config.yaml
# Minify YAML (single-line flow style)
python3 scripts/yaml_toolkit.py minify config.yaml
Commands
| Command | Description |
|---|
validate <file> | Check YAML syntax, report errors with line numbers |
format <file> | Pretty-print YAML with consistent indentation |
to-json <file> | Convert YAML to JSON |
from-json <file> | Convert JSON to YAML |
get <file> <path> | Get value at dot-path (e.g. server.host) |
set <file> <path> <val> | Set value at dot-path, output updated YAML |
merge <file1> <file2> ... | Deep-merge YAML files (right overrides left) |
lint <file> --schema <s> | Validate keys against a schema YAML |
keys <file> | List all keys as flattened dot-paths |
minify <file> | Output compact single-line YAML |
Options
| Flag | Description |
|---|
--output <file> | Write output to file instead of stdout |
--indent N | Indentation spaces (default: 2) |
--allow-unicode | Allow unicode in output (default: true) |
Use Cases
- DevOps: Validate Kubernetes and Docker Compose configs before applying
- CI/CD: Merge environment-specific YAML overrides
- Config management: Query and patch config values programmatically
- Data pipelines: Convert between JSON and YAML for different tools
- Documentation: List all config keys for auto-generated docs
Exit Codes
0 — Success1 — Validation error or key not found2 — File not found or parse error