json — קידוד ופענוח JSON¶
מודול זה ממיר בין אובייקטים של Python לבין פורמט הנתונים JSON. השתמשו ב-dumps()/loads() כדי לסדר/לפענח אל מחרוזת או ממנה, או ב-dump()/load() כדי לקרוא או לכתוב JSON מזרם כגון קובץ או סוקט.
פונקציות¶
- json.dump(obj: Any, stream: Any, separators: Tuple[str, str] | None = None) None¶
סידור obj למחרוזת JSON, וכתיבתה אל ה-stream הנתון.
אם צוין, separators אמור להיות tuple מהצורה
(item_separator, key_separator). ברירת המחדל היא(', ', ': '). כדי לקבל את ייצוג ה-JSON הקומפקטי ביותר, יש לציין(',', ':')כדי לבטל רווחים.
- json.dumps(obj: Any, separators: Tuple[str, str] | None = None) str¶
החזרת obj כשהוא מיוצג כמחרוזת JSON.
לארגומנטים יש את אותה משמעות כמו ב-
dump().
- json.load(stream: Any) Any¶
ניתוח ה-stream הנתון, פירושו כמחרוזת JSON ופענוח הנתונים לאובייקט Python. האובייקט המתקבל מוחזר.
הניתוח נמשך עד שנתקלים בסוף הקובץ. מועלית
ValueErrorאם הנתונים ב-stream אינם בנויים כראוי.
- json.loads(str: str | bytes) Any¶
ניתוח ה-JSON שב-str והחזרת אובייקט. מעלה
ValueErrorאם המחרוזת אינה בנויה כראוי.