json-colorizer

A high-performance JSON formatter, pretty-printer, colorizer, and query tool for Rust — with advanced jq-style queries and NDJSON support.

Features

• 🎨 Powerful Colorization — Vibrant syntax highlighting using a high-performance formatter.
• 🔍 Advanced Queries — Support for wildcards (.*, []), array slicing ([0:5]), and multiple results.
• 🥞 NDJSON Support — Process streams of multiple JSON objects (Newline Delimited JSON).
• 📐 Pretty-print — Configurable indentation and key sorting.
• 📦 Compact mode — Minified single-line output.
• 🔌 Library & CLI — Clean API for Rust projects or a standalone CLI tool.
• ⚡ High Performance — Leverages serde_json::ser::Formatter for efficient streaming output.

Install (CLI)

cargo install json-colorizer

CLI Usage

# Pretty-print with colors
echo '{"name":"Alice","scores":[95,87]}' | json-colorizer

# Sort object keys alphabetically
cat data.json | json-colorizer -S

# Advanced Querying (Wildcards & Slices)
# Get all names from an array of objects
echo '[{"name":"Alice"},{"name":"Bob"}]' | json-colorizer -q '[].name'

# Array slicing
echo '[0,1,2,3,4,5]' | json-colorizer -q '[0:3]'

# Raw output (omit quotes for strings, ideal for piping)
json-colorizer test.ndjson -q ".tags[]" -r

# Process NDJSON (multiple objects)
cat log.ndjson | json-colorizer -q '.message'

CLI Flags

Library Usage

Add to your Cargo.toml:

[dependencies]
json-colorizer = "0.1"

use json_colorizer::{format_json, format_json_compact, query, FormatOptions, Theme};
use serde_json::json;

let data = json!({
    "users": [
        {"name": "Alice", "score": 95},
        {"name": "Bob", "score": 87}
    ]
});

// Pretty-print (with default theme)
println!("{}", format_json(&data, &FormatOptions::default()));

// Query (returns a Vec of matches)
let results = query(&data, ".users[].name").unwrap();
assert_eq!(results, vec![&json!("Alice"), &json!("Bob")]);

// Custom Formatting
let opts = FormatOptions {
    indent: 4,
    color: true,
    sort_keys: true,
    theme: Theme::default(),
};
println!("{}", format_json(&data, &opts));

API

Types

• FormatOptions — indent, color, sort_keys, theme
• Theme — Customizable colors for key, string, number, boolean, null
• QueryError — KeyNotFound, IndexOutOfBounds, InvalidQuery

License

MIT