JSON Formatter Python — คู่มือ json.dumps()

import json

phuchai = {
    "id": "usr_9f3a2b",
    "name": "สมชาย ใจดี",
    "roles": ["admin", "editor"],
    "prefs": {"theme": "dark", "lang": "th"}
}

print(json.dumps(phuchai, indent=4, ensure_ascii=False))
# ผลลัพธ์:
# {
#     "id": "usr_9f3a2b",
#     "name": "สมชาย ใจดี",
#     "roles": [
#         "admin",
#         "editor"
#     ],
#     "prefs": {
#         "theme": "dark",
#         "lang": "th"
#     }
# }

import json

api_response = {
    "timestamp": "2024-05-01T10:30:00Z",
    "status": "success",
    "data": {
        "user_id": "usr_9f3a2b",
        "display_name": "สุดา มีสุข",
        "city": "กรุงเทพ",
        "score": 4892.5,
        "tags": ["python", "backend", "api"]
    }
}

print(json.dumps(api_response, indent=4, sort_keys=True, ensure_ascii=False))
# ผลลัพธ์ (คีย์เรียงแล้ว เก็บภาษาไทย):
# {
#     "data": {
#         "city": "กรุงเทพ",
#         "display_name": "สุดา มีสุข",
#         "score": 4892.5,
#         "tags": ["api", "backend", "python"],
#         "user_id": "usr_9f3a2b"
#     },
#     "status": "success",
#     "timestamp": "2024-05-01T10:30:00Z"
# }

import json

payload = {
    "endpoint": "/api/v2/events",
    "filters": {"status": "active", "limit": 100},
    "sort": "desc"
}

# ค่าเริ่มต้น — มีช่องว่างหลัง separator (อ่านง่าย)
default_out = json.dumps(payload)
# {"endpoint": "/api/v2/events", "filters": {"status": "active", "limit": 100}, "sort": "desc"}
# len = 88

# กระชับ — ไม่มีช่องว่างเลย
compact_out = json.dumps(payload, separators=(',', ':'))
# {"endpoint":"/api/v2/events","filters":{"status":"active","limit":100},"sort":"desc"}
# len = 80  (เล็กลง 9%; ประโยชน์เพิ่มขึ้นกับ payload ที่ซ้อนกันลึก)

# กระชับ + เรียงคีย์สำหรับ cache key หรือ content hash
canonical = json.dumps(payload, separators=(',', ':'), sort_keys=True)
print(canonical)
# {"endpoint":"/api/v2/events","filters":{"limit":100,"status":"active"},"sort":"desc"}

import json
from datetime import datetime, timezone
import uuid

order = {
    "order_id": uuid.uuid4(),             # ❌ TypeError: UUID is not JSON serializable
    "placed_at": datetime.now(timezone.utc),  # ❌ TypeError: datetime is not JSON serializable
    "total_thb": 4500.00,
    "items": ["pro-subscription", "addon-storage"]
}

json.dumps(order)  # raise TypeError

import json
from datetime import datetime, timezone, date
import uuid
from decimal import Decimal

def json_default(obj):
    if isinstance(obj, (datetime, date)):
        return obj.isoformat()
    if isinstance(obj, uuid.UUID):
        return str(obj)
    if isinstance(obj, Decimal):
        return float(obj)
    raise TypeError(f"ประเภท {type(obj).__name__!r} ไม่สามารถ serialize เป็น JSON ได้")

order = {
    "order_id": uuid.uuid4(),
    "placed_at": datetime(2024, 5, 1, 10, 30, 0, tzinfo=timezone.utc),
    "total_thb": Decimal("4500.00"),
    "items": ["pro-subscription", "addon-storage"]
}

print(json.dumps(order, indent=4, default=json_default))
# {
#     "order_id": "a3f1c2d4-e5b6-7890-abcd-ef1234567890",
#     "placed_at": "2024-05-01T10:30:00+00:00",
#     "total_thb": 4500.0,
#     "items": ["pro-subscription", "addon-storage"]
# }

import json
from datetime import datetime, timezone
import uuid
from decimal import Decimal

class AppEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, datetime):
            return obj.isoformat()
        if isinstance(obj, uuid.UUID):
            return str(obj)
        if isinstance(obj, Decimal):
            return float(obj)
        return super().default(obj)  # raise TypeError สำหรับประเภทที่ไม่รู้จัก

order = {
    "order_id": uuid.uuid4(),
    "placed_at": datetime(2024, 5, 1, 10, 30, 0, tzinfo=timezone.utc),
    "total_thb": Decimal("4500.00"),
}

# ส่ง encoder class ผ่าน cls=
print(json.dumps(order, indent=4, cls=AppEncoder))
# ผลลัพธ์เหมือนกับวิธี default= ข้างต้น

import json
from datetime import datetime
from dataclasses import dataclass

@dataclass
class Event:
    name: str
    occurred_at: datetime
    user_id: str

def encode_event(obj):
    if isinstance(obj, Event):
        return {
            "__type__": "Event",
            "name": obj.name,
            "occurred_at": obj.occurred_at.isoformat(),
            "user_id": obj.user_id,
        }
    raise TypeError(f"ไม่สามารถ serialize {type(obj)}")

def decode_event(d):
    if d.get("__type__") == "Event":
        return Event(
            name=d["name"],
            occurred_at=datetime.fromisoformat(d["occurred_at"]),
            user_id=d["user_id"],
        )
    return d

# Encode
event = Event("login", datetime(2024, 5, 1, 10, 30), "usr_9f3a2b")
json_str = json.dumps(event, default=encode_event, indent=4)

# ถอดรหัสกลับเป็น Event instance
restored = json.loads(json_str, object_hook=decode_event)
print(type(restored))           # <class 'Event'>
print(restored.occurred_at)     # 2024-05-01 10:30:00

import json, pprint

raw = '{"sensor_id":"s-441","readings":[23.1,23.4,22.9],"unit":"celsius","active":true}'
data = json.loads(raw)

# pprint — Python repr ที่ถูกต้อง ไม่ใช่ JSON ที่ถูกต้อง
pprint.pprint(data, sort_dicts=False)
# {'sensor_id': 's-441',
#  'readings': [23.1, 23.4, 22.9],
#  'unit': 'celsius',
#  'active': True}        ← Python True ไม่ใช่ JSON true

# json.dumps — JSON ที่ถูกต้อง
print(json.dumps(data, indent=4))
# {
#     "sensor_id": "s-441",
#     "readings": [23.1, 23.4, 22.9],
#     "unit": "celsius",
#     "active": true      ← JSON ที่ถูกต้อง
# }

import json

try:
    with open("config.json", "r", encoding="utf-8") as f:
        data = json.load(f)

    # พิมพ์ให้สวยงามบน console
    print(json.dumps(data, indent=4, ensure_ascii=False))

    # หรือเขียนเวอร์ชันที่จัดรูปแบบแล้วกลับลงดิสก์
    with open("config.pretty.json", "w", encoding="utf-8") as f:
        json.dump(data, f, indent=4, ensure_ascii=False)

except json.JSONDecodeError as e:
    print(f"JSON ไม่ถูกต้อง: {e}")
except FileNotFoundError:
    print(f"ไม่พบไฟล์: config.json")

import json, requests
from requests.exceptions import HTTPError, ConnectionError, Timeout

def pretty_print_api(url: str) -> None:
    try:
        resp = requests.get(url, timeout=10)
        resp.raise_for_status()
        print(json.dumps(resp.json(), indent=4, ensure_ascii=False))
    except HTTPError as e:
        print(f"HTTP {e.response.status_code}: {e}")
    except (ConnectionError, Timeout) as e:
        print(f"Network error: {e}")
    except json.JSONDecodeError:
        print(f"Response body ไม่ใช่ JSON:\n{resp.text[:500]}")

pretty_print_api("https://api.github.com/repos/python/cpython")

# จัดรูปแบบไฟล์ local
python -m json.tool config.json

# Pipe API response ผ่าน formatter
curl -s https://api.github.com/users/gvanrossum | python -m json.tool

# จัดรูปแบบจาก stdin
echo '{"service":"api-gateway","version":"2.1.0","healthy":true}' | python -m json.tool

# เรียงคีย์ตามตัวอักษร
python -m json.tool --sort-keys data.json

# กำหนด indent เอง (Python 3.9+)
python -m json.tool --indent 2 data.json

pip install orjson

import orjson
from datetime import datetime, timezone
import uuid

event = {
    "event_id": uuid.uuid4(),                  # ไม่ต้อง str() — orjson จัดการ UUID
    "timestamp": datetime.now(timezone.utc),   # ไม่ต้อง isoformat()
    "service": "auth-service",
    "level": "INFO",
    "payload": {
        "user_id": "usr_9f3a2b",
        "action": "login",
        "ip": "192.168.1.42",
        "latency_ms": 34
    }
}

# orjson.dumps คืนค่า bytes; .decode() แปลงเป็น str
print(orjson.dumps(event, option=orjson.OPT_INDENT_2).decode())
# {
#   "event_id": "a3f1c2d4-e5b6-7890-abcd-ef1234567890",
#   "timestamp": "2024-05-01T10:30:00+00:00",
#   "service": "auth-service",
#   ...
# }

pip install rich

from rich import print_json
import json

# print_json() รับ JSON string
raw = '{"event":"login","user_id":"usr_9f3a2b","timestamp":"2024-05-01T10:30:00Z","success":true,"meta":{"ip":"192.168.1.42","attempts":1}}'
print_json(raw)

# สำหรับการพิมพ์ Python dict ให้สวยงาม แปลงเป็น string ก่อน
data = {
    "status": "success",
    "count": 42,
    "tags": ["python", "api", "backend"]
}
print_json(json.dumps(data))

pip install simplejson

import simplejson as json  # API เหมือนกับ stdlib
from decimal import Decimal

order = {
    "item": "API subscription",
    "price": Decimal("149.99"),   # stdlib json raise TypeError ที่นี่
    "quantity": 3,
}

# simplejson serialize Decimal แบบ native — ไม่ต้องใช้ default=
print(json.dumps(order, indent=4, use_decimal=True))
# {
#     "item": "API subscription",
#     "price": 149.99,
#     "quantity": 3
# }

pip install ijson

import ijson
from decimal import Decimal

# events.json โครงสร้าง: {"events": [...หลายล้าน object...]}
total_revenue = Decimal("0")
login_count = 0

with open("events.json", "rb") as f:   # ijson ต้องการ binary mode
    for event in ijson.items(f, "events.item"):
        if event.get("type") == "purchase":
            total_revenue += Decimal(str(event["amount_thb"]))
        elif event.get("type") == "login":
            login_count += 1

print(f"รายได้: {total_revenue:,.2f} THB  |  Logins: {login_count}")
# ประมวลผลไฟล์ 2 GB ด้วยหน่วยความจำสูงสุด ~30 MB

import json
from pathlib import Path

# เขียน NDJSON — หนึ่ง event ต่อบรรทัด
events = [
    {"ts": "2024-05-01T10:00:00Z", "user": "usr_9f3a2b", "action": "login"},
    {"ts": "2024-05-01T10:01:03Z", "user": "usr_9f3a2b", "action": "purchase", "sku": "pro-plan"},
    {"ts": "2024-05-01T10:15:42Z", "user": "usr_4ab1d9", "action": "login"},
]

with open("events.ndjson", "w", encoding="utf-8") as f:
    for event in events:
        f.write(json.dumps(event, ensure_ascii=False) + "\n")

# อ่าน NDJSON — หน่วยความจำคงที่ ไม่ว่าไฟล์จะใหญ่แค่ไหน
purchase_count = 0
with open("events.ndjson", "r", encoding="utf-8") as f:
    for line in f:
        line = line.strip()
        if not line:           # ข้ามบรรทัดว่าง
            continue
        event = json.loads(line)
        if event.get("action") == "purchase":
            purchase_count += 1
            print(f"{event['ts']} — {event['user']} ซื้อ {event['sku']}")