zParse is a high-performance Rust library and toolchain for parsing and converting JSON, CSV, TOML, YAML, and XML. It ships as a library, a CLI, and an HTTP API so you can integrate it in other Rust projects or expose it to a frontend.
- Native parsers for JSON, CSV, TOML (with native datetime types), YAML 1.2, and XML
- Streaming/event-based parsing with depth and size limits
- Format conversion between all supported formats
- CLI for conversion with stdin/stdout support
- Axum API for programmatic access
use zparse::{from_csv_str, from_csv_str_with_delimiter, from_str, from_toml_str, from_yaml_str, from_xml_str};
let json_value = from_str(r#"{"name": "zparse"}"#)?;
let toml_value = from_toml_str("name = \"zparse\"\n")?;
let yaml_value = from_yaml_str("name: zparse\n")?;
let xml_doc = from_xml_str("<root><name>zparse</name></root>")?;
let csv_value = from_csv_str("name,age\nzparse,2\n")?;
// Custom CSV delimiter (semicolon, tab, pipe, etc.)
let tsv_value = from_csv_str_with_delimiter("name\tage\nzparse\t2\n", b'\t')?;
# Ok::<(), zparse::Error>(())use zparse::{convert, Format};
let out = convert(r#"{"name":"zparse"}"#, Format::Json, Format::Toml)?;
let csv_out = convert(r#"[{"name":"zparse","age":2}]"#, Format::Json, Format::Csv)?;
# Ok::<(), zparse::Error>(())Top-level flags (--parse / --convert) mirror the subcommands and still accept --from / --to when you want to be explicit.
Root-level flags cannot be combined with subcommands.
By default, successful commands print ok. Use --print-output to write the input/converted content instead.
JSONC notes:
jsoncis supported as an input format (--from jsoncor.jsoncextension).- Output formats remain
json,toml,yaml, orxml(no--to jsonc). jsonc -> jsonoutputs strict JSON (comments and trailing commas are removed).
# Auto-detect format from file extension and validate
zparse --parse input.json
# Explicitly set the input format while using top-level flags
zparse --parse input.json --from json
# Auto-detect format from file extension and echo on success
zparse --parse input.json --print-output
# Validate JSON input and print "ok" on success
zparse parse --from json input.json
# Validate TOML input and print "ok" on success
zparse parse --from toml input.toml
# Validate JSON and echo the original content on success
zparse parse --from json --print-output input.json
# Convert JSON to TOML and print "ok" on success
zparse convert --from json --to toml input.json
# Convert CSV to JSON
zparse convert --from csv --to json input.csv
# Parse a TSV file (tab-separated values)
zparse parse --from csv --csv-delimiter $'\t' input.tsv
# Convert a pipe-delimited CSV to JSON
zparse convert --from csv --to json --csv-delimiter '|' input.csv
# Convert TOML to YAML with format inference for the input
zparse convert --to yaml input.toml
# Auto-detect input format and convert to TOML
zparse --convert input.json --to toml
# Convert JSON to YAML and print the converted output on success
zparse convert --from json --to yaml --print-output input.json
# Convert XML from stdin to JSON and write to stdout
cat input.xml | zparse convert --from xml --to json
# Convert JSON to TOML, write output to a file, and print "ok" to stdout
zparse convert --from json --to toml --output output.toml input.json
# Convert permissive JSON (comments + trailing commas) to YAML
zparse convert --from json --to yaml --json-comments --json-trailing-commas input.json
# Convert JSONC to strict JSON (comments/trailing commas removed)
zparse convert --from jsonc --to json input.jsonc --print-output
# Convert JSONC input to CSV (comments/trailing commas are accepted and normalized)
zparse convert --from json --to csv --json-comments --json-trailing-commas input.jsonc- Use either a subcommand (
parse/convert) or a top-level flag (--parse/--convert), not both. --tois required for convert.--fromis optional when an input file path is provided (auto-detects by extension)..jsoncfiles auto-enable JSON comments and trailing commas during parsing.- When reading from stdin, you must pass
--from.
cargo run -p zparse-apicurl -s http://127.0.0.1:3000/api/health
curl -s -X POST http://127.0.0.1:3000/api/convert \
-H "Content-Type: application/json" \
-d '{"content":"{\"name\":\"zparse\"}","from":"json","to":"toml"}'Build the WASM package:
wasm-pack build --target web crates/zparse-wasmRun WASM tests in Node:
wasm-pack test --node crates/zparse-wasmUse from JavaScript:
import init, { convert, parse, detect_format, convert_csv } from "./pkg/zparse_wasm.js";
await init();
const toml = convert('{"name":"zparse"}', "json", "toml");
const json = parse("name = \"zparse\"", "toml");
const fmt = detect_format("data.csv"); // "csv"
// Custom CSV delimiter (e.g. tab-separated)
const tsvJson = convert_csv("name\tage\nzparse\t2", "json", "\t");See CONTRIBUTING.md for guidelines and workflow details.
This project is licensed under the GPL-3.0 License.
See CHANGELOG.md for version history and release notes.