Bash JSON ビューア — jless、JQ_COLORS & ターミナルガイド

# macOS
brew install jless

# Linux — GitHub Releases からビルド済みバイナリを取得
curl -sL https://github.com/PaulJuliusMartinez/jless/releases/latest/download/jless-x86_64-unknown-linux-gnu.tar.gz \
  | tar xz
sudo mv jless /usr/local/bin/

# バージョン確認
jless --version

# ローカルファイルを開く——インタラクティブなツリービューアが即座に起動
jless api-response.json

# JSONストリームを直接 jless にパイプ
curl -s https://api.github.com/users/torvalds | jless

# すべてのノードをトップレベルに折りたたんだ状態で開く（大きなドキュメントの出発点として便利）
jless --mode line api-response.json

# 特定の配列要素を取り出して単独で表示
jq '.[0]' deployments.json | jless

# jless 内で：
#
#   j / ↓        下に移動
#   k / ↑        上に移動
#   l / →        ノードを展開（またはEnter）
#   h / ←        ノードを折りたたむ
#   H            現在のノードと兄弟をすべて折りたたむ → 全体俯瞰
#   L            すべてを再帰的に展開
#
#   /            前方検索を開始——キー名を入力してEnter
#   n / N        次 / 前の検索結果
#
#   g / gg       先頭に移動
#   G            末尾に移動
#   q            終了

# 基本のカラー付きページャ
jq -C . response.json | less -R

# curlレスポンスから——-sはプログレスバーがJSONストリームを汚染しないようにする
curl -s https://api.github.com/repos/jqlang/jq | jq -C . | less -R

# キーをソートして見やすくしてからページング
jq -CS . config.json | less -R
# -C = 強制カラー、-S = キーソート（2つのフラグを組み合わせ）

# エイリアスを追加して毎回フルパイプを入力しなくて済むようにする
alias jqv='jq -C . | less -R'
# 使用例：cat response.json | jqv
#    または：curl -s https://api.example.com/status | jqv

# JQ_COLORS 構築のためのANSIカラー参考：
#   属性：  0=通常  1=太字  2=薄く  4=下線
#   カラー：30=黒  31=赤  32=緑  33=黄
#           34=青  35=マゼンタ  36=シアン  37=白
#   明色：  90=明黒  91=明赤  92=明緑  93=明黄
#           94=明青  95=明マゼンタ  96=明シアン  97=明白
#
# 順序：null : false : true : 数値 : 文字列 : 配列 : オブジェクト

# ダークターミナル向けハイコントラストテーマ（推奨）
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=暗グレー, false=明赤, true=明緑,
# numbers=明黄, strings=緑, arrays=太字シアン, objects=太字シアン

# Solarizedスタイルのテーマ
export JQ_COLORS="2;37:0;35:0;35:0;36:0;33:1;34:1;34"
# null=薄白, false=マゼンタ, true=マゼンタ,
# numbers=シアン, strings=黄, arrays=太字青, objects=太字青

# ミニマル（キーのみ太字、他はすべて通常）
export JQ_COLORS="0;90:0;39:0;39:0;39:0;39:1;39:1;39"

# 選んだテーマを ~/.bashrc または ~/.zshrc に追加してすべての jq 呼び出しに適用
echo 'export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"' >> ~/.bashrc
source ~/.bashrc

# テーマをテスト
echo '{"active":true,"errors":null,"count":42,"tags":["api","v2"],"meta":{"version":"1.0"}}' | jq .

# ~/.bashrc または ~/.zshrc に追加

# jv — インタラクティブビューア（jlessがあればそれを、なければカラー付きページャ）
jv() {
  if command -v jless &>/dev/null; then
    jless "$@"
  else
    jq -C . "$@" | less -R
  fi
}

# jvp — キーをアルファベット順にソートして表示（レスポンス比較に便利）
alias jvp='jq -CS . | less -R'

# jvc — クリップボードから表示（macOS）
alias jvc='pbpaste | jless'

# jvf — 表示してフィルタ：jvf '.users[0]' response.json
jvf() {
  local filter="$1"; shift
  jq -C "$filter" "$@" | less -R
}

# ターミナルを再起動せずにリロード
source ~/.bashrc

# 上記エイリアスを追加した後の使用例

# 任意のファイルやパイプ済みレスポンスを表示
jv deployment-config.json
curl -s https://api.github.com/users/torvalds | jv

# ソートして表示（アルファベット順で確認しやすい）
cat feature-flags.json | jvp

# サブドキュメントをインタラクティブに掘り下げる
jvf '.database' infra/app-config.json
jvf '.users[] | select(.role == "admin")' users.json

# macOS
brew install bat

# Debian / Ubuntu（バイナリはbatcatという名前の場合あり）
apt-get install -y bat
# alias bat=batcat   # Ubuntuで必要な場合は ~/.bashrc に追加

# シンタックスハイライトと行番号でJSONファイルを表示
bat config/feature-flags.json

# ページャ無効——ターミナルに直接出力（スクリプトで便利）
bat --paging=never api-response.json

# jqと組み合わせ：jqでフォーマット、batで表示（batのJSONハイライトを維持）
jq '.' response.json | bat --language=json --paging=never

# npmでグローバルインストール
npm install -g fx

# またはインストールせずに実行（npxがパッケージをキャッシュ）
curl -s https://api.github.com/users/torvalds | npx fx

# 基本的なインタラクティブ使用
fx api-response.json
curl -s https://api.github.com/repos/jqlang/jq | fx

# fx内で：矢印キーでナビゲート、Enterで展開/折りたたみ、/で検索
# ボトムバーでリアルタイムフィルタリングのためのJavaScript式を受け付ける：
#   .name           → "name"フィールドのみ表示
#   .repos.slice(0,5) → 最初の5つのリポジトリ

# fxは非インタラクティブなフォーマッタとしても動作（jq .に似ているがJS構文）
# JavaScriptの式を引数として渡す——インタラクティブモードなし
echo '{"users":[{"id":1,"name":"Sarah Chen"},{"id":2,"name":"Marcus Osei"}]}' \
  | fx '.users[0].name'
# Sarah Chen

# mapをチェーンして配列変換
cat deployments.json | fx '.items.map(d => ({id: d.deploy_id, status: d.state}))'