mini-jq 🚀

A lightweight, zero-dependency command-line utility written in pure Python designed to query, filter, and transform JSON data from standard input or files using a simplified dot-notation query language.

Installation

pip install .

Usage

Query JSON data directly from a file or via standard input:

cat data.json | mjq "users[?age > 18].name"

Or pass a file argument:

mjq "store.books[0].title" data.json

Features

• Path Navigation: Traverse nested dictionaries and lists (.store.owner, books[0].title).
• Array Slicing & Projections: Map fields across lists (books[*].title).
• Conditional Filtering: Filter lists using comparison operators (users[?age > 18]).
• Flexible Output: Pretty-printed output by default, or compact minified JSON via -c / --compact.