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 = 키 정렬 (두 플래그 결합)

# 전체 파이프를 매번 입력하지 않도록 별칭 추가
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}))'