Jq Concepts
Internal
Pipeline Content
The pipeline flows items that are: primitives, maps and arrays.
Individual strings flowing on a pipeline can be simulated with:
echo \"red\" \"blue\" \"green\" | jq '.'
This is how an array can be injected in the pipeline:
echo "[\"red\", \"blue\"]" | jq '.'
... and this is how a map can be injected in the pipeline:
echo "{\"size\": 10}" | jq '.'
Iteration
An iteration is pipeline content produced by the .[] filter, that converts and array into its individual elements.
Pipe Operator |
The pipe operator '|' combines two filters by feeding the output of the filter specified on the left into the input of the filter specified on the right.
If the left filter produces an iteration, the filter on the right is applied to each of the iteration elements.
Usually the "|" can be omitted on command line and it can be implied:
jq '.a.b.c'
is equivalent with:
jq '.a | .b | .c'
Alternative Operator //
Expressions
Expressions can be used with the select() filter.
Need more semantics here
. >= 2
.id == "blue"
Built-in Operators and Functions
length
The length function displays the length of an array.
jq '.menu.popup.menuitem | length' menu.json
max, min
The max and min values are used to determine the maximum and minimum values of a field in an array.
keys
Displays keys of an array.
has
The has function determines whether an array item has a value defined for a given key.
map
TO PROCESS: https://www.linode.com/docs/guides/using-jq-to-process-json-on-the-command-line/
sub, gsub
Substitute.
sub(regex; tostring) sub(regex; string; flags)
Delete the first character:
... | jq -r '... | sub("."; "")'
tonumber
tostring
Organizatorium
Conversion from a map to an array.
Conversion from array to a map?