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

جلسه‌ی 21: کار با فایل‌ها Working With Files

خواندن و نوشتن فایل متنی به روش درست: with open، حالت‌های r/w/a، تعیین encoding و الگوهای رایج پردازش خط‌به‌خط.

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

درس

open یک شیء فایل برمی‌گرداند. با with (context manager) فایل در پایان بلوک خودکار بسته می‌شود، حتی اگر استثنا رخ دهد. همیشه encoding="utf-8" را صریح بده؛ پیش‌فرض به سیستم‌عامل بستگی دارد.

with open("notes.txt", "w", encoding="utf-8") as f:
    f.write("first line\n")

with open("notes.txt", encoding="utf-8") as f:
    print(f.read())

حالت‌ها: "r" خواندن (پیش‌فرض؛ اگر فایل نباشد FileNotFoundError)، "w" نوشتن (فایل را خالی می‌کند یا می‌سازد)، "a" افزودن به انتها. write خودش \n اضافه نمی‌کند؛ print(..., file=f) اضافه می‌کند.

with open("app.log", "w", encoding="utf-8") as f:
    f.write("boot\n")
with open("app.log", "a", encoding="utf-8") as f:
    print("ready", file=f)
    f.writelines(["tick\n", "tick\n"])

شیء فایل iterable است: for line in f خط‌به‌خط می‌خواند و برای فایل‌های بزرگ کارآمد است. هر خط \n انتهایی دارد؛ با rstrip("\n") یا strip() تمیزش کن. readline() فقط یک خط را برمی‌گرداند (در انتهای فایل رشته‌ی خالی).

with open("app.log", encoding="utf-8") as f:
    header = f.readline().strip()
    rest = [line.strip() for line in f]
print(header, rest)

read() کل فایل را یک رشته و readlines() لیست خطوط برمی‌گرداند؛ هر دو کل فایل را در حافظه می‌گذارند. برای پردازش جریانی (لاگ چندگیگابایتی) پیمایش خط‌به‌خط را ترجیح بده.

برای بررسی وجود فایل از os.path.exists یا pathlib.Path(...).exists() استفاده کن، یا به سبک EAFP FileNotFoundError را بگیر. مسیرها را نسبی نگه دار؛ کد قابل‌حمل به پوشه‌ی خاصی وابسته نیست.

from pathlib import Path

path = Path("settings.txt")
if not path.exists():
    path.write_text("theme=dark\n", encoding="utf-8")
print(path.read_text(encoding="utf-8").strip())

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

چالش‌ها

  1. Write Then Read (آسان)
  2. Save Input Lines (آسان)
  3. Append Mode (آسان)
  4. Config Reader (متوسط)
  5. Log Level Counts (متوسط)
  6. Header With Readline (متوسط)
  7. Transform File to File (متوسط)
  8. Word Count Tool (سخت)
  9. Tail (سخت)
  10. Merge Sorted Files (سخت)
  11. Encoding Matters (متوسط)
  12. Create If Missing (متوسط)

بیشتر بخوان

← جلسه‌ی 20: پرتاب استثنا و استثنای سفارشی جلسه‌ی 22: قالب داده‌ی JSON →