JSON إلى فئات بيانات Python
مثال
الإدخال:
{"name": "Ali", "age": 30}الناتج:
from dataclasses import dataclass
from typing import List, Optional
@dataclass
class Root:
name: str
age: intحول هذا المحوّل
يربط المحوّل JSON إلى أشكال dataclass التي يكتبها مطوّرو Python فعلياً: تلميحات str/int/float/bool (الأعداد الصحيحة مميّزة عن العائمة بقيمة العيّنة)، الكائنات المتداخلة مستخرجة إلى @dataclass الخاصة بها، المصفوفات كـ List[ItemType] مع فئات عناصر مولّدة من عناصر المصفوفة، والحقول المفقودة من بعض عناصر المصفوفة تُمنح افتراضية None — موضوعة أخيراً، إذ تتطلب ترتيب حقول dataclass الافتراضيات في النهاية، وهو بالضبط سبب تتبّع الدمج للاختيارية. للاستخدام الإنتاجي مع واجهات API حقيقية، فكّر في إقران الناتج بتحقق pydantic أو attrs؛ فئات البيانات المولّدة هي المسودة البنيوية الأمينة.
الأسئلة الشائعة
لماذا تُظهر الحقول الاختيارية "= None" بدلاً من Optional[...]؟
نمط الافتراضي-None هو اصطلاح dataclass المدمج؛ لفّ التلميح في Optional[...] إذا طلب مدقّق نوعك ذلك.
ماذا لو كان حقل null في العيّنة؟
يُكتب كـ None في المسودة — استبدله بالنوع الحقيقي الذي تضمنه API الخاصة بك؛ عيّنة خالية لا تستطيع كشفه.