{"version":"https://jsonfeed.org/version/1.1","title":"Vic Demuzere - jq","home_page_url":"https://vic.demuzere.be/articles/tags/jq/","feed_url":"https://vic.demuzere.be/articles/tags/jq/feed.json","description":"Blog posts tagged jq by Vic Demuzere","language":"en","items":[{"id":"https://vic.demuzere.be/articles/using-bash-variables-in-jq/","content_html":"

Due to the special characters used in json, the easiest way to use jq with inline scripts it by putting it between single quotes.\nThat makes it impossible to use bash variables inside your script.\nFortunately, jq has an --arg parameter to create a predefined variable from an external source.

\n

You can use it to define a $foo variable with the contents of bash variable $FOO, for example:

\n
$ export FOO="bar"\n$ jq -n --arg foo "$FOO" '{foo: $foo}'\n{\n  "foo": "bar"\n}\n
\n

You might notice the -n parameter: This tells jq to use null as input instead of reading json from stdin like it normally would.\nI'm using it in all examples on this page as it makes them a bit shorter.\nIn real world usage, you probably won't need it.

\n

As usual in bash scripts, you can also execute a command inline:

\n
$ jq -n --arg hostname "$(hostname)" '{foo: $hostname}'\n{\n  "foo": "cypher"\n}\n
\n

Every variable created with --arg is treated as a string.\nThat might cause some unexpected behavior when you work with numbers, like when you attempt to add a number to an argument.\nComparisons between strings and numbers seem to work fine, but I wouldn't count on it (pun intended).

\n
$ echo '{"a": 3.0}' | jq --arg foo 5 '$foo + .a'\njq: error (at <stdin>:1): string ("5") and number (3) cannot be added\n
\n

There are two ways to solve this: either convert the variable to a number with tonumber or use --argjson instead.\nI prefer to use tonumber because that way I'm sure jq forces it to be a number.\nAs my argument may be the result of an earlier command, I may be using an error message as input instead of the expected numeric result.

\n
$ jq -n --arg foo 5 '($foo|tonumber) + 1'\n6\n\n$ jq -n --argjson foo 5 '$foo + 1'\n6\n
\n

Variables from files

\n

It's also possible to load variables from files.\nWith --slurpfile we can read a file containing json objects.\nAn array containing the separate objects is then made available as a predefined variable.\nNote that even if your file contains only a single json object, as the variable is still an array, the [0] is required to access it.

\n
$ cat foo.json\n{"foo": "bar"}\n{"bar": "foo"}\n\n$ jq -n --slurpfile foo foo.json '$foo[0].foo'\n"bar"\n
\n

A second option is --rawfile, creating a string variable with the exact contents of the file.\nNote that as jq outputs json, reading and printing the file from the previous example results an escaped string.

\n
$ jq -n --rawfile foo foo.json '$foo'\n"{\\"foo\\": \\"bar\\"}\\n{\\"bar\\": \\"foo\\"}\\n"\n
\n

That's it!

\n

Thanks for subscribing to my feed!

Feel free to e-mail comments or corrections to vic@demuzere.be.

","url":"https://vic.demuzere.be/articles/using-bash-variables-in-jq/","date_published":"2021-02-10T20:01:03Z","date_modified":"2024-11-11T18:21:44Z","language":"en"}]}