~gpanders/ijq

ref: d2a1582760c2f2814b1b87da5c4952678192c0fc ijq/README.md -rw-r--r-- 1.8 KiB
d2a15827 — Greg Anders Use canonical Makefile variable names 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. Then 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. You can use this in a pipe, .e.g.

curl -s https://api.github.com/users/gpanders/repos | ijq > output.json

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