جلسهی 15: تنظیمات و خطاگیری کامل Settings and Catching Every Error
اپ صفحهی تنظیمات میگیرد: اسمی برای سلام و هدف روزانه، که ذخیره میشوند و صفحهی اصلی از آنها استفاده میکند. و هر ورودی بد یک پیام دوستانه میگیرد، با کمک تابع read_number.
در این جلسه یاد میگیری
- میتوانی صفحهی تنظیمات بسازی که مقدارهایش ذخیره شوند و در صفحهی اصلی به کار بیایند.
- میتوانی کادر خالی، متن خیلی بلند، حرف به جای عدد و عدد بیرون از بازه را بگیری.
- میتوانی پیام خطای دوستانه بنویسی که بگوید کاربر چه کند.
- میتوانی تابع
read_number(box, low, high)بنویسی که عدد یاNoneبرگرداند.
درس
تقریباً هر اپی صفحهی تنظیمات دارد: اسمی که اپ با آن سلام میکند، هدف روزانه، رنگ. همه را در یک دیکشنری نگه دار، مثل {"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.
مثالهای این جلسه
- مثال تابع (اپ با پایتون): def save_settings():
- مثال تابع (اپ با پایتون): def save_name():
- مثال مدیریت خطا با try (اپ با پایتون): try: — تنظیمات و خطاگیری کامل
- مثال مدیریت خطا با try (اپ با پایتون): try: — تنظیمات و خطاگیری کامل 2
- مثال تابع (اپ با پایتون): def set_theme():
چالشها
- The Friendliest Message (آسان)
- Catch the Bad Input (آسان)
- Hello, Name (آسان)
- Remember My Name (متوسط)
- Empty or Too Long (متوسط)
- A Goal That Makes Sense (متوسط)
- One Helper for Every Number (سخت)
- One Settings Dictionary (سخت)