Dev Web & SaaS

Python GraphQL Graphene: الـ9 خطوات الرئيسية للانتقال من الصفر إلى التشغيل

بايثون GraphQL Graphene: الأساسيات في مقال واحد — كود حقيقي، مخططات وخطوات ملموسة، مقتطفات من دورة مكونة من 43 درساً.

REHOUMA Haythem

• 7 min read
Python GraphQL Graphene: الـ9 خطوات الرئيسية للانتقال من الصفر إلى التشغيل

يمكن للجميع تعلم Python GraphQL Graphene — بشرط اتباع الخطوات بالترتيب الصحيح. لقد قمنا بتكثيف دورة كاملة من 43 درسًا في مسار واضح، مع أكثر مقتطفات الكود فائدة.

tl;dr
  • مقدمة وتثبيت
  • أساسيات GraphQL
  • أول API مع Graphene
  • مخططات متقدمة وأنواع
  • الطفرات والمدخلات
~$ cat ./parcours.md # Python GraphQL Graphene — 10 فصول
01
المقدمة والتثبيت
→ عرض الدورة ولماذا GraphQL ؟→ تثبيت Python و Flask و Graphene+ 1 دروس أخرى
02
أساسيات GraphQL
→ GraphQL مقابل REST : متى تختار ماذا→ المخطط، الأنواع والاستعلامات+ 2 دروس أخرى
03
أول API مع Graphene
→ تثبيت وتكوين Graphene→ تعريف أنواع Python باستخدام Graphene+ 2 دروس أخرى
04
مخططات متقدمة وأنواع
→ أنواع مخصصة و Enum→ العلاقات بين الأنواع (One-to-Many, Many-to-Many)+ 2 دروس أخرى
05
الطفرات والمدخلات
→ تعريف وهيكلة الطفرات الخاصة بك→ التحقق من صحة المدخلات باستخدام InputObjectType+ 2 دروس أخرى
06
دمج قاعدة البيانات
→ اتصال SQLAlchemy بـ PostgreSQL→ Graphene-SQLAlchemy : توليد تلقائي للأنواع+ 2 دروس أخرى
07
المصادقة والتفويض
→ JWT مع GraphQL : تسجيل الدخول والوسيط→ الأذونات حسب الحقل (التفويض على مستوى الحقل)+ 1 دروس أخرى
08
الأداء والتحسين
→ التخزين المؤقت باستخدام Redis (لكل استعلام ولكل حقل)→ تعقيد الاستعلام : الحد من الاستعلامات المسيئة+ 1 دروس أخرى
🏁
المشروع النهائي (+ 2 فصول في الطريق)
→ Tu repars avec un projet concret et démontrable

أول مخطط GraphQL "Hello World"

NOTEالهدف — كتابة أول مخطط GraphQL باستخدام Graphene، وعرضه عبر Flask، واختبار أول استعلام من واجهة GraphiQL.

الأهداف التعليمية

TIPفي نهاية هذه الوحدة
  • فهم دور Query Type في GraphQL
  • تعريف مخطط بسيط باستخدام Graphene (حقل واحد، محلل واحد)
  • ربط Graphene بـ Flask عبر flask-graphql
  • تشغيل الخادم والوصول إلى GraphiQL في المتصفح
  • تنفيذ أول استعلام GraphQL وقراءة استجابة JSON

المفهوم: نوع الاستعلام، أصل كل واجهة GraphQL

تبدأ واجهة GraphQL دائمًا بنوع Query Type (يُسمى أحيانًا root query). إنه بوابة واجهتك: تُعلن فيه جميع الحقول المتاحة للقراءة. لكل حقل تكتب resolver — دالة Python تعيد البيانات المطلوبة.

الحد الأدنى يبدو كالتالي:

الخطوة 1: إنشاء المخطط في schema.py

الخطوة 3: تشغيل الخادم

الخطوة 4: أول استعلام لك

في اللوحة اليسرى، اكتب:

تثبيت Python وFlask وGraphene

NOTEالهدف — إعداد بيئة Python نظيفة ومعزولة لتطوير واجهات GraphQL باستخدام Graphene وFlask، والتحقق من عمل كل شيء.

الأهداف التعليمية

TIPفي نهاية هذه الوحدة
  • تثبيت Python 3.12 على Windows أو macOS أو Linux
  • إنشاء بيئة افتراضية معزولة باستخدام venv
  • تثبيت Flask وGraphene وflask-graphql عبر pip
  • التحقق من الإصدارات المثبتة
  • إعداد هيكل مجلدات المشروع

لماذا بيئة افتراضية؟

البيئة الافتراضية في Python هي مجلد معزول يحتوي على نسخته الخاصة من Python ومكتباته، دون المساس بـ Python النظامي. بدون بيئة افتراضية، قد تواجه:

TIPالقاعدة الذهبية: مشروع = بيئة افتراضية مخصصة. دائمًا.

الخطوة 1: التحقق من تثبيت Python 3.12+

تحقق أولاً مما إذا كان Python مثبتًا:

Windows

نزّل المثبت .exe من python.org. حدد "Add to PATH". أعد تشغيل الطرفية بعد التثبيت.

macOS

استخدم Homebrew: brew install python@3.12. أو نزّل .pkg الرسمي.

Linux

على Ubuntu/Debian: sudo apt install python3.12 python3.12-venv.

الخطوة 2: إنشاء مجلد المشروع والبيئة الافتراضية

WARNINGعلى Windows، إذا كان Activate.ps1 محظورًا، شغّل مرة واحدة كمسؤول: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

الخطوة 3: تثبيت Flask وGraphene وflask-graphql

المكتبةالدورالإصدار الموصى به
flaskإطار ويب مصغر لـ Python (أساس واجهتك)3.0+
grapheneمكتبة GraphQL لـ Python (مخططات، أنواع، محللات)3.4+
flask-graphqlمحول يربط Graphene بـ Flask ويعرض نقطة نهاية /graphql2.0+

لتثبيت الإصدارات في ملف requirements.txt (لإضافته إلى Git):

هيكل المجلدات الموصى به

اتصال SQLAlchemy بـ PostgreSQL

NOTEالهدف — إعداد اتصال SQLAlchemy موثوق بـ PostgreSQL وجعله متاحًا في المحللات عبر السياق.

الأهداف التعليمية

TIPفي نهاية هذه الوحدة
  • تثبيت SQLAlchemy 2.x وpsycopg2
  • تعريف Engine وSessionLocal
  • حقن Session لكل طلب HTTP
  • إغلاق الجلسة بشكل صحيح بعد كل طلب

التثبيت

va-plus-loin

تغطي هذه المقالة المقتطفات الأكثر فائدة — الدورة الكاملة Python GraphQL Graphene (11 فصلاً، 43 درسًا، تمارين محلولة ومشروع نهائي) تأخذك إلى النهاية.

./acceder-au-cours-complet cours gratuit : Vibe Coding

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

كم من الوقت يستغرق تعلم Python GraphQL Graphene؟
مع تقدم منظم (11 فصلاً، 43 درسًا قصيرًا وعمليًا)، يمكن الوصول إلى مستوى تشغيلي في بضعة أسابيع بمعدل 30 إلى 60 دقيقة يوميًا. المهم هو تطبيق كل مفهوم فورًا.
هل هناك متطلبات سابقة؟
تكفي أساسيات في الحوسبة. إذا كنت تعرف استخدام الطرفية وقراءة كود بسيط، فأنت جاهز.
من أين أبدأ عمليًا؟
طبّق أوامر هذه المقالة، ثم تابع الدورة الكاملة Python GraphQL Graphene: تربط الـ 43 درسًا بالترتيب، مع تمارين ومشروع نهائي.
./a-lire-aussi
→ ابدأ بـ Portfolio IA SEO Vercel: خطوتك العملية الأولى اليوم→ IA Stripe GitHub SaaS عمليًا: الكود والأوامر التي تهم حقًا→ Python Requests APIs شرح مبسط (مع مخططات وكود حقيقي)

📬 هل تريد تلقي هذا النوع من الأدلة أسبوعيًا؟ اشترك مجانًا — كود حقيقي، بدون كلام زائد.

Stay up to date

Enter your email
Subscribe