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

جلسه‌ی 17: فایل‌ها و خروجی Files and Export

داده‌ی اپ می‌تواند از اپ بیرون برود: گزارش متنی در یک فایل می‌نویسی، آن را دوباره می‌خوانی، با app.download به کاربر فایل می‌دهی و برای جدول‌ها فایل CSV می‌سازی.

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

درس

app.save داده را داخل اپ نگه می‌دارد: فقط خود اپ آن را می‌بیند. ولی گاهی داده باید بیرون برود: گزارش خرج‌ها برای پدر و مادر، فهرست کلمه‌ها برای چاپ، نمره‌ها برای یک جدول. برای این کار فایل می‌سازیم.

یادت هست؟ open("report.txt", "w", encoding="utf-8") فایل را برای نوشتن باز می‌کند و f.write(text) متن را در آن می‌نویسد. "w" هر چه از قبل در فایل بود پاک می‌کند. encoding="utf-8" را همیشه بنویس تا حروف فارسی و ایموجی خراب نشوند. with فایل را آخر کار خودش می‌بندد.

import app

def write_note():
    with open("note.txt", "w", encoding="utf-8") as f:
        f.write(box.value)
    app.toast("Saved to note.txt")

app.title("Notes")
box = app.input("Note")
app.button("Write file", write_note)
app.run()

برای خواندن، فایل را بدون "w" باز کن و f.read() همه‌ی متن را می‌دهد. ولی اگر فایل هنوز ساخته نشده باشد، پایتون خطای FileNotFoundError می‌دهد. پس خواندن را در try بگذار و به جای خطای قرمز پیام دوستانه بده.

import app

def read_note():
    try:
        with open("note.txt", encoding="utf-8") as f:
            shown.value = f.read()
    except FileNotFoundError:
        app.toast("No file yet")

app.title("Notes")
app.button("Read file", read_note)
shown = app.text("")
app.run()

فایلی که با open می‌نویسی در حافظه‌ی پروژه می‌ماند. برای اینکه کاربر فایل را بگیرد (روی کامپیوتر یا گوشی‌اش)، app.download("report.txt", text) بنویس. اسم اول، اسم فایل است و دومی متن داخلش. در پنجره‌ی گوشی یک فایل برای دانلود ظاهر می‌شود.

import app

def download():
    app.download("hello.txt", "Hello from my app!")
    app.toast("Your file is ready")

app.title("Download")
app.button("Get file", download)
app.run()

گزارش معمولاً چند خط دارد. هر خط را با lines.append(...) به یک لیست اضافه کن، و آخر سر "\n".join(lines) همه را با «خط بعد» به هم می‌چسباند. بدون \n همه‌ی خط‌ها در یک خط دراز می‌آیند.

import app

tasks = ["Homework", "Read a book", "Tidy my desk"]

def make_report():
    lines = ["My tasks:"]
    for task in tasks:
        lines.append("- " + task)
    text = "\n".join(lines)
    app.download("tasks.txt", text)

app.title("Report")
app.button("Download", make_report)
app.run()

CSV یک فایل متنی ساده برای جدول است: هر سطر یک خط، و خانه‌ها با ویرگول جدا. خط اول اسم ستون‌هاست، مثل item,price. اکسل و برنامه‌های جدول آن را باز می‌کنند. ",".join([...]) یک سطر می‌سازد، ولی فقط از متن؛ پس عدد را با str() متن کن، وگرنه TypeError می‌گیری.

import app

spending = [{"item": "Pen", "price": 5}, {"item": "Book", "price": 12}]

def export_csv():
    lines = ["item,price"]
    for s in spending:
        lines.append(",".join([s["item"], str(s["price"])]))
    app.download("spending.csv", "\n".join(lines))

app.title("Pocket Money")
app.button("Export CSV", export_csv)
app.run()

اشتباه‌های رایج: ۱) فایل را بدون "w" برای نوشتن باز کردی؛ پایتون فکر می‌کند می‌خواهی بخوانی. ۲) encoding="utf-8" را جا انداختی و فارسی خراب شد. ۳) "\n".join را فراموش کردی و همه چیز یک خط شد. ۴) عدد را بدون str() به join دادی. ۵) اگر خود متن ویرگول داشته باشد، ستون‌های CSV به هم می‌ریزند؛ ساده‌ترین راه: text.replace(",", " ").

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

همین در HTML: در دوره‌ی «اپ با HTML» کل اپ از استودیو به شکل یک فایل .html خروجی گرفته می‌شود و روی گوشی باز می‌شود، و داده‌ها به شکل متن پشتیبان (JSON) کپی می‌شوند. اینجا پایتون با open و app.download فایل می‌سازد.

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

چالش‌ها

  1. What Does "w" Do? (آسان)
  2. Inside or Outside? (آسان)
  3. Write a Note (آسان)
  4. Read It Back (متوسط)
  5. Download the Tasks (متوسط)
  6. One CSV Row (متوسط)
  7. Export a CSV (سخت)
  8. Pocket Money Report (سخت)

بیشتر بخوان

← جلسه‌ی 16: پروژه: آزمون‌ساز جلسه‌ی 18: اپ من ۱ →