آموزش پایتون

آموزش ایجاد پروژه جنگو به صورت چک لیست سریع

۱- ایجاد محیط مجازی virtualenv برای پروژه جنگو

قدم اول برای ایجاد پروژه جنگو ، راه اندازی محیط مجازی هستش.

برای اینکه پروژه های پایتون در یک سیستم و یا در یک سرور دچار تداخل نشن و افزونه ها و ماژول های اونها باعث ایجاد خطا در سایر اپ های پایتون روی اون سیستم یا سرور نشه، باید برای هر پروژه پایتون یک محیط مجازی virtual environment بسازیم و ملزومات اون اپ رو داخلش نصب کنیم.

اگر با نصب و راه اندازی خود virtual environment آشنایی ندارید، چند دقیقه وقت بذارید و این مطلب رو بخونید.

۲- فعالسازی محیط مجازی در پوشه پروژه

  • برای پروژه خودمون یک فولدر با اسم مرتبط می سازیم
  • خط فرمان رو داخل اون فولدر باز می کنیم. و یک محیط مجازی جدید با نام مثلا venv میسازیم
virtualenv venv 
  • با دستورات زیر (در ویندوز و لینوکس) محیط مجازی رو فعال می کنیم:
//Linux: 
source venv/bin/activate

//Windows:
venv\Scripts\activate


۳- نصب جنگو در محیط مجازی از طریق pip

  • چک می کنیم که pip نصب شده باشه:
pip --version
  • با دستور زیر جنگو رو در venv خودمون نصب می کنیم . (توجه کنید تمام مراحل نصب و کار کردن با جنگو میبایست در حالی که venv در خط فرمان ما فعال هست انجام بشه. )
pip install django

۴- ساخت پروژه جنگو با نام مورد نظر

  • برای ساخت یک پروژه‌ی جنگو، (در حالی که هنوز venv اکتیو است) دستور زیر را اجرا کنید: (بجای myproject اسم پروژه خودتون رو بنویسید.)
django-admin startproject myproject

۵- فعال کردن سرور و اجرای پروژه

  • الان در خط فرمان، در پوشه ابتدایی پروژه هستیم (جایی که پوشه پروژه و پوشه venv قرار دارن). با استفاده از فرمان cd داخل فولدر پروژه خودمون میشیم (جایی که فایل manage.py هست) و با دستور زیر سرور رو اجرا می کنیم:
python manage.py runserver 8000

URL زیر را در مرورگرتان باز کنید. باید شکل زیر برایتان نمایش داده شود:

localhost:8000 یا 127.0.0.1:8000

۶- مایگریت به دیتابیس postgreSQL (اختیاری)

در این مطلب، استفاده از دیتابیس PostgreSQL در پروژه جنگو، و مایگریت به اون رو بهتون آموزش دادم .

۷- فعالسازی Git و گزینش فایلها بوسیله git ignore (تقریباً اختیاری!)

۷-۱- ساخت فایل gitignore.

قبل از فعالسازی گیت روی پروژه جنگو‌، باید فایلها و فولدر هایی که نمیخواهیم در git ذخیره شود را در یک فایل به نام gitignore. بنویسیم.

git این فایل رو میخونه و فایلها و فولدر های داخل اون رو نادیده می گیره.

فایل gitignore. رو داخل فولدر اصلی پروژه (جایی که فایل manage.py قرار دارد) ایجاد می کنیم.

فایل gitignore. رو ویرایش می کنیم و موارد زیر رو بهش اضاقه می کنیم و ذخیره اش می کنیم.

*.log
*.pot
*.pyc
__pycache__/
local_settings.py
db.sqlite3
/media
/static

مواردی که در فایل بالا نوشتم، یک استاندارد برای پروژه جنگو هستن. انواع فایلهای لوکال و لاگ و کش و فایلهای استاتیک برنامه جزو فایلهایی هستن که لزومی نداره توی گیت ذخیره بشن.

۷-۲- آغاز گیت در پروژه

در حالیکه venv فعال هست، خط فرمان رو به مسیر روت پروژه می بریم (همونجایی که manage.pyهست) و دستور زیر رو برای اضافه کردن git به پروژه می زنیم

git init

اگر در این حالت از دستور git status استفاده کنید، خواهید دید که هنوز هیچ کدام از فایلهای پروژه شما به مخزن گیت اضافه نشده.

۷-۳- اضافه کردن فایلهای پروژه به گیت

دستور با فرمت git add ، فایلهایی که بعد از کلمه add نوشته شدن رو به گیت اضافه می کنه.

ما در آغاز پروژه لازم داریم که تمام فایلهای پروژه به گیت اضافه بشن. پس دستور زیر رو میزنیم:

git add -A 

۷-۴- ذخیره کردن فایلها و تغییرات با دستور کامیت

برای ذخیره کردن پروژه در گیت، از دستور git commit به همراه یک پیام (توضیحات اون نسخه از پروژه) استفاده می کنیم:

git commit -m "this is the first version of my project"

۷-۵- کامیت در نسخه های بعدی پروژه

برای اضافه کردن فایلهای جدید پروژه (git add -A) و همینطور کامیت کردن (git commit ) هر نسخه ار پروژه، دو مرحله قبل رو مجدداً انجام میدیم.

۸- ساخت یوزر ادمین (سوپر یوزر) جهت لاگین در قسمت ادمین جنگو

پنل ادمین جنگو با اضافه کردن اسلش ادمین ( admin/ ) به انتهای آدرس سایت جنگوی شما در دسترس خواهد بود. و برای لاگین از شما یوزرنیم و پسورد میخواد.

این یوزرنیم و پسورد رو ما در خط فرمان و در حالتی که venv فعاله و داخل فولدر روت پروژه هستیم (همونجاییکه فایل manage.py هست) با دستور زیر تعریف می کنیم:

python manage.py createsuperuser

بعد از زدن دستور فوق، از شما نام کاربر، آدرس ایمیل و پسورد رو می پرسه و تمام!

۹- شناسوندن فایل اجرایی پایتون (که داخل venv هست) به pyCharm

در حالت عادی، pyCharm بیشعور میاد و از نسخه اصلی پایتون که در سیستم عامل شما نصب شده برای تفسیر پروژه استفاده می کنه.

و چون اون نسخه از پایتون احتمالا ماژولهاش با ماژولهایی که شما روی venvنصب کردید فرق می کنه، از همه ماژولهای نصب شده شما (من جمله جنگو) ایراد می گیره.

برای رفع این مشکل، باید نسخه پایتون داخل venv پروژه خودتون رو بعنوان مفسر (interpreter) پروژه تون به pyCharm معرفی کنین.

  • در pyCharm از منوی file گزینه setting رو بزنید.
  • در پنجره تنظیمات، عبارت interpreter رو سرچ کنید.
  • با کلیک بر روی آیکن چرخ دنده که در سمت راست دراپ داون اومده، گزینه add رو بزنید.
  • روی گزینه Existing environment کلیک کنید و در دراپ داون زیر اون، آدرس فایل پایتون داخل venv/bin داخل روت پروژه تون رو بهش بدین
  • روی Apply و OK کلیک کنید.

داکیومنت های آموزشی جنگو رو می تونید از این آدرس بخونید.

حامد عسکریان

برنامه نویس و عاشق تکنولوژی

دیدگاهتان را بنویسید

دکمه بازگشت به بالا
بستن
بستن