Jq ihrisko
| Filter | Popis |
|---|---|
| Prehľadne naformátovať celý dokument | |
| Prejsť každý prvok poľa | |
| Prečítať vnorenú hodnotu podľa cesty | |
| Ponechať iba prvky spĺňajúce podmienku | |
| Transformovať každý prvok poľa | |
| Vypísať kľúče objektu | |
| Previesť objekt na dvojice kľúč/hodnota | |
| Zoskupiť prvky podľa poľa a spočítať ich | |
| Zoradiť pole podľa poľa | |
| Spočítať prvky poľa | |
| Naformátovať riadky ako CSV (zapnite Surový výstup) | |
| Zakódovať reťazec do Base64 (zapnite Surový výstup) | |
| Vypísať cesty všetkých číselných hodnôt | |
| Rekurzívne zozbierať všetky čísla | |
| Sčítať hodnoty pomocou reduce | |
| Prečítať všetky vstupy s nulovým vstupom (skúste viac dokumentov JSON) |
Technické podrobnosti
Ako funguje jq ihrisko
Čo tento nástroj robí
Jq ihrisko spúšťa skutočné filtre jq nad vaším JSON počas písania. jq 1.8 je skompilovaný do WebAssembly a beží vo Web Worker, takže výsledky presne zodpovedajú nástroju príkazového riadka vrátane chybových hlásení. Vložte JSON, napíšte filter ako .users[] | select(.age > 30) | .name a výstup sa po krátkej pauze aktualizuje. Voľby priamo zodpovedajú prepínačom jq: surový výstup (-r), kompaktne (-c), slurp (-s), nulový vstup (-n), zoradené kľúče (-S), odsadenie tabulátorom (--tab) a pomenované premenné --arg.
Bežné prípady použitia
Vývojári ho používajú na prototypovanie filtrov skôr, než ich vložia do shell skriptov, CI pipeline a jednoriadkových príkazov Kubernetes alebo AWS CLI, na skúmanie veľkých odpovedí API a riadkov logov, konverziu JSON na CSV pomocou @csv, pretváranie dát pomocou map, group_by a reduce a na učenie jq cez vstavaný ťahák s klikateľnými príkladmi.
Vstupy, výstupy a prepínače
Vstupom môže byť jeden dokument JSON alebo viac zreťazených dokumentov, napríklad NDJSON; so Slurp sa zabalia do jedného poľa a s Nulovým vstupom ich čítate sami cez input a inputs. Každý výsledok sa vypíše na vlastný riadok. Surový výstup vypisuje reťazce bez úvodzoviek, čo je potrebné pre výstup @csv, @tsv, @base64 a @uri. Hodnoty odovzdané cez --arg sú vo filtri dostupné ako $name a vždy sú reťazce.
Úskalia a limity
Vstup je obmedzený na 5 MB a beh sa zastaví po 10 sekundách, aby nekonečný filter nezmrazil stránku. Čísla sa spracúvajú podľa sémantiky dvojitej presnosti jq, takže celé čísla nad 2^53 môžu stratiť presnosť. Shell úvodzovky tu nie sú potrebné: v termináli uzavrite filter do jednoduchých úvodzoviek. Toto ihrisko nepodporuje moduly jq, importy zo súborov ani premenné prostredia.