طراح سایتپایه یازدهم
دانلود کل سایت
فهرست درس‌ها

پودمان ۵: برنامه‌نویسی جنگو

قالب و دمای واقعی

صفحه ۲۸۷

توضیحات کدها:

خط 1: تابع path وارد (import) شده است.

خط 2: تابع show_temp_view از views.py وارد (import) شده است.

خط 5: یک path اضافه شده است. این path به این معنی است که اگر کاربر صفحه اصلی سایت را باز کرد، show_temp_view از درون فایل views.py اجرا شود. به این path پارامتر name اضافه شده است.

در جنگو هر آدرس (URL) می‌تواند یک نام داشته باشد تا در هر جایی دیگر، راحت‌تر به آن ارجاع داده شود. این اسم هیچ تأثیری روی خود آدرس URL ندارد و فقط برای ارجاع‌دادن استفاده می‌شود.

پارامتر name در مسیرهای جنگو مانند یک اسم مستعار برای آن آدرس است که به آن URL name هم می‌گویند.

شکل ۱۶: خروجی اولین view جنگو
شکل ۱۶: خروجی اولین view جنگو

فایل را ذخیره نمایید و با runserver سرور جنگو را راه‌اندازی کنید.

صفحه اصلی سایت را در مرورگر باز کنید.

تبریک، شما اولین view جنگو خود را با موفقیت ایجاد کردید (شکل 16).

آشنایی با تابع render

در جنگو برای نمایش بهتر view از فایل‌های html استفاده می‌شود. هر app در جنگو، می‌تواند فایل‌های html مخصوص به خود را به‌صورت جداگانه داشته باشد، برای انجام این کار یک‌پوشه به اسم templates در app ایجاد کنید و فایل‌های html را در آن ذخیره کنید. به این فایل‌های html در جنگو template گفته می‌شود.

شکل 17 را مشاهده کنید، مسیر طی شدۀ request (درخواست وب) در جنگو قابل‌مشاهده است.

طبق تصویر، درخواست ارسالی کاربر، ابتدا به سرور جنگو منتقل شده، سپس با استفاده از url به view مناسب ارسال می‌شود، هر view با کمک فایل html یا همان template اطلاعات قابل نمایش را آماده کرده و برای کاربر ارسال می‌کند.

شکل ۱۷: مسیر طی شده یک request در جنگو
شکل ۱۷: مسیر طی شده یک request در جنگو

صفحه ۲۸۸

همان‌طور‌که در شکل 17 اشاره شده است، تابع render در view می‌تواند اطلاعات را به فایل html ارسال کند تا به کمک قابلیت‌های جنگو، اطلاعات ارسالی به فایلِ html با آن ترکیب شده و به کاربر نمایش داده شود.

در ادامه، در دو مرحله می‌توانید یک عدد تصادفی را به‌عنوان دمای هوای شهر همدان، با کمک تابع render به یک فایل html ارسال کرده و به کاربر نمایش دهید.

مرحله اول: فایل views.py را باز کنید و show_temp_view را همانند شکل 18 تغییر دهید.

شکل ۱۸: استفاده از تابع render
شکل ۱۸: استفاده از تابع render

توضیحات کدها:

خط 1: تابع render از ماژول shortcuts وارد (import) شده است.

خط 2: ماژول random وارد (import) شده است.

خط 5: یک عدد تصادفی به‌عنوان دمای هوا برای شهر همدان انتخاب می‌شود، این اطلاعات در صفحه اصلی سایت نمایش داده خواهد شد.

خط 6: یک دیکشنری شامل نام شهر (city) و دمای شهر (temp) ایجاد شده و در متغیری با نام context ذخیره شده است.

خط 7: از تابع render استفاده شده است. برای این تابع سه آرگومان ارسال شده است. آرگومان اول request است که از ورودی view دریافت شده است. آرگومان دوم نام فایل html موجود در پوشه templates و آرگومان سوم یک دیکشنری است که برای html ارسال شده است.

مرحله دوم: یک‌پوشه با نام templates در weather app بسازید و یک فایل html با نام show_temp.html درون آن ایجاد کنید.

فایل show_temp.html و هر فایل html دیگری که در این پوشه قرار بگیرد، به‌اصطلاح یک template است.

صفحه ۲۸۹

فایل show_temp.html و محتوای آن را همانند شکل 19 ایجاد کنید.

شکل ۱۹: محتویات show_temp.html شکل ۱۹: محتویات show_temp.html

توضیحات کدها:

خط 10: از {{city}} و {{temp}} جهت‌نمایش نام شهر و دمای شهر استفاده شده است. علامت {{}} جهت‌نمایش متغیرها در template به‌کار می‌رود.

این متغیرها، کلیدهای دیکشنری context هستند که تابع render آن را برای show_temp.html ارسال کرده است.

همان‌طور‌که مشخص است، می‌توانید در template از این متغیرها، درون تگ‌های html استفاده کنید. فایل‌ها را ذخیره کنید. سپس وارد terminal شده و با کلیدهای ترکیبی ctrl + c وب سرور جنگو را متوقف کنید و دوباره با دستور runserver آن را راه‌اندازی کنید. اکنون صفحه اصلی سایت را refresh کنید. تغییرات جدید را مشاهده خواهید کرد (شکل 20).

شکل ۲۰: مشاهده تغییرات جدید
شکل ۲۰: مشاهده تغییرات جدید
شکل ۲۱: روند نمایش دمای هوا
شکل ۲۱: روند نمایش دمای هوا

روند طی شده نمایش دمای هوا، از لحظه ورود درخواست کاربر به سرور جنگو تا نمایش اطلاعات با template، در شکل 21 شبیه‌سازی شده است.

صفحه ۲۹۰

نمایش دمای هوای واقعی

جهت‌نمایش دمای هوای لحظه‌ای شهرها می‌توانید از سایت‌هایی مثل https://open-meteo.com استفاده کنید. این سایت ابزاری در اختیار برنامه‌نویس قرار می‌دهد تا بتواند دمای هوای شهرهای مختلف را نمایش دهد. سایت open-meteo یک API رایگان دارد که با دریافت طول و عرض جغرافیایی، اطلاعات آب‌وهوای منطقه موردنظر را در قالب JSON ارائه می‌دهد.

به‌عنوان‌مثال، اگر آدرس زیر را برای دریافت وضعیت آب‌وهوای شهر همدان در مرورگر باز کنید، نتیجه با قالب JSON نمایش داده خواهد شد (شکل 22).

شکل ۲۲: دریافت دمای شهر همدان از API آنلاین
شکل ۲۲: دریافت دمای شهر همدان از API آنلاین

-meteo.com/v1/forecast?latitude=34.7981&longitude=48.5146&currentـ https://api.open weather=true API مانند یک پل بین دو برنامه است. یعنی زمانی که یک برنامه (مثلاً پروژه جنگو) به اینترنت وصل می‌شود، از طریق API می‌تواند از یک سایت دیگر داده بگیرد.

در این پروژه، با استفاده از API سرویس open-meteo اطلاعات آب و هوایی دریافت می‌شود. open-meteo این اطلاعات را به‌صورت داده‌های منظم در قالب (Json) برمی‌گرداند، سپس پروژه جنگو آنها را نمایش می‌دهد.

صفحه ۲۹۱

ارسال مقدار latitude و longitude برای دریافت اطلاعات آب‌وهوا اجباری است.

اکنون جهت‌نمایش دمای فعلی شهر همدان تابع show_temp_view را از داخل فایل views.py همانند شکل 23 تغییر دهید.

شکل ۲۳: تغییر در view جهت دریافت اطلاعات از API
شکل ۲۳: تغییر در view جهت دریافت اطلاعات از API

توضیحات کدها:

خط 2: کتابخانه requests وارد (import) شده است. این کتابخانه باید از قبل نصب شده باشد. با دستور (pip install requests)

خط 5: مقادیر latitude و longitude همان طول و عرض جغرافیایی هستند که برای شهر همدان مشخص شده و در متغیرهای lat و lon ذخیره شده‌اند.

خط 6 و 7: متن درخواست به‌صورت get و با استفاده از lat و lon آماده شده است.

خط 8: با استفاده از try خطای احتمالی مدیریت شده است، به‌عنوان‌مثال اگر اینترنت وصل نباشد، except در خط 11 مقدار temp را برابر None خواهد کرد و سایت با مشکل مواجه نمی‌شود.

خط 9: درخواست به سرور open-meteo.com ارسال شده و نتیجه با قالب json در دیکشنری data ذخیره شده است.

خط 10: مقدار temperature از دیکشنری data استخراج شده و در متغیر temp ذخیره شده است.

در فایل show_temp.html تغییراتی برای مدیریت خطا همانند شکل 24 اعمال کنید.

شکل ۲۴: تغییرات در template جهت مدیریت خطای احتمالی
شکل ۲۴: تغییرات در template جهت مدیریت خطای احتمالی

صفحه ۲۹۲

توضیحات کدها:

خط 10: در template از دستور شرطی if استفاده شده است. درصورتی‌که temp مقدار داشته باشد و None نباشد، دمای شهر نمایش داده می‌شود.

خط 13: در صورت بروز خطا، پیغامی مناسب به کاربر نمایش داده می‌شود.

اکنون فایل‌ها را ذخیره کرده و پس از اطمینان از اتصال به اینترنت، صفحه اصلی سایت را refresh کنید. خروجی صفحه اصلی سایت، همانند شکل 25 خواهد بود (واضح است که دمای هوا برای شما ممکن است متفاوت نمایش داده شود و البته سرعت باز شدن صفحه اصلی سایت، به‌سرعت اینترنت شما ارتباط دارد، چون در کدها به open-meteo.com متصل شده‌اید.)

شکل ۲۵: نمایش دمای همدان به‌صورت آنلاین
شکل ۲۵: نمایش دمای همدان به‌صورت آنلاین
شکل ۲۶: نمایش خطای مناسب به کاربر
شکل ۲۶: نمایش خطای مناسب به کاربر

درصورتی‌که ارتباط با سایت برقرار نشود، خروجی همانند شکل 26 خواهد بود.