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

جلسه‌ی 23: منوی دستیار The Assistant Menu

تا حالا هر اسکریپت یک کار می‌کرد و تمام می‌شد. دستیار فرق دارد: منتظر می‌ماند، دستور می‌گیرد، انجام می‌دهد و دوباره منتظر می‌ماند، تا بگویی quit. حلقه‌ی while True، یک تابع برای هر دستور، دیکشنری دستور → تابع، help و پیام برای دستور ناشناس.

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

درس

🛡️ قانون این دوره: اسکریپت فقط نشان می‌دهد یا می‌سازد. اسکریپت‌های ما فایل می‌خوانند، لیست می‌کنند، می‌سازند و کپی می‌کنند؛ هیچ‌وقت چیزی را بی‌خبر پاک نمی‌کنند. همه‌چیز در یک پوشه‌ی تمرینی خالی اجرا می‌شود که هر بار از نو ساخته می‌شود، پس هر چه می‌خواهی امتحان کن: چیزی خراب نمی‌شود. روی کامپیوتر خودت هم همیشه اول یک پوشه‌ی practice بساز و فقط داخل آن کار کن.

یادت هست؟ مینی‌شل جلسه‌ی ۱۶ n دستور را می‌خواند و با if/elif اجرا می‌کرد. دو مشکل داشت: باید از قبل می‌دانست چند دستور می‌آید، و با هر دستور جدید زنجیره‌ی elif بلندتر می‌شد. دستیار امروز هر دو را حل می‌کند.

command = "echo hello"
parts = command.split(maxsplit=1)
if parts[0] == "echo":
    print(parts[1])

while True: حلقه‌ای است که خودش تمام نمی‌شود؛ هر بار یک دستور می‌خواند و اجرا می‌کند. تنها راه خروج break است، وقتی کاربر quit بزند. این شکلِ همه‌ی برنامه‌های تعاملی است: ترمینال، ربات چت، منوی بازی. بعد از حلقه یک Bye! بگذار تا معلوم شود تمیز تمام شده.

# The run button sends these lines as the answers to input():
# hello / hello / quit
while True:
    command = input("> ")
    if command == "quit":
        break
    print(f"you said: {command}")
print("Bye!")

هر دستور را در یک تابع جدا بنویس: def do_count(): .... بعد به‌جای زنجیره‌ی elif، یک دیکشنری بساز که اسم دستور را به تابعش وصل می‌کند: commands = {"count": do_count, "list": do_list}. توجه: do_count بدون پرانتز؛ داریم خود تابع را ذخیره می‌کنیم، نه نتیجه‌اش را. اجرا: commands[name](). دستور جدید = یک تابع + یک خط در دیکشنری.

import os


def do_count():
    print(f"{len(os.listdir('.'))} files")


def do_list():
    for name in sorted(os.listdir(".")):
        print(name)


commands = {"count": do_count, "list": do_list}
commands["count"]()

دستیار باید با دستور اشتباه مهربان باشد: if name not in commands: print(f"Unknown command: {name}") و ادامه بدهد، نه اینکه بمیرد. و یک دستور help که فهرست دستورها را به ترتیب حروف می‌دهد: for name in sorted(commands): print(name). چون help و quit خودشان در دیکشنری نیستند، قبل از نگاه کردن به دیکشنری چکشان کن.

commands = {"count": None, "list": None}
for name in ["help", "dance", "count"]:
    if name == "help":
        print("commands: " + ", ".join(sorted(commands)))
    elif name not in commands:
        print(f"Unknown command: {name}")
    else:
        print(f"running {name}")

بعضی دستورها آرگومان دارند: add notes.txt. خط را با split(maxsplit=1) به اسم دستور و بقیه تکه کن؛ اگر فقط یک تکه بود، آرگومان خالی است. تابع‌های دستور همه یک شکل باشند: def do_add(arg): ...، حتی آن‌هایی که آرگومان لازم ندارند (def do_count(arg):)، تا بشود همه را یک‌جور صدا زد: commands[name](arg).

def do_add(arg):
    with open(arg, "w") as f:
        f.write("")
    print(f"added {arg}")


def do_count(arg):
    import os
    print(f"{len(os.listdir('.'))} files")


commands = {"add": do_add, "count": do_count}
for line in ["add notes.txt", "add todo.txt", "count"]:
    parts = line.split(maxsplit=1)
    name = parts[0]
    arg = parts[1] if len(parts) > 1 else ""
    commands[name](arg)

اشتباه‌های رایج: commands = {"count": do_count()} با پرانتز، تابع را همان لحظه اجرا می‌کند و نتیجه‌اش (None) را ذخیره می‌کند. while True بدون break هیچ‌وقت تمام نمی‌شود؛ در ادیتور سایت وقتی ورودی تمام شود خطای EOFError می‌گیری، پس quit را همیشه آخرِ ورودی بگذار. و parts[1] وقتی آرگومان نیست IndexError می‌دهد؛ اول len(parts) را چک کن.

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

چالش‌ها

  1. What Does It Print? (آسان)
  2. Until quit (آسان)
  3. A Dictionary of Functions (متوسط)
  4. help and Unknown (متوسط)
  5. (Harder) Commands with Arguments (سخت)
  6. (Harder) Command History (سخت)

بیشتر بخوان

← جلسه‌ی 22: نگهبان جلسه‌ی 24: پروژه‌ی پایانی: دستیار من →