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

جلسه‌ی 6: خواندن و افزودن Reading and Appending

اسکریپتی که فقط می‌نویسد نصف کاره است؛ باید بتواند بخواند: لیست فایل‌ها را از یک فایل، تنظیمات را از یک فایل. و باید لاگ بنویسد: به آخر فایل اضافه کند، نه پاکش کند. امروز read، splitlines، strip و حالت "a".

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

درس

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

یادت هست؟ جلسه‌ی پیش با open(..., "w") فایل ساختیم و دیدیم w فایل قبلی را پاک می‌کند. امروز دو حالت دیگر: "r" برای خواندن (read) و "a" برای افزودن (append). اگر حالت را ننویسی، پیش‌فرض "r" است.

with open("todo.txt", "w") as f:
    f.write("rename photos\n")
    f.write("backup projects\n")
print("todo.txt written")

خواندن: open("todo.txt") و بعد f.read() کل متن فایل را به شکل یک رشته می‌دهد. .splitlines() آن را به لیست خط‌ها تبدیل می‌کند (بدون \n آخر هر خط). حالا می‌توانی روی خط‌ها for بزنی؛ درست مثل لیست اسم‌ها در فاز ۱، فقط این بار از فایل آمده‌اند. یادت باشد فایل را باید قبلاً ساخته باشی.

with open("todo.txt", "w") as f:
    f.write("rename photos\n")
    f.write("backup projects\n")

with open("todo.txt") as f:
    lines = f.read().splitlines()
print(f"{len(lines)} tasks")
for line in lines:
    print(f"- {line}")

فایل‌هایی که آدم‌ها می‌نویسند تمیز نیستند: فاصله‌ی اضافه اول خط، یک خط خالی آخر فایل. line.strip() فاصله و تب و خط‌جدید را از دو طرف برمی‌دارد. خط‌های خالی را هم با if line == "": continue رد کن. بدون این دو، "photos " با "photos" برابر نیست و اسکریپتت فایل را پیدا نمی‌کند.

with open("names.txt", "w") as f:
    f.write("  IMG_001.jpg \n")
    f.write("IMG_002.jpg\n")
    f.write("\n")

with open("names.txt") as f:
    for line in f.read().splitlines():
        name = line.strip()
        if name == "":
            continue
        print(f"[{name}]")

لاگ: اسکریپتی که شب‌ها خودش اجرا می‌شود باید جایی بنویسد چه کرد، و هر شب به آخر همان فایل اضافه کند. حالت "a" (append) همین است: اگر فایل نبود می‌سازد، اگر بود دست به محتوای قبلی نمی‌زند و از آخر ادامه می‌دهد. هر بار که اسکریپتت کار مهمی می‌کند، یک خط به log.txt اضافه کن.

with open("log.txt", "a") as f:
    f.write("backup started\n")
with open("log.txt", "a") as f:
    f.write("backup done\n")

with open("log.txt") as f:
    print(f.read())

الگوی رایج اسکریپت‌ها: بخوان، تغییر بده، بنویس. لیست اسم‌ها را از names.txt می‌خوانی، نقشه‌ی تغییر نام را می‌سازی و نقشه را در plan.txt می‌نویسی تا کسی قبل از اجرا نگاهش کند. ورودی و خروجی دو فایل جدا هستند؛ هیچ‌وقت فایل ورودی را با "w" باز نکن، چون همان لحظه پاک می‌شود.

with open("names.txt", "w") as f:
    f.write("IMG_001.jpg\nnotes.txt\nIMG_002.jpg\n")

with open("names.txt") as f:
    names = f.read().splitlines()

with open("plan.txt", "w") as out:
    for name in names:
        if name.startswith("IMG_"):
            out.write(f"{name} -> {name.replace('IMG_', 'ordu_', 1)}\n")

with open("plan.txt") as f:
    print(f.read())

اشتباه رایج: print(f.read()) یک خط خالی اضافه آخرش دارد، چون فایل با \n تمام می‌شود و print هم یکی اضافه می‌کند؛ در این دوره خط خالی آخر مهم نیست، ولی وسط متن مهم است. و اگر FileNotFoundError گرفتی یعنی فایل را قبلاً نساخته‌ای یا اسمش را اشتباه نوشته‌ای.

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

چالش‌ها

  1. How Many Lines? (آسان)
  2. Read It Back (آسان)
  3. Tidy the Lines (متوسط)
  4. Keep a Log (متوسط)
  5. (Harder) Read, Change, Write (سخت)
  6. (Harder) The Last Line of the Log (سخت)

بیشتر بخوان

← جلسه‌ی 5: ساختن فایل و پوشه جلسه‌ی 7: مرتب‌سازی با پسوند →