محوّل JSON إلى فئات Python

ما هو تحويل JSON إلى Python؟

أمثلة

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

from dataclasses import dataclass
from typing import List


@dataclass
class Root:
    id: int
    name: str
    email: str
    active: bool
    roles: List[str]

{"repo":"pydantic","owner":{"login":"samuelcolvin","id":100}}

from dataclasses import dataclass


@dataclass
class Owner:
    login: str
    id: int


@dataclass
class Root:
    repo: str
    owner: Owner

{"login":"octocat","publicRepos":15,"createdAt":"2011-01-25"}

from pydantic import BaseModel, ConfigDict, Field


class Root(BaseModel):
    model_config = ConfigDict(populate_by_name=True)

    login: str
    public_repos: int = Field(alias="publicRepos")
    created_at: str = Field(alias="createdAt")

{"users":[{"id":1,"nick":"x"},{"id":2}]}

from typing import List, Optional, TypedDict


class User(TypedDict):
    id: int
    nick: Optional[str]


class Root(TypedDict):
    users: List[User]

كيفية تحويل JSON إلى Python

1. 1

   الصق بيانات JSON

   أدرِج كائن JSON أو مصفوفة أو استجابة API في حقل الإدخال. يبدأ التحويل فوراً.

2. 2

   اختر dataclass أو Pydantic أو TypedDict

   بدّل نمط الإخراج ليطابق مشروعك، وأعد تسمية الفئة الجذرية من الافتراضي Root.

3. 3

   انسخ أو حمّل

   خذ Python المُولَّد بنقرة واحدة والصقه مباشرة في كودك.

Common Use Cases

عملاء API مكتوبو الأنواع

حوّل عيّنة استجابة REST أو GraphQL إلى نماذج Pydantic أو dataclass لعميل requests أو httpx دون كتابة تعريفات الحقول يدوياً.

تحليل الإعدادات والتجهيزات

ولّد نماذج لملفات إعداد JSON أو تجهيزات الاختبار أو حمولات webhook التي تحتاج إلى تحميلها والتحقق منها.

النمذجة السريعة وتلميحات الأنواع

الصق حمولة غير مألوفة لترى شكلها فوراً كأنواع Python — طريقة سريعة لاستكشاف API جديد أو إضافة تلميحات TypedDict إلى كود dict قديم.

كيف يعمل التحويل

الاستنتاج البنيوي

يصبح كل كائن فئة مسماة؛ وتُزال تكرارات الأشكال المتطابقة فتحصل على فئة واحدة لا نسخ. تُدمج مصفوفات الكائنات مفتاحاً بمفتاح، والمفاتيح الغائبة من بعض العناصر تصبح Optional.

ثلاثة أهداف اصطلاحية

يُبقي dataclass صفر اعتماديات ويحافظ على المفاتيح الصالحة لـRoot(**data)؛ ويضيف Pydantic v2 أسماء Field البديلة مع populate_by_name لتحقّق حقيقي؛ ويصف TypedDict dict عادياً لمدقّقات الأنواع الساكنة، مستخدماً الصيغة الوظيفية عندما لا يكون المفتاح معرّفاً.

كتابة أنواع صحيحة وخفيفة الاعتماديات

تُعيَّن الأعداد الصحيحة إلى int (دقة عشوائية بلا فيض)، والأعداد العشرية والأُسّية إلى float، والحقول الفارغة فقط إلى Optional[Any]. وتُضاف استيرادات typing (Optional وList وAny) فقط عند استخدامها فعلاً.

100% على جانب المتصفح

يجري التحليل والتوليد في متصفحك دون أي طلبات شبكة، فتبقى بياناتك خاصة.

نصائح لنماذج Python نظيفة

طابِق الوضع مع المهمة

استخدم dataclass لحاويات البيانات الداخلية، وPydantic v2 عندما تتحقّق من إدخال غير موثوق أو تحلّله، وTypedDict عندما تحتاج فقط إلى تلميحات أنواع ساكنة فوق dict موجودة.

الصق عيّنة تمثيلية

تُعلَّم الحقول Optional فقط عندما تحذفها عيّنة، وتعود القيم الفارغة فقط إلى Any. المثال المكتمل المملوء يعطي أدق الأنواع.

سمِّ فئتك الجذرية

عيّن اسماً جذرياً ذا معنى (User أو ApiResponse) بدلاً من الافتراضي Root لكود مقروء وقابل للاستيراد.

الأسئلة الشائعة