json --- ترميز JSON وفك ترميزه

تحوّل هذه الوحدة بين كائنات Python وصيغة بيانات JSON. استخدم dumps()/loads() للتسلسل (أو فكّه) من سلسلة نصية أو إليها، أو dump()/load() لقراءة JSON أو كتابته من تدفق مثل ملف أو مقبس (socket).

الدوال

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

تحليل str بصيغة JSON وإرجاع كائن. تطلق ValueError إذا كانت السلسلة النصية غير صحيحة التكوين.