17- ساخت اولین اپلیکیشن در جنگو(8) (صفحه ادمین):

۱۰ تیر ۱۴۰۴
0 دیدگاه

قسمت هشتم: نصب و استفاده از Django Debug Toolbar در جنگو

 

در قسمت قبلی آموزش، یک اپلیکیشن نظرسنجی (poll) ساده با Django ایجاد کردیم. حالا وقت آن رسیده که با دنیای قدرتمند پکیج‌های جانبی (Third-Party Packages) آشنا شویم؛ یکی از بزرگ‌ترین مزیت‌های Django، جامعه فعال و غنی آن در تولید ابزارهای مکمل است.


 

Django Debug Toolbar چیست؟

 

Django Debug Toolbar یکی از معروف‌ترین بسته‌های جانبی جنگو است که برای دیباگ (اشکال‌زدایی) پروژه‌های جنگو استفاده می‌شود. این ابزار با ارائه اطلاعات دقیق در قالب پنل‌هایی در سمت مرورگر، به توسعه‌دهنده کمک می‌کند تا روند پردازش درخواست‌ها، وضعیت دیتابیس، کش، قالب‌ها و… را بهتر درک کند.


 

مراحل نصب Django Debug Toolbar

 

۱. نصب پکیج با pip

ابتدا، مانند نصب خود جنگو، باید این بسته را در محیط مجازی خود نصب کنید:

				
					python -m pip install django-debug-toolbar

				
			

حتماً از محیط مجازی (virtualenv) فعال استفاده کنید.


 

 

۲. پیکربندی تنظیمات پروژه

برای استفاده از بسته‌هایی مانند Debug Toolbar، معمولاً نیاز است:

 

  • آن را به لیست INSTALLED_APPS در فایل settings.py اضافه کنید.

  • تنظیماتی را در فایل urls.py اعمال نمایید.

 

این مراحل ممکن است در طول زمان تغییر کند، پس بهتر است به مستندات رسمی Django Debug Toolbar مراجعه کنید:

👉 مستندات نصب Django Debug Toolbar در GitHub


 

 

۳. مشاهده نوار ابزار دیباگ

پس از نصب و پیکربندی صحیح، وقتی پروژه را اجرا می‌کنید و به آدرس:

				
					http://localhost:8000/admin/

				
			

می‌روید، در سمت راست مرورگر یک نوار کوچک با عنوان DjDT خواهید دید. با کلیک روی آن، نوار ابزار دیباگ باز شده و اطلاعات متنوعی درباره درخواست جاری نمایش می‌دهد.


 

 

عیب‌یابی در صورت بروز مشکل

گاهی ممکن است نوار ابزار به درستی ظاهر نشود. در این صورت:

  • به بخش Tips در مستندات Debug Toolbar مراجعه کنید.

  • ایرادهای مشابه را در issue tracker پروژه (در GitHub) جست‌وجو کنید.

  • از انجمن Django یا Discord رسمی جنگو کمک بگیرید.


 

سایر پکیج‌های جانبی مفید برای Django

وب‌سایت Django Packages یک مرجع عالی برای یافتن پکیج‌های جانبی جنگو است. هنگام انتخاب پکیج به مواردی مثل:

 

  • تاریخ آخرین آپدیت

  • تعداد مشارکت‌کنندگان

  • پشتیبانی از نسخه‌های جدید Django

  • داشتن تست و مستندات

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


 

جمع‌بندی

 

در این درس یاد گرفتیم که چطور از یکی از مهم‌ترین ابزارهای دیباگ در جنگو یعنی Django Debug Toolbar استفاده کنیم. این ابزار به‌ویژه در مراحل توسعه بسیار مفید است و دیدی کامل نسبت به عملکرد پروژه به شما می‌دهد.

0 دیدگاه