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

جلسه‌ی 2: اولین سرور تو Your First Server

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

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

درس

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

یادت هست؟ در جلسه‌ی ۱ از سایت‌های دیگران سؤال پرسیدیم: ask("https://jokes.test/jokes/4"). یک نفر سرور jokes.test را نوشته بود و آن سرور جواب می‌داد. امروز سرور خودت را می‌نویسی. وقتی آدرس با https:// شروع نشود (مثلاً ask("GET /"))، درخواست به سرور خودت می‌رود.

from server import ask

ask("https://jokes.test/jokes/4")

🍳 اولین سرور تو. app سرور توست و ask مشتری. خط @app.get("/") را مثل یک برچسب ببین که روی تابع زیرش می‌چسبد و می‌گوید: «هر وقت کسی با GET آدرس / را خواست، این تابع را اجرا کن». به این برچسب‌های @ در پایتون دکوراتور (decorator) می‌گویند. هر چه تابع با return برگرداند، بدنه‌ی پاسخ می‌شود و کد وضعیت 200 است. / تنها یعنی «صفحه‌ی اصلی».

from server import app, ask

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

ask("GET /")

🛣️ هر جفت «برچسب + تابع» یک مسیر (route) است. یک سرور هر چند مسیر بخواهد می‌تواند داشته باشد: صفحه‌ی اصلی، صفحه‌ی «درباره‌ی من»، فهرست بازی‌ها. هر مسیر آدرس خودش را دارد و همیشه با / شروع می‌شود. این‌جا سه مسیر داریم و از هر سه می‌پرسیم.

from server import app, ask

@app.get("/")
def home():
    return "Welcome to Kian's game club!"

@app.get("/about")
def about():
    return "I am Kian and I love chess."

@app.get("/games")
def games():
    return "Chess, Snake, Minecraft"

ask("GET /")
ask("GET /about")
ask("GET /games")

🚫 اگر کسی آدرسی بخواهد که هیچ مسیری برایش نساخته‌ای، سرور خودش جواب 404 Not Found می‌دهد، با پیامی که می‌گوید برای کدام درخواست مسیری نبود. لازم نیست برای این کاری کنی. آدرس‌ها دقیق‌اند: /games با /game یا /Games فرق دارد.

from server import app, ask

@app.get("/games")
def games():
    return "Chess, Snake, Minecraft"

ask("GET /games")
ask("GET /game")
ask("GET /pizza")

🏷️ مسیر و اسم تابع دو چیز جدا هستند. مشتری فقط مسیر را می‌بیند (/team)؛ اسم تابع (show_my_team) فقط برای خودت است تا کدت خوانا باشد. پس ask("GET /show_my_team") جواب 404 می‌گیرد. داخل تابع هم هر پایتونی که بلدی کار می‌کند: متغیر، حلقه، f-string؛ فقط آخرش با return متن را برگردان.

from server import app, ask

@app.get("/team")
def show_my_team():
    players = ["Sara", "Mina", "Omid"]
    return f"Team Red has {len(players)} players"

ask("GET /team")
ask("GET /show_my_team")

🌍 یک سرور واقعی چه شکلی است؟ سرور این دوره ساختگی است، ولی اسم‌هایش را از Flask گرفته‌ایم، یکی از معروف‌ترین ابزارهای پایتون برای ساختن سرور. یک سرور واقعی Flask تقریباً همین است:
``python
from flask import Flask

app = Flask(__name__)

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

app.run()
`
فرقش این است که
app.run() کامپیوتر را منتظر درخواست‌های واقعی از اینترنت نگه می‌دارد و مشتری‌ها مرورگرها و اپ‌های دیگرند، نه ask. این کد را این‌جا اجرا نکن (Flask در این صفحه نیست)؛ فقط ببین چقدر آشناست. سرور ما هم app.run()` را می‌شناسد، ولی کاری نمی‌کند.

اشتباه‌های رایج:
- جا انداختن return: تابع بدون return چیزی برنمی‌گرداند و برنامه با پیام «did you forget return?» می‌ایستد.
- مسیر بدون / اول: @app.get("games") خطا می‌دهد؛ درستش @app.get("/games") است.
- دو تابع برای یک مسیر: اگر دو بار @app.get("/games") بنویسی، سرور نمی‌داند کدام را اجرا کند و خطا می‌دهد.
- جا انداختن @: بدون آن، برچسبی چسبانده نمی‌شود و مسیر 404 می‌گیرد.

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

چالش‌ها

  1. Ask the Weather Site (آسان)
  2. My First Route (آسان)
  3. The Snack Shop (متوسط)
  4. A Missing Letter (متوسط)
  5. Team Page and Score (سخت)
  6. Fix the Pet Club (سخت)

بیشتر بخوان

← جلسه‌ی 1: سرور چیست؟ جلسه‌ی 3: کدهای وضعیت →