Interactively build jq expressions (gojq is also supported).
This fish plugin gives you jq superpowers! (See also: upstream zsh plugin.)
This fish fork is not as well tested yet!
Besides jq, this plugin also requires fzf (a recent version) to be installed and available on your PATH.
For automatic yaml support, install gojq as well.
fisher install rmartine-ias/jq-fish-plugin- type out a command that you expect to produce json on its standard output
- press alt + j
- start typing jq expression and watch it being evaluated in real time (like a true REPL!)
- use up/down and hit tab to select one of the suggestions
- or type out a jq query on your own
- press enter, and the jq expression is appended to your initial command!
Bringing up the jq query builder for a shell command: alt + j
During interactive querying, the following shortcuts can be used:
| Shortcut | Effect |
|---|---|
up |
Navigate path queries |
down |
Navigate path queries |
tab |
Select path query |
shift + up |
Scroll up |
shift + down |
Scroll down |
alt + up |
Scroll up full page |
alt + down |
Scroll down full page |
ctrl+r |
Reload input |
If you want to use an alternative jq implementation, like
gojq then you can override the default jq
command used by the plugin. Set the following environment variable:
JQ_REPL_JQ=gojqThe project consists of the following components:
- a
fishplugin providing a line-editor widget, utilizing thejq-replcommand - a
jq-replcommand to interactively build jq expressions, utilizing fzf for its UI - a
jq-pathscommand to get all valid jq paths in the provided JSON document, used for suggesting paths.
You need to remap your alt-key to Esc+ in iTerm2:
Cmd + ,to enter preferences- Go to Profiles
- select your profile from the pane on the left hand side
- go to the keys tab
- Set Left Option (⌥ ) Key to
Esc+
See other suggestions on stackoverflow if the above one doesn't help you: https://stackoverflow.com/q/196357/205318
Another option is to map to ctrl+j instead by putting this in your .zshrc:
bindkey `^j` jq-complete