بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 19: اپ من ۲ My App 2

اپت را قدم‌به‌قدم می‌سازی، بعد از هر قدم اجرایش می‌کنی، یک «کاربر خراب‌کار» امتحانش می‌کند و تو اشکال‌ها را یکی‌یکی درست می‌کنی تا فهرست بررسی تیک بخورد.

در این جلسه یاد می‌گیری

درس

امروز روز ساختن است. فهرست «حتماً» را کنار دستت بگذار و از بالا شروع کن. یک کار را کامل کن، Run بزن و ببین کار می‌کند، بعد برو سراغ کار بعدی. اگر ده خط بنویسی و بعد اجرا کنی و خطا بیاید، نمی‌دانی کدام خط بود. اگر دو خط بنویسی، می‌دانی.

ترتیب خوب ساختن، همان ترتیب پروژه‌های دوره است: ۱) اسکلت: صفحه‌ها و ابزارها با تابع‌های pass. ۲) تابع دکمه‌ها، یکی‌یکی. ۳) app.save بعد از هر تغییر و app.load اول برنامه. ۴) خطاگیری: کادر خالی، عدد خراب. ۵) «اگر وقت شد»ها. اگر از یکی از شش ایده شروع کرده‌ای، اول کدش را بخوان و بفهم هر تکه چه می‌کند، بعد تغییرش بده.

خطا دوست توست. خط آخر پیام قرمز می‌گوید چه شد و کمی بالاترش شماره‌ی خط را می‌گوید. چند خطای رایج: NameError یعنی اسمی را اشتباه نوشتی یا هنوز نساختی. TypeError معمولاً یعنی متن و عدد را قاطی کردی (int را فراموش کردی) یا تابع دکمه را با () دادی. IndexError یعنی شماره‌ای از لیست را خواستی که نیست. KeyError یعنی کلیدی از دیکشنری که نیست.

نگاهی به داخل: وقتی اپ کار عجیبی می‌کند، print بگذار. در اپ، print روی گوشی نمی‌آید؛ در زبانه‌ی Output کنار ادیتور چاپ می‌شود. repr فاصله‌های پنهان را هم نشان می‌دهد. وقتی اشکال پیدا شد، printها را پاک کن.

import app

words = []

def add_word():
    word = word_box.value.strip()
    print("typed:", repr(word))
    words.append(word)
    print("words now:", words)
    items.add(word)

app.title("Word Book")
word_box = app.input("Word")
app.button("Add", add_word)
items = app.list()
app.run()

کاربر ساختگی: سایت در این دوره جواب تو را با یک «کاربر ساختگی» می‌سنجید که کادر پر می‌کرد، دکمه می‌زد و اپ را می‌بست و باز می‌کرد. حالا خودت همان کاربر باش. این‌ها را امتحان کن: ☐ هر کادر را خالی بگذار و دکمه را بزن. ☐ فقط فاصله بنویس. ☐ در کادر عدد abc، -5، 0 و 99999 بنویس. ☐ یک متن خیلی بلند بچسبان. ☐ یک دکمه را بیست بار پشت سر هم بزن. ☐ روی همه‌ی خط‌های لیست بزن. ☐ اپ را ببند و دوباره Run کن: داده‌ها مانده‌اند؟ ☐ با «پاک کردن داده» اپ را مثل بار اول باز کن: بدون داده هم کار می‌کند؟

بعد جایت را با یک هم‌کلاسی عوض کن. او «کاربر خراب‌کار» است و کارش شکستن اپ توست! وقتی چیزی خراب شد، دعوا نکن: تشکر کن و بنویس. برای هر اشکال یک خط: «چه کردم؟ چه انتظار داشتم؟ چه شد؟» مثلاً «کادر نمره را خالی گذاشتم و Add زدم؛ انتظار پیام داشتم؛ خطای ValueError آمد». این فلوچارت دور تست و درست کردن است.

درمان‌های آشنا برای اشکال‌های آشنا: متن خالی یا فقط فاصله؟ .strip() و if text == "": ... return. عدد خراب؟ try / except ValueError یا تابع read_number جلسه‌ی ۱۵. عدد بیرون از بازه؟ if n < low or n > high. متن خیلی بلند؟ if len(text) > 30. بعد از باز شدن یادش رفت؟ دنبال app.save بعد از هر تغییر بگرد. خطای There is no screen؟ املای اسم صفحه در app.screen و app.go را مقایسه کن.

داده‌ی قدیمی: اگر وسط کار شکل داده را عوض کنی (مثلاً هر کلمه از یک متن ساده به دیکشنری تبدیل شود)، داده‌ای که قبلاً ذخیره شده هنوز شکل قدیم را دارد و ممکن است خطای TypeError یا KeyError بدهد. ساده‌ترین راه موقع ساختن: «پاک کردن داده» زیر گوشی. برای کاربر واقعی: یک اسم تازه برای ذخیره، مثل app.load("words2", []).

فهرست بررسی قبل از ارائه: ☐ اپ عنوان دارد (app.title) و برچسب هر دکمه می‌گوید چه می‌کند. ☐ کادر خالی و ورودی خراب پیام مهربان می‌گیرد، نه خطای قرمز. ☐ بعد از بستن و باز کردن، داده‌ها می‌مانند. ☐ اپ بدون هیچ داده‌ای هم درست باز می‌شود. ☐ هر صفحه راه برگشت دارد. ☐ اپ هیچ اطلاعات شخصی واقعی نمی‌خواهد. ☐ چند داده‌ی نمونه‌ی ساختگی برای ارائه آماده است.

همین در HTML: در دوره‌ی «اپ با HTML» همین دور «بساز، امتحان کن، درست کن» در استودیو انجام می‌شود و درمان‌ها trim()، isNaN و try/catch جاوااسکریپت هستند. فکرش یکی است: هیچ ورودی‌ای نباید اپ را بشکند.

مثال‌های این جلسه

بیشتر بخوان

← جلسه‌ی 18: اپ من ۱ جلسه‌ی 20: روز ارائه →