سرفصل‌ها درس 211 از 250 · پروژه‌ها: ساخت چیزهای واقعی
پروژه‌ها: ساخت چیزهای واقعی

خودت طراحی کن: گزارش روزانه

هر درس تا کنون یک اسکلت به شما داده است: یک تابع نیمه‌نوشته‌شده، یک کامنت برای هر مرحله، فضاهای خالی برای پر کردن. کار واقعی به ندرت این‌گونه پیش می‌آید. کسی یک جمله به شما می‌دهد -> «می‌توانید خلاصه‌ای روزانه از این رویدادها به من بدهید؟» -> و فایل خالی برای پر کردن در اختیار شماست. این درس عمداً همان لحظه است. فایل شروع کار تقریباً خالی است: یک امضا و یک docstring، و بس. مهارتی که سنجیده می‌شود، یک ساختار دستوری جدید نیست، بلکه تبدیل یک درخواست مبهم به یک برنامهٔ عملیاتی است.

قرارداد

نوشتن daily_report(events). ورودی events یک لیست از dictها است، که هر کدام به شکل {"day": str, "type": str, "amount": number}. یک dict بازگردانید که هر روز را به یک خلاصهٔ کوتاه از آن روز نگاشت کند:

  • هر روزی که در ورودی ظاهر می‌شود، دقیقاً یک‌بار به‌عنوان یک کلید در خروجی استفاده می‌شود.
  • هر روز به {"count": int, "total": number} که count تعداد رویدادهایی است که در آن روز افتاده‌اند و total مجموع آنها است. amount مقادیر.
  • یک لیست ورودی خالی، یک dict خالی برمی‌گرداند {}.
  • اگر هر رویدادی یکی از کلیدهای مورد نیاز را نداشته باشد (day, type، یا amount)، خطا را برمی‌گرداند ValueError.

ترتیب کلیدها در دیکتی که بازگردانده می‌شود اهمیتی ندارد. آنچه اهمیت دارد این است که شمارش‌ها و مجموع‌ها صحیح باشند و هر روز ورودی فقط یک‌بار ظاهر شود.

سه مثال عملی

daily_report([
    {"day": "Mon", "type": "coffee", "amount": 3},
    {"day": "Mon", "type": "lunch",  "amount": 12},
    {"day": "Tue", "type": "coffee", "amount": 4},
])
# -> {"Mon": {"count": 2, "total": 15},
#     "Tue": {"count": 1, "total": 4}}

daily_report([{"day": "Sat", "type": "movie", "amount": 20}])
# -> {"Sat": {"count": 1, "total": 20}}

daily_report([])
# -> {}

چگونه به یک صفحه خالی حمله کنیم

وقتی هیچ چارچوبی وجود ندارد، قبل از تایپ کردن یکی را در ذهنتان بسازید. یک ترتیب قابل اعتماد:

  • شکل خروجی را نامگذاری کنید. در اینجا این یک dict است که کلیدهای آن بر اساس روز مرتب شده‌اند و هر مقدار یک dict دو فیلدی است. یک ورودی کامل را تصور کنید: "Mon": {"count": 2, "total": 15}. این یک مثال به تنهایی به شما می‌گوید که هر خط کد در راستای چه هدفی کار می‌کند.
  • ساختاری را که آن را می‌سازد انتخاب کنید. شما در حال گروه‌بندی سطرها بر اساس یک کلید و جمع‌آوری دو عدد در هر گروه هستید. یک dict که هنگام پیمایش لیست آن را به‌روزرسانی می‌کنید، گزینه‌ی طبیعی است: اولین باری که یک روز را می‌بینید، آن را در {"count": 0, "total": 0}؛ و هر بار بعد از آن، به آن اضافه کنید.
  • پیش از جشن گرفتن، لبه‌ها را مدیریت کنید. اگر از یک dict خالی شروع کنید و هرگز برای آن مورد خاص کاری نکنید، لیست خالی باید به طور خودکار ایجاد شود. رویداد نامعتبر همان چیزی است که باید برای مدیریت آن اقدام کنید: بررسی کنید که کلیدها موجود هستند و خطا را با `raise` ایجاد کنید. ValueError اگر نه، به جای اینکه اجازه دهید یک KeyError نشت کند.

توجه کنید که هیچ کامنت خط‌به‌خطی وجود ندارد که به شما بگوید چه زمانی یک روز را شروع کنید یا چگونه به آن اضافه کنید. این تصمیم خودِ تمرین است. کوچک‌ترین چیزی را بسازید که قرارداد را برآورده کند، سپس قبل از اجرای آن، آن را با سه مثال بالا تطبیق دهید.

نوبت شما

نوشتن daily_report(events) از قرارداد، بدون هیچ چارچوبی برای تکیه کردن. events یک لیست از دیکت‌ها است که هر کدام شکل‌یافته {"day": str, "type": str, "amount": number}. یک dict بازگردانید که هر روز را به {"count": int, "total": number}: count تعداد رویدادهایی است که در آن روز رخ داده‌اند، total مقادیرشان را جمع می‌کند و هر روز ورودی دقیقاً یک‌بار ظاهر می‌شود. یک لیست خالی بازمی‌گرداند {}. اگر هر رویدادی مفقود باشد day, type، یا amount، خطا را بالا می‌برد ValueError. خود شما شکل داده و حلقه را طراحی کنید.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.