GJSON(1)

💖 NAME 💖

gjson — filter and extract data from JSON-like files. Bestie, this is the manual page for gjson, and she's here to serve you exactly the slice of JSON you asked for. 🍓

It's a simple way to filter and extract data from JSON-like data structures, and it's the Python porting of the Go GJSON package. Yes, the iconic Go tool said "let me learn Python" and now we all win. 💅

usage: gjson [-h] [-v] [-l] [file] query

That's the whole vibe up there — one optional file, one query, and a couple of little flags. Spot the -h chillin' in there too. 👑

---

🌸 POSITIONAL ARGUMENTS 🌸

• file — the input JSON file you wanna query, bestie. If this argument is missing, or if you set it to "-", it reads from stdin instead. So yes, you can absolutely pipe things into her, she's flexible like that. 🫶
• query — a GJSON query to apply to the input data. This is the actual star of the show, the main character, the reason we're all here. ✨

---

🎀 NAMED ARGUMENTS 🎀

• -v, --verbose — verbosity level, and the default is quiet, no cap. By default, on error no output will be printed. Use -v to get the error message to stderr, and -vv to get the full traceback. So like, one v is "hey something's wrong", two vs is "here's the whole receipts, the full story, every frame of the movie". 😭
• -l, --lines — treat the input as JSON Lines, parse each line, and apply the query to each line. Perfect for when your data is a whole stack of lil JSONs stacked on top of each other instead of one big blob. 🦋

Also, the full documentation is literally right here, bestie: <https://volans-.github.io/gjson-py/index.html> — go read it, it's giving ✨comprehensive✨.

---

💜 Author 💜

Riccardo Coccioli — the legend, the blueprint, the reason this exists. 👑

---

👑 Copyright 👑

2022, Riccardo Coccioli</purl> 2022, Riccardo Coccioli — that's the copyright line, keeping it real since 2022. 🎀

---

Okay and for the cute sign-off: this whole page is version 1.1.0, dated Nov 23, 2025. Slay, periodt, go query something gorgeous. 💖✨🦋🌸