JSONPATH_NG(1)

📦 version 1.8.0, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ jsonpath_ng(1) ✨

okay bestie, gather round, because this is the manual page for jsonpath_ng, a User Command, and honestly? she's iconic. let's get into it 💅

🌸 NAME 🌸

jsonpath_ng — search JSONPath into JSON files. that's the whole vibe. you point her at JSON, she goes digging. no cap.

🦋 DESCRIPTION 🦋

the usage line, literally verbatim, don't @ me:

usage: jsonpath_ng [-h] expression [file ...]

so basically: she searches JSON files (or stdin, if you're feeling mysterious) according to a JSONPath expression. that's it. that's the gig. and she ate. 💖

🎀 positional arguments 🎀

these are the things you just... hand her. no dashes, no ceremony. just vibes.

  • expression — a JSONPath expression. this is the little spell you cast to tell her what to look for. main character energy fr fr.
  • file — files to search. and if you give her none? she searches stdin instead. she's flexible like that. lowkey iconic. 🫶

💜 options 💜

  • -h, --help — show this help message and exit. she will simply tell you everything she knows and then dip. queen behaviour.

👑 Quick JSONPath reference 👑

(see more at https://github.com/kennknowles/python-jsonpath-rw — go read it, iykyk)

atomics:

  • $ — root object. the very top. the mother of all objects. 🌈
  • `this` — current object. like, this one, right here, the one we're standing in. 💫

operators:

  • path1.path2 — same as xpath /. nesting, but make it JSON. 🪆
  • path1|path2 — union. both of them. why choose? ✨
  • path1..path2 — somewhere in between. she'll find it. she always finds it. 🔍

fields:

  • fieldname — field with name. the classic. the blueprint. 💖
  • * — any field. wildcard behaviour, very unbothered, very slay. ⭐
  • [_start_?:_end_?] — array slice. and also [*] — any array index. slicing and dicing, no notes. 🍓
ngl bestie, that's the whole page. short, sweet, and she does exactly what she says on the tin. no bugs to warn you about here, no deprecated anything, no exit statuses hiding in the shadows. just pure JSONPath joy. 💀✨

and that's a wrap on the jsonpath_ng manual, brought to you by jsonpath_ng 1.5.3 from way back in July 2023 — yes she's vintage, yes she still serves. mwah. 💅💖🎀

📦 where this page comes from