~gpanders/ijq

ref: abb780c84526868f5c357f48f6ebf55c3199988b ijq/README.md -rw-r--r-- 1.7 KiB
abb780c8 — Greg Anders Remove superfluous example in README 2 months 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.0/ijq-linux-x86_64.tar.gz
tar -C /usr/local/bin/ -xf ijq-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