~gpanders/ijq

Interactive jq

#2 asciicast in readme is broken

~sircmpwn commented on ijq todo

11 days ago

#2 asciicast in readme is broken

~gpanders commented on ijq todo

11 days ago

#ijq

Interactive jq tool. Like jqplay for the commandline.

asciicast

#Installation

#Homebrew

If you use macOS and Homebrew, you can install ijq with

brew install gpanders/tap/ijq

#Download a release

Select the version you want to download from sourcehut and download one of the precompiled releases from that page. Then extract the archive somewhere on your system path.

Example:

wget https://git.sr.ht/~gpanders/ijq/refs/v0.1.1/ijq-v0.1.1-linux-x86_64.tar.gz
tar -C /usr/local/bin/ -xf ijq-v0.1.1-linux-x86_64.tar.gz

#Build from source

Install go. To install ijq under /usr/local/bin/ simply run

make install

from the root of the project. To install to another location, set the prefix variable, e.g.

make prefix=~/.local install

#Usage

ijq uses jq under the hood, so make sure you have that installed first.

Read from a file:

ijq file.json

Read from stdin:

curl -s https://api.github.com/users/gpanders | ijq

Press Return to close ijq and print the current filtered output to stdout. This will also print the current filter to stderr. This allows you to save the filter for re-use with jq in the future:

ijq file.json 2>filter.jq

# Same output as above
jq -f filter.jq file.json

Press Tab or Shift-Tab to cycle through the windows. The display windows can be scrolled using Vim-like bindings, i.e. hjkl or the arrow keys.

#Similar Work