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

جلسه‌ی 15: تنظیمات و خطاگیری کامل Settings and Catching Every Error

اپ صفحه‌ی تنظیمات می‌گیرد: اسمی برای سلام و هدف روزانه، که ذخیره می‌شوند و صفحه‌ی اصلی از آن‌ها استفاده می‌کند. و هر ورودی بد یک پیام دوستانه می‌گیرد، با کمک تابع read_number.

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

درس

تقریباً هر اپی صفحه‌ی تنظیمات دارد: اسمی که اپ با آن سلام می‌کند، هدف روزانه، رنگ. همه را در یک دیکشنری نگه دار، مثل {"name": "friend", "goal": 8}، و با app.save ذخیره کن. ترفند: app.input("Name", settings["name"]) کادر را از اول با مقدار ذخیره‌شده پر می‌کند.

import app

settings = app.load("settings", {"name": "friend", "goal": 8})

def save_settings():
    settings["name"] = name_box.value.strip()
    app.save("settings", settings)
    hello.value = f"Hi, {settings['name']}!"
    app.go("main")

app.screen("main")
app.title("Water")
hello = app.text(f"Hi, {settings['name']}!")
app.button("Settings", lambda: app.go("settings"))

app.screen("settings")
app.title("Settings")
name_box = app.input("Name", settings["name"])
app.button("Save", save_settings)

app.run()

بازی «کاربر خراب‌کار»: یک نفر اپ را باز می‌کند و هر چیز عجیبی وارد می‌کند: کادر خالی، فقط فاصله، abc به جای عدد، -5 یا 999، 7.5 جایی که عدد صحیح می‌خواهیم، یک اسم ۵۰ حرفی. اپ خوب هیچ‌وقت خطای قرمز نمی‌دهد و برای هر کدام یک پیام دوستانه دارد.

پیام دوستانه به کاربر می‌گوید چه کند، نه فقط اینکه اشتباه کرده. Error! یا ValueError به کاربر کمکی نمی‌کند. Please type a whole number یا Choose a number from 1 to 20 می‌گوید دقیقاً چه بنویسد. پیام کوتاه باشد و هیچ‌وقت کاربر را مسخره نکند.

بررسی متن: اول .strip() تا فاصله‌های اول و آخر بروند (پس «فقط فاصله» هم خالی حساب می‌شود). بعد خالی بودن را بگیر، و با len(name) بلندی را. بعد از هر پیام خطا return بنویس تا بقیه‌ی تابع اجرا نشود.

import app

def save_name():
    name = box.value.strip()
    if name == "":
        app.toast("Please type your name")
        return
    if len(name) > 12:
        app.toast("Name is too long (12 letters max)")
        return
    hello.value = f"Hi, {name}!"

app.title("Hello")
hello = app.text("Hi, friend!")
box = app.input("Name")
app.button("Save", save_name)
app.run()

بررسی عدد دو مرحله دارد. ۱) آیا اصلاً عدد است؟ int(...) را در try بگذار؛ اگر متن عدد نبود (یا خالی بود)، except ValueError آن را می‌گیرد. ۲) آیا در بازه است؟ هدف آب روزانه بین ۱ و ۲۰ لیوان معقول است، پس 0 و 25 هم پیام می‌گیرند.

import app

def set_goal():
    try:
        goal = int(goal_box.value)
    except ValueError:
        app.toast("Please type a whole number")
        return
    if goal < 1 or goal > 20:
        app.toast("Choose a number from 1 to 20")
        return
    note.value = f"Goal: {goal} glasses"

app.title("Water")
note = app.text("Goal: 8 glasses")
goal_box = app.number("Daily goal")
app.button("Save goal", set_goal)
app.run()

اگر اپ پنج کادر عدد داشته باشد، این هشت خط را پنج بار نمی‌نویسیم! تابع read_number(box, low, high) همه‌ی بررسی را یک جا انجام می‌دهد: اگر همه‌چیز درست بود عدد را برمی‌گرداند، وگرنه پیام می‌دهد و None برمی‌گرداند. None در پایتون یعنی «هیچی». کسی که آن را صدا می‌زند فقط می‌پرسد if goal is None: return.

import app

def read_number(box, low, high):
    try:
        n = int(box.value)
    except ValueError:
        app.toast("Please type a whole number")
        return None
    if n < low or n > high:
        app.toast(f"Choose a number from {low} to {high}")
        return None
    return n

def update():
    glasses = read_number(glasses_box, 0, 30)
    if glasses is None:
        return
    note.value = f"You drank {glasses} glasses"

app.title("Water")
note = app.text("")
glasses_box = app.number("Glasses")
app.button("Update", update)
app.run()

چرا if glasses is None و نه if not glasses؟ چون صفر هم یک عدد درست است! کسی که امروز هنوز آب نخورده می‌نویسد 0، و not 0 در پایتون True است. پس if not glasses جواب درستِ صفر را هم رد می‌کند.

گاهی فقط چند کلمه‌ی مشخص قبول است، مثلاً تم اپ فقط light یا dark. با in بپرس که کلمه در لیست کلمه‌های مجاز هست یا نه. .lower() کمک می‌کند Dark هم قبول شود.

import app

def set_theme():
    theme = theme_box.value.strip().lower()
    if theme not in ["light", "dark"]:
        app.toast("Type light or dark")
        return
    note.value = f"Theme: {theme}"

app.title("Settings")
note = app.text("Theme: light")
theme_box = app.input("Theme")
app.button("Set theme", set_theme)
app.run()

اشتباه‌های رایج: ۱) پیام دادی ولی return را جا انداختی، پس داده‌ی بد باز هم ذخیره شد. ۲) goal_box.value > 20 نوشتی؛ value همیشه متن است و پایتون متن را با عدد مقایسه نمی‌کند (TypeError). اول int. ۳) قبل از بررسی ذخیره کردی. اول همه‌ی بررسی‌ها، آخر سر app.save. ۴) عدد را به شکل متن ذخیره کردی ("6" به جای 6).

همین در HTML: در دوره‌ی «اپ با HTML» صفحه‌ی تنظیمات یک شیء settings دارد که با salam.save ذخیره می‌شود، و حالت تیره با یک کلاس روی body درست می‌شود. عدد را آنجا با Number() و isNaN بررسی می‌کنند، به جای int و try.

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

چالش‌ها

  1. The Friendliest Message (آسان)
  2. Catch the Bad Input (آسان)
  3. Hello, Name (آسان)
  4. Remember My Name (متوسط)
  5. Empty or Too Long (متوسط)
  6. A Goal That Makes Sense (متوسط)
  7. One Helper for Every Number (سخت)
  8. One Settings Dictionary (سخت)

بیشتر بخوان

← جلسه‌ی 14: چند صفحه جلسه‌ی 16: پروژه: آزمون‌ساز →