dkit

Swiss army knife for data format conversion and querying.

Convert between JSON, CSV, YAML, and TOML with a single CLI. Query nested data, preview as tables, and pipe everything together.

Quick Start

# Install
cargo install dkit

# Convert JSON to YAML
dkit convert data.json --to yaml

# Query nested data
dkit query config.yaml '.database.host'

# Preview CSV as a table
dkit view users.csv --limit 10

Installation

From crates.io

cargo install dkit

From source

git clone https://github.com/syangkkim/dkit.git
cd dkit
cargo install --path .

Supported Formats

Format	Extensions	Read	Write
JSON	`.json`	O	O
CSV	`.csv`	O	O
YAML	`.yaml`, `.yml`	O	O
TOML	`.toml`	O	O

All 12 conversion paths (4 x 3) are supported.

Commands

`convert` — Format conversion

# Basic conversion
dkit convert data.json --to yaml
dkit convert users.csv --to json
dkit convert config.yaml --to toml
dkit convert config.toml --to json

# Output to file
dkit convert data.json --to csv -o output.csv

# Batch conversion
dkit convert *.csv --to json --outdir ./converted/

# Pipe from stdin
cat data.json | dkit convert --from json --to csv

# Options
dkit convert data.json --to json --compact     # Minified JSON
dkit convert data.tsv --to json --delimiter '\t'  # TSV input
dkit convert data.csv --to json --no-header    # CSV without header

`query` — Data querying

# Field access
dkit query config.yaml '.database.host'
dkit query config.toml '.server.port'

# Nested path
dkit query data.json '.users[0].name'

# Array iteration
dkit query data.json '.users[].email'

# Negative indexing
dkit query data.json '.items[-1]'

Query syntax:

Syntax	Description
`.field`	Object field access
`.field.sub`	Nested field access
`.[0]`	Array index (0-based)
`.[-1]`	Negative index (from end)
`.[]`	Iterate all elements

`view` — Table preview

# View as table
dkit view users.csv

# Limit rows
dkit view large_data.csv --limit 20

# Navigate nested data
dkit view data.json --path '.users'

# Select columns
dkit view users.csv --columns name,email

Comparison with Existing Tools

Feature	dkit	jq	miller	yq
JSON	O	O	O	O
CSV	O	X	O	X
YAML	O	X	X	O
TOML	O	X	X	X
Cross-format convert	O	X	Partial	Partial
Table output	O	X	O	X
Query	O	O	O	O
Single binary	O	O	O	O

dkit focuses on seamless conversion between all supported formats with a unified query syntax, eliminating the need for separate tools per format.

Building from Source

cargo build              # Build
cargo test               # Run tests
cargo clippy -- -D warnings  # Lint
cargo fmt -- --check     # Format check

Contributing

Contributions are welcome! Please see the GitHub Issues for planned features and known issues.

Fork the repository
Create a feature branch (git checkout -b feat/my-feature)
Commit your changes
Push to the branch and open a Pull Request

Please ensure cargo test and cargo clippy -- -D warnings pass before submitting.

License

MIT

dkit 0.1.0