1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-07-15 02:55:23 +02:00
tldr/pages/common/jq.md
Emily Grace Seville f0dacdbd20
jq: update page (#7945)
* Fix manual url

* Replace all old examples with new ones:
- executing expression/script
- accessing keys/array items
- mutating objects

* Remove backslash, but:
- syntax highlighting is broken

* Add russian jq translation

* Fix placeholders in translation

* Specify multiple array items/keys in examples

* Describe --arg option

* Join two examples:
- first
- fourth

* Fix generic command placeholders:
- use `cat path/to/file.json`
2022-04-13 11:45:18 +10:00

892 B

jq

A command-line JSON processor that uses a domain-specific language. More information: https://stedolan.github.io/jq/manual/.

  • Execute the specified expression (print a colored and formatted json):

{{cat path/to/file.json}} | jq '{{.}}'

  • Execute the specified script:

{{cat path/to/file.json}} | jq --from-file {{path/to/script.jq}}'

  • Pass the specifed arguments:

{{cat path/to/file.json}} | jq {{--arg "name1" "value1" --arg "name2" "value2" ...}} '{{. + $ARGS.named}}'

  • Print the specifed keys:

{{cat path/to/file.json}} | jq '{{.key1, .key2, ...}}'

  • Print the specifed array items:

{{cat path/to/file.json}} | jq '{{.[index1], .[index2], ...}}'

  • Print all array items/object keys:

{{cat path/to/file.json}} | jq '.[]'

  • Add/remove the specified keys:

{{cat path/to/file.json}} | jq '{{.}} {{+|-}} {{{"key1": "value1", "key2": "value2", ...}}}'