بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 22: قالب داده‌ی JSON JSON

JSON زبان مشترک APIها و فایل‌های تنظیمات است؛ با ماژول json داده‌ی پایتون را به متن و برعکس تبدیل می‌کنیم و آن را در فایل نگه می‌داریم.

در این جلسه یاد می‌گیری

درس

json.dumps(obj) داده‌ی پایتون را به رشته‌ی JSON تبدیل می‌کند و json.loads(text) برعکس. حرف s در انتها یعنی string.

import json

user = {"name": "ana", "active": True, "tags": ["dev"], "manager": None}
text = json.dumps(user)
print(text)   # {"name": "ana", "active": true, "tags": ["dev"], "manager": null}
print(json.loads(text)["tags"])

نگاشت نوع‌ها: dict→object، list و tuple→array، str→string، int/float→number، True/False→true/false، None→null. در رفت‌وبرگشت، تاپل لیست می‌شود و کلیدهای غیررشته‌ای (مثل 1) رشته ("1") می‌شوند. set و datetime اصلاً قابل تبدیل نیستند (TypeError).

import json

print(json.loads(json.dumps({1: (2, 3)})))  # {'1': [2, 3]}

indent خروجی چندخطی و خوانا می‌سازد و sort_keys=True کلیدها را مرتب می‌کند؛ خروجی پایدار برای diff در گیت و تست‌ها ضروری است. separators=(",", ":") فشرده‌ترین شکل را می‌دهد.

import json

print(json.dumps({"b": 1, "a": [1, 2]}, indent=2, sort_keys=True))

json.dump(obj, f) مستقیم در فایل می‌نویسد و json.load(f) از فایل می‌خواند (بدون s). فایل را با encoding="utf-8" باز کن. این ساده‌ترین روش ذخیره‌ی پایدار تنظیمات یا وضعیت یک برنامه است.

import json

with open("config.json", "w", encoding="utf-8") as f:
    json.dump({"port": 8080}, f, indent=2)
with open("config.json", encoding="utf-8") as f:
    print(json.load(f)["port"])

متن نامعتبر json.JSONDecodeError می‌دهد که زیرکلاس ValueError است و موقعیت خطا را هم دارد. هر داده‌ای که از بیرون (کاربر، شبکه، فایل) می‌آید را در try پارس کن. توجه: JSON کوتیشن تکی و ویرگول انتهایی را قبول نمی‌کند.

import json

try:
    json.loads("{'name': 'ana'}")
except json.JSONDecodeError as e:
    print("invalid JSON at column", e.colno)

مثال‌های این جلسه

چالش‌ها

  1. Serialize a Record (آسان)
  2. Parse a Payload (آسان)
  3. Pretty Print (آسان)
  4. Round-Trip Surprises (متوسط)
  5. Save and Load (متوسط)
  6. Order Total (متوسط)
  7. Detect Invalid JSON (متوسط)
  8. Config Override (سخت)
  9. Tag Frequency (سخت)
  10. Group Into JSON (سخت)
  11. Non-ASCII Output (متوسط)
  12. Schema Check (سخت)

بیشتر بخوان

← جلسه‌ی 21: کار با فایل‌ها جلسه‌ی 23: CSV و داده‌ی جدولی →