القراء مثلك يساعدون في دعم MUO. عند إجراء عملية شراء باستخدام الروابط الموجودة على موقعنا ، فقد نربح عمولة تابعة.

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

على الرغم من أن الاستنساخ قد يبدو سهلاً ، إلا أنه قد يمثل تحديًا في المشروعات التي تم إنشاؤها باستخدام Django. يحتوي Django على العديد من التبعيات والحزم التي تسبب التعارضات عند عدم تثبيتها.

يجب عليك إصلاح التعارضات قبل تشغيل المشروع على جهازك المحلي. حسنًا ، ليس عليك أن تعاني بعد الآن.

في الخطوات التالية ، ستتعلم كيفية استنساخ وإعداد وتشغيل مشروع Django بأقل قدر من التعارضات.

ما سوف تحتاجه

لتحقيق أقصى استفادة من هذا الدليل ، يجب أن يكون لديك ما يلي:

  • بايثون (Python3 وما فوق)
  • معرفة عملية بمكتبة Python-Django
  • نقطة 3
  • الإلمام ببيئات Python الافتراضية
  • المعرفة الأساسية لـ Git و GitHub
  • حساب جيثب
  • تم تثبيت Git على جهازك المحلي
  • الإلمام بسطر الأوامر

مع استيفاء هذه المتطلبات ، فأنت جاهز لاستنساخ مشروع.

1. استنساخ المشروع من جيثب

instagram viewer

يمكنك استنساخ مشروع عينة من جيثب وقم بتكوينه على جهازك المحلي.

لاستنساخ المشروع ، انقر فوق الزر الأخضر المسمى شفرة. في القائمة المنسدلة ، حدد ارتباطات HTTP أو SSH وانسخها. هذه الروابط هي عناوين URL الخاصة بـ GitHub للمشروع. أي منهم سيفعل.

عندما تريد المساهمة في مشروع مفتوح المصدر باستخدام Git، عليك أولاً شوكة المشروع من مستودع المشروع لعمل نسخة قبل الاستنساخ.

العودة إلى جهازك ، قم بإعداد مجلد باسم clone_boma. تذكر أن تنتقل إلى المجلد بامتداد cd clone_boma يأمر.

بعد ذلك ، قم بتشغيل الأمر التالي لاستنساخ المشروع في المجلد.

استنساخ بوابة <مستودع URL>

لذلك ، لاستنساخ نموذج المشروع عبر HTTP ، استخدم هذا الأمر:

شخص سخيف استنساخ https://github.com/Dindihub/Boma-watch.git

2. افحص ملفات المشروع

بعد الاستنساخ ، استخدم الأمر ls للتحقق من وجود ملفات من مشروع Boma-watch. يكتب ls لسرد كل المحتويات في المجلد.

يمكنك استخدام محرر نصوص من اختيارك لفحص محتويات كل ملف أو عرضها على موقع GitHub على الويب.

3. قم بإعداد بيئة افتراضية

تحتاج إلى إعداد بيئة افتراضية للمشروع. يأتي نموذج المشروع مع بيئة Pipenv التي تحدد تبعيات المشروع في ملفين: ملف و Pipfile.lock.

ستواجه هذا الخطأ إذا قمت بتشغيل المشروع باستخدام ملف Pipfile القديم:

ModuleNotFoundError: لا توجد وحدة باسم "distutils.core"

تحتاج إلى حذف البيئة الافتراضية وتثبيتها من جديد. لحذف البيئة الافتراضية وتوابعها ، قم بتشغيل الأوامر التالية على التوالي.

لإزالة البيئة القديمة:

بيبينف --rm

لإزالة كلا الملفين:

rm Pipfile *

لتثبيت تبعيات Pipenv على إصدار Python الخاص بك:

بيبينف ثَبَّتَ- بايثون 3.10

بعد ذلك ، قم بتشغيل الأمر التالي لتثبيت جميع حزم Pipfiles:

بيبينف ثَبَّتَ الطلبات

ثم قم بتنشيط البيئة الافتراضية:

قذيفة pipenv

سترى البيئة الافتراضية مفعلة على الجانب الأيمن من نافذة جهازك.

إذا كنت تستخدم Venv لإنشاء بيئتك الافتراضية ، فقم بتشغيل ما يلي لتثبيت التبعيات:

نقطةثَبَّتَ-rمتطلبات.رسالة قصيرة

لسرد جميع التبعيات المثبتة:

تجميد النقطة > المتطلبات. txt

4. أنشئ قاعدة بيانات

تحتاج إلى تثبيت قاعدة بيانات للتعامل مع بيانات المشروع. يمكنك اختيار أي نوع من قواعد البيانات التي تناسب احتياجاتك. بالنسبة للمشروع النموذجي ، يجب عليك استخدام PostgresSQL.

تعلم كيف قم بتثبيت PostgreSQL على Ubuntu أو قم بتثبيت PostgreSQL على نظام Windows.

بمجرد تعيين كل شيء ، ابدأ تشغيل Postgres shell باستخدام الأوامر التالية:

sudo -i -u postgres
بسكل

ثم قم بإنشاء قاعدة بيانات باسم new_boma على الخادم:

postgres =# إنشاء قاعدة بيانات new_boma ؛

يقوم الخادم بإرجاع الكلمة إنشاء قاعدة بيانات عندما يقوم بإنشاء قاعدة بيانات. تأكد من وجود قاعدة البيانات من خلال إدراج جميع قواعد البيانات في النظام باستخدام الأمر \ ل:

في settings.py، تحتاج إلى ربط قاعدة البيانات بالتطبيق. قم بذلك عن طريق استبدال مستخدم قاعدة البيانات والاسم وكلمة المرور بالقيم المحلية الخاصة بك:

#...
قواعد البيانات = {
'تقصير': {
'محرك':'django.db.backends.postgresql',
'اسم':'new_boma',
'مستخدم':'postgres',
'كلمة المرور':'كلمة المرور',
 }
}

أيضا ، تذكر أن تتغير وحدة زمنية في ملف settings.py ليلائم موقعك. سيبقي هذا تطبيقك محدثًا.

تأكد من أنك قمت بتثبيت سايكوبج 2 لاستيعاب أي صور متاحة:

بيبنف دولار ثَبَّتَ psycopg2

5. قم بإنشاء مفتاح سري

كل مشروع Django له ميزة فريدة المفتاح السري. عادة ، لا يتم كشف المفتاح السري عبر الإنترنت. يجب أن يكون في ملف الحسد الملف الذي يجب تضمينه في ملف .gitignore لاستبعاده من المستودع.

يجب عليك إنشاء واحدة جديدة لتشغيل مشروعك. أنشئ مفتاحًا سريًا جديدًا باستخدام منشئ مفتاح سري ، مثل جكريتي.

# تحذير أمني: حافظ على سرية المفتاح السري المستخدم في الإنتاج!
SECRET_KEY = 'مفتاح السر يأتي هنا'

6. ترحيل المشروع إلى قاعدة البيانات

قم بتشغيل الأمر التالي لإنشاء جداول للتطبيق في قاعدة البيانات الجديدة:

الثعبانيدير.السنة التحضيريةالهجراتبرنامج

ثم قم بتنفيذ ما يلي للترحيل:

الثعبانيدير.السنة التحضيريةيهاجر

عند تشغيل ملف python manager.py يهاجر الأمر ، تواجه أخطاء. تُعلمك الأخطاء بفقدان الوحدات النمطية. تأكد من تثبيت جميع الوحدات قبل الترحيل.

عند تثبيت جميع التبعيات ، قم بتشغيل الترحيل. إذا انتهت عمليات الترحيل ، فقد حان الوقت لتشغيل المشروع.

عند تثبيت جميع التبعيات ، قم بتشغيل الترحيل. إذا تم تشغيل عمليات الترحيل ، فقد حان الوقت لتشغيل المشروع.

7. قم بتشغيل المشروع

قم بتشغيل المشروع للتأكد من أن كل شيء على ما يرام قبل إضافة مساهمتك. قم بتشغيل التطبيق بالأمر التالي:

الثعبانيدير.السنة التحضيريةخادم

إذا لم تكن هناك أخطاء ، افتح http://127.0.0.1:8000/ في متصفح الويب. سترى الصفحة المقصودة للمشروع كما هو موضح أدناه:

سر استنساخ مشروع Django

يساعد استنساخ مشاريع Django على تحسين وقتك. يمكنك التركيز على تطوير ميزات جديدة بدلاً من بدء مشروع من الصفر.

سر استنساخ وتشغيل مشروع Django على آلة محلية هو معرفة كيفية التعامل مع التبعيات. بعد الاستنساخ ، تأكد من إنشاء بيئة افتراضية جديدة ، وتثبيت التبعيات ، والاتصال بنظام قاعدة بيانات موثوق.

Django هي مكتبة بايثون قوية. تعرف على كيفية استنساخ واستخدام مشاريعها لإنشاء تطبيقات مذهلة تؤثر على مجتمع التكنولوجيا.