JSON → Python Dataclass

مولِّد JSON → Python Dataclass يفحص عيِّنة JSON ويُنتج أصناف Python مزخرفة بـ @dataclass ومحاطة بتعليقات typing. إنه مساعد إنتاجي لمشاريع Python 3.7 فما فوق، ويمكن استخدام الأصناف المولَّدة مباشرة في FastAPI و Pydantic (بتعديلات طفيفة) و DTOs الخاصة بـ SQLAlchemy وسكربتات تحليل البيانات، ما ينقل الكود من قواميس ديناميكية إلى نماذج كائنات قوية الأنواع.

الخطوة 1 — الصق عيِّنة JSON على اليسار، أو انقر "Sample" لتحميل مثال بسرعة. الخطوة 2 — حدِّد اسم الصنف الجذري (الافتراضي RootObject). الخطوة 3 — تُنتج اللوحة اليمنى كود @dataclass المقابل مباشرةً؛ تصبح الكائنات المتداخلة أصنافاً منفصلة ومعلَنة بترتيب التبعية. الخطوة 4 — انسخ الكود إلى مشروعك أو نزِّله كملف .py. يستورد الكود المولَّد تلقائياً from dataclasses import dataclass و from typing import List, Optional عند الحاجة.

توليد نماذج الطلب / الاستجابة بسرعة عند بناء خدمة FastAPI (يمكن الترحيل إلى Pydantic لاحقاً)؛ يستخدم محللو البيانات dataclasses لتحسين القابلية للقراءة عند التعامل مع سجلات JSON عميقة التداخل؛ توليد تعريفات الأنواع بالجملة عند التكامل مع خدمات تعلم الآلة؛ يبني مطورو SDK لعملاء Python نماذج مباشرة من توثيق API؛ ترحيل قاعدة كود قديمة غير مكتوبة الأنواع إلى كود مكتوب الأنواع بتوليد الهياكل.

تُطابَق السلاسل إلى str، والأعداد الصحيحة إلى int، والعشرية إلى float، والقيم المنطقية إلى bool، والمصفوفات إلى List[T]، وتُطابَق null إلى Optional[Any]. أسماء الأصناف بصيغة PascalCase بينما تحتفظ أسماء الحقول بتهجئتها الأصلية في JSON (بدِّلها إلى snake_case يدوياً عند الحاجة). المسافة البادئة الافتراضية 4 مسافات بما يتوافق مع PEP 8. لا يتضمن مخرج dataclass دوال __post_init__ أو مساعدات تسلسل JSON؛ ادمجها مع dataclasses-json أو marshmallow عند الحاجة.

يُجرى استنتاج الأنواع بأكمله في متصفحك، فلا تُرفع أي بيانات JSON. تستطيع بأمان معالجة عيِّنات حمولات تحتوي على معلومات شخصية أو عناصر نائبة لمفاتيح API.