jsonschema-cli

A fast command-line tool for JSON Schema validation, powered by the jsonschema crate.

Installation

cargo install jsonschema-cli

Usage

jsonschema [OPTIONS] <SCHEMA>

NOTE: It only supports valid JSON as input.

Options

• -i, --instance <FILE>: JSON instance(s) to validate (can be used multiple times)
• --output <text|flag|list|hierarchical>: Select output style (default: text). text prints the human-friendly summary, while the structured modes emit newline-delimited JSON (ndjson) records with schema, instance, and JSON Schema Output v1 payloads.
• -v, --version: Show version information
• --help: Display help information

Examples:

Validate a single instance:

jsonschema schema.json -i instance.json

Validate multiple instances:

jsonschema schema.json -i instance1.json -i instance2.json

Emit JSON Schema Output v1 (list) for multiple instances:

jsonschema schema.json -i instance1.json -i instance2.json --output list
{"output":"list","schema":"schema.json","instance":"instance1.json","payload":{"valid":true,...}}
{"output":"list","schema":"schema.json","instance":"instance2.json","payload":{"valid":false,...}}

Features

• Validate one or more JSON instances against a single schema
• Clear, concise output with detailed error reporting
• Fast validation using the jsonschema Rust crate

Output

For each instance:

• text (default): prints <filename> - VALID or <filename> - INVALID. Errors: followed by numbered error messages.
• flag|list|hierarchical: emit newline-delimited JSON objects shaped as:

{
  "output": "list",
  "schema": "schema.json",
  "instance": "instance.json",
  "payload": { "... JSON Schema Output v1 data ..." }
}

Exit Codes

• 0: All instances are valid (or no instances provided)
• 1: One or more instances are invalid, or there was an error

License

This project is licensed under the MIT License.