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

جلسه‌ی 4: پروژه: سرور اطلاعات کلاس Project: The Class Info Server

پایان فاز ۱. هر چه درباره‌ی درخواست و پاسخ یاد گرفتی یک بار دیگر در یک نگاه می‌بینی: مشتری و سرور، مسیرها با @app.get، کدهای وضعیت و abort. بعد پروژه‌ی «سرور اطلاعات کلاس ۹ب»: صفحه‌ی اصلی، معلم، برنامه‌ی هفتگی که از یک دیکشنری ساخته می‌شود، یک 404 مخصوص خودش و یک بررسی کوچک که همه‌ی مسیرها را امتحان می‌کند.

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

درس

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

📌 جلسه‌ی ۱ در یک نگاه: مشتری و سرور. مشتری (فرانت‌اند، سالن رستوران) درخواست می‌فرستد و سرور (بک‌اند، آشپزخانه) جواب می‌دهد؛ API منوی رستوران است. درخواست = روش + آدرس (GET https://weather.test/today?city=Tehran). پاسخ = کد وضعیت + بدنه. ask(...) می‌فرستد و چاپ می‌کند؛ با quiet=True چیزی چاپ نمی‌کند و تو با r.status و r.json["temp"] کار می‌کنی.

from server import ask

r = ask("https://weather.test/today?city=Shiraz", quiet=True)
print(r.status, r.json["city"], r.json["temp"])

📌 جلسه‌ی ۲ در یک نگاه: سرور خودت. from server import app, ask. برچسب @app.get("/path") تابع زیرش را به یک آدرس گره می‌زند و هر چه تابع return کند بدنه‌ی پاسخ می‌شود. هر مسیر آدرس خودش را دارد و با / شروع می‌شود. آدرسی که مسیر ندارد خودبه‌خود 404 می‌گیرد. مشتری اسم مسیر را می‌بیند، نه اسم تابع را. یک سرور واقعی Flask تقریباً همین شکل است.

from server import app, ask

@app.get("/")
def home():
    return "Hello from my server!"

ask("GET /")
ask("GET /home")

📌 جلسه‌ی ۳ در یک نگاه: کدهای وضعیت. 2xx خوب (200، 201)، 4xx اشتباه مشتری (400، 401، 403، 404، 405)، 5xx خرابی سرور (500). return "...", 403 کد را انتخاب می‌کند؛ abort(404, "...") همان‌جا می‌ایستد و {"error": "..."} می‌فرستد. r.ok برای 2xx درست است. GET می‌خواند، POST می‌فرستد و روشی که تابع ندارد 405 می‌گیرد.

from server import app, ask, abort

@app.get("/secret")
def secret():
    abort(403, "not for you")

ask("GET /secret")
ask("POST /secret")
print(ask("GET /secret", quiet=True).ok)

⚠️ اشتباه‌های رایج این فاز:
- ?city=... جاافتاده (400) یا اسم سایت غلط.
- کلید با حروف بزرگ: r.json["Temp"] به‌جای r.json["temp"].
- تابع بدون return، مسیر بدون / اول، یا دو تابع برای یک مسیر.
- آدرس‌ها دقیق‌اند: /Teacher با /teacher فرق دارد و 404 می‌گیرد.
- return 404, "..." به‌جای return "...", 404.
- فرستادن خطا با 200.
- جا انداختن abort در from server import ....

🏫 پروژه: سرور اطلاعات کلاس ۹ب. بچه‌های کلاس همیشه می‌پرسند «امروز چی داریم؟» و «معلممان کیست؟». تو سروری می‌سازی که جواب بدهد، در سه قدم:
1. صفحه‌ی اصلی (/) و صفحه‌ی معلم (/teacher).
2. برنامه‌ی هفتگی (/schedule) که از یک دیکشنری ساخته می‌شود.
3. یک 404 مخصوص خودت برای /exam با abort، و یک «بررسی» در آخر برنامه که همه‌ی مسیرها را بی‌صدا امتحان می‌کند.
هر قدم روی کد قدم قبل ساخته می‌شود؛ دکمه‌ی «ادامه از کد مرحله‌ی قبلم» کدت را می‌آورد.

🧵 چند خط در یک پاسخ. بدنه‌ی یک پاسخ می‌تواند چند خط باشد. راه تمیزش: خط‌ها را در یک لیست جمع کن و با "\n".join(lines) به هم بچسبان. join متن جلویش را بین تکه‌های لیست می‌گذارد: ", ".join(["Math", "Art"]) می‌شود Math, Art و "\n" یعنی «خط تازه». چون فقط بین تکه‌ها می‌گذارد، آخر متن خط خالی اضافه نمی‌شود. برای ساختن خط‌ها هم روی دیکشنری حلقه بزن: for day in schedule: کلیدها را به همان ترتیبی که نوشته‌ای می‌دهد.

print(", ".join(["Math", "Art", "Sport"]))

clubs = {"Chess": "Sunday", "Robots": "Tuesday"}
lines = []
for name in clubs:
    lines.append(name + " club: " + clubs[name])
print("\n".join(lines))

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

چالش‌ها

  1. The Journey of a Request (آسان)
  2. Which Code? (آسان)
  3. A Capital Letter (متوسط)
  4. Step 1: Home and Teacher (متوسط)
  5. Step 2: The Weekly Schedule (سخت)
  6. Step 3: A 404 of Its Own and a Check (سخت)

بیشتر بخوان

← جلسه‌ی 3: کدهای وضعیت جلسه‌ی 5: پارامتر در آدرس →