Metadata-Version: 2.4
Name: fmtconv-cli
Version: 0.1.0
Summary: Convert between JSON, YAML, TOML, and INI config formats
Author-email: Marcus <marcus.builds.things@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/fmtconv
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/fmtconv/issues
Keywords: json,yaml,toml,ini,converter,config,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: toml>=0.10
Dynamic: license-file

# fmtconv

Convert between JSON, YAML, TOML, and INI config formats from the command line.

## Install

```bash
pip install fmtconv-cli
```

## Usage

```bash
# Convert between formats
fmtconv to-yaml config.json
fmtconv to-json config.yaml
fmtconv to-toml config.json
fmtconv to-ini config.json
cat config.yaml | fmtconv to-json

# Auto-detect format
fmtconv detect config.yaml          # → yaml

# Validate
fmtconv validate config.json        # → Valid JSON

# Pretty-print in place
fmtconv prettify messy.json

# Write to file
fmtconv to-yaml config.json -o config.yaml

# Sort keys
fmtconv to-json config.yaml --sort-keys

# Machine-readable output
fmtconv detect config.yaml --json   # → {"format": "yaml"}
```

## Commands

| Command | Description |
|---------|-------------|
| `to-json` | Convert to JSON |
| `to-yaml` | Convert to YAML |
| `to-toml` | Convert to TOML |
| `to-ini` | Convert to INI |
| `detect` | Auto-detect format |
| `validate` | Check if input is valid |
| `prettify` | Pretty-print in same format |

All commands accept a file argument or stdin, and support `--json` for machine-readable output.

## For AI Agents

See [SKILL.md](SKILL.md) for agent-optimized documentation.

## License

MIT
