# JSON إلى Python

أنشئ أصناف Python من عينة JSON، إما كنماذج Pydantic أو كفئات بيانات من المكتبة القياسية. تصبح الكائنات المتداخلة أصنافًا مستقلة يُصرّح عنها قبل استخدامها، وتستخدم الحقول الاختيارية والقابلة لـ null النوع Optional مع قيمة افتراضية None عندما يمكن أن يغيب المفتاح، بينما تستخدم القيم المختلطة Union. وتصبح أسماء الحقول بصيغة snake_case.

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

### كيف تُسمّى الكائنات المتداخلة؟

يصبح كل كائن متداخل نوع Python مستقلًا، وتُشتق تسميته من المفتاح الذي يحتويه بصيغة PascalCase، فيصبح address مثلًا Address. أما الكائنات داخل المصفوفات فتأخذ صيغة المفرد من اسم مفتاح المصفوفة، فيصبح users مثلًا User. وتتشارك الكائنات التي لها الحقول نفسها تمامًا نوعًا واحدًا.

### متى يكون الحقل اختياريًا؟

عندما تحتوي المصفوفة على عدة كائنات ويغيب مفتاح عن بعضها، يصبح ذلك الحقل اختياريًا: يُغلّف نوعه بـ Optional وتكون قيمته الافتراضية None. يكون المفتاح الموجود في كل العينات مطلوبًا. أما الكائن المنفرد فلا يوجد ما يقارنه به، لذا تكون كل مفاتيحه مطلوبة.

### كيف تُعالَج القيم null؟

إذا كانت قيمة المفتاح null في بعض العينات وله قيمة في عينات أخرى، يصبح Optional من ذلك النوع. أما المفتاح الذي تكون قيمته null دائمًا فلا يوفر للأداة معلومات عن نوعه الحقيقي، لذا يصبح Optional[Any]؛ ألصق عينة تتضمن قيمة فعلية للحصول على نوع دقيق.

### ما أنواع الأرقام المستخدمة؟

تصبح الأعداد الصحيحة int، وتصبح الأعداد الكسرية float. ويصبح الحقل الذي يحتوي على النوعين float.

### ماذا يحدث للمفاتيح التي ليست أسماء صالحة؟

تُحوّل أسماء الحقول إلى snake_case. تحتفظ نماذج Pydantic بالمفتاح الأصلي باستخدام Field(alias=...)، لذا يقرأ model_validate قيمة JSON كما هي. لا تملك فئات البيانات أسماء مستعارة، لذا أعد تسمية المفاتيح بنفسك قبل إنشاء فئة بيانات من JSON إذا كانت مفاتيحها ليست أسماء Python صالحة. وتُضاف شرطة سفلية في نهاية كلمات Python المحجوزة مثل class.

### هل يتم تحميل JSON الخاص بي أو تخزينه؟

يُرسل JSON إلى الخادم فقط لإنشاء الرمز لهذا الطلب، ولا يُخزّن. لا يقرأ المولّد سوى بنية عينتك وأنواع قيمها، لذا يمكنك استبدال القيم الحساسة بعناصر نائبة من النوع نفسه قبل لصقها.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان 433 أداة لوكلاء الذكاء الاصطناعي عبر خادم MCP واحد.](https://multitaskai.com/ar/?ref=oneclickpro)
