python -m json.tool로 JSON 한 줄짜리 펼쳐보기

API 응답이나 설정 파일이 한 줄로 뭉쳐서 내려올 때가 있습니다. 이걸 눈으로 보려고 에디터에 붙여넣고 포매터 돌리기 전에, 파이썬만 있으면 표준 라이브러리로 바로 예쁘게 뽑아낼 수 있습니다. 파일을 넣어도 되고, 파이프로 흘려넣어도 됩니다.

# 파일을 읽어 pretty-print
python -m json.tool mp_films.json

# 파이프로 넘기기 (infile 생략 시 stdin)
curl -s https://api.example.com/data | python -m json.tool

기본값은 4칸 들여쓰기이고 입력 순서를 그대로 유지합니다. 들여쓰기를 바꾸려면 --indent 2나 --tab, 반대로 한 줄로 압축하려면 --compact를 쓰면 됩니다(3.9+). 키를 정렬하려면 --sort-keys, 한글이 \uXXXX로 깨져 보이면 --no-ensure-ascii를 붙여 보세요. JSON Lines처럼 한 줄에 객체 하나씩인 로그는 --json-lines(3.8+)로 줄 단위 파싱합니다.

💡 Python 3.14부터는 python -m json으로도 실행됩니다. 예전 표기인 python -m json.tool도 그대로 지원하니 둘 다 됩니다. ⚠️ 두 번째 위치 인자로 outfile을 주면 그 파일에 쓰는데, 입력과 같은 파일을 지정하면 덮어쓰니 조심하세요.

🔗 https://docs.python.org/3/library/json.html