משימה 1: האפליקציה וה‑repository שלה

עד משימה 3 עובדים על main עצמו: commit אחד לכל route, ו‑push תוך כדי.

1. כתבו route אחד וה‑tests שלו, והריצו את ה‑tests.

2. עשו commit ו‑push. הוסיפו את הקבצים בשמם, אלה שה‑commit הזה עוסק בהם, ולעולם לא git add .: הוא היה סוחף פנימה כל דבר אחר שיש בתיקייה, ‏.venv/ או __pycache__/.

   1$ git status
   2$ git add app/main.py tests/test_books.py
   3$ git commit -m "Add POST /books"
   4$ git push
   

3. המשיכו ל‑route הבא.

מחלקים את ה‑routes, כל אחד כותב את שלו ב‑branch משלו, וכל אחד עושה merge ל‑branch שלו לתוך main בעצמו. עדיין בלי pull requests: הם מגיעים במשימה 3.

1. כתבו את החלק המשותף ביחד, מול מקלדת אחת: האפליקציה, האחסון והבדיקות של שדות הספר, שכל route משתמש בהם. עשו לו push ל‑main.

2. חלקו את ה‑routes לשני issues ב‑GitHub, כל אחד משויך לאחד מכם, כל route עם ה‑tests שלו:

   • issue #1, סטודנט A: ‏POST /books, ‏GET /books ו‑GET /books/<id>;
   • issue #2, סטודנט B: ‏PUT /books/<id>, ‏DELETE /books/<id> ו‑GET /healthz.

3. כל אחד עובד ב‑branch שנקרא על שם ה‑issue, כמו ש התוכנית קוראת להם: ‏feature/1-create-and-read ו‑feature/2-update-and-delete.

   1$ git switch main
   2$ git pull
   3$ git switch -c feature/1-create-and-read
   

4. עשו commit תוך כדי, ו‑push ל‑branch, כדי שהשותף יראה אותו.

   • הוסיפו את הקבצים בשמם, ולעולם לא git add .: הוא היה סוחף פנימה כל דבר אחר שיש בתיקייה.
   • שמרו את ה‑tests שלכם בקובץ משלכם, ‏tests/test_create_read.py או tests/test_update_delete.py, כך ששניכם משנים רק קובץ משותף אחד.

   1$ git status
   2$ git add app/main.py tests/test_create_read.py
   3$ git commit -m "Add POST /books"
   4$ git push -u origin feature/1-create-and-read
   

5. עשו merge לתוך main כשה‑routes שלכם וה‑tests שלהם עוברים:

   1$ git switch main
   2$ git pull
   3$ git merge feature/1-create-and-read
   4$ git push
   

   • מי שעושה merge ראשון מוצא את main כמו שהיה בצעד 1: ‏git מקדם את main, בלי conflict.

6. מי שעושה merge שני מריץ את אותן הפקודות, ו‑git pull מביא קודם את ה‑routes של השותף.

   • שניכם הוספתם routes באותו קובץ, ולכן git merge עלול לעצור שם עם conflict.
   • פתחו את הקובץ, השאירו את ה‑routes של שני הצדדים, ומחקו את סימני ה‑conflict (‏<<<<<<<, ‏=======, ‏>>>>>>>).
   • הריצו את כל ה‑tests, של שני הסטודנטים, ואז סמנו את הקובץ כפתור בכך שתוסיפו אותו, סיימו את ה‑merge ועשו push:

   1$ git add app/main.py
   2$ git commit
   3$ git push
   

7. שניכם עושים pull ל‑main, ומריצים את ה‑tests: עכשיו לכל אחד יש את כל ה‑API.

• אם git push ל‑main נדחה כי השותף עשה push קודם, הריצו git pull, ואז push שוב.

• route הוא function רגילה לכל method ו‑path.
• את הבדיקות מטבלת השדות כותבים בעצמכם: Flask נותן לכם את ה‑JSON המפוענח ותו לא.
• Flask עונה 422 רק כשאתם מחזירים אותו, עם גוף השגיאה, מהבדיקות שלכם.
• על גוף שאינו JSON, ‏Flask עונה 400 מעצמו: קראו את הגוף במצב שמחזיר כלום במקום זה, וענו 422.

• הספר הוא Pydantic model: טבלת השדות, כתובה כ‑types ומגבלות.
• FastAPI בודק כל גוף מול ה‑model ועונה 422 מעצמו.
  • גם גוף שאינו JSON הוא 422.
  • גוף השגיאה שלו הוא {"detail": [...]}, עם רשימה של כל השדות שנכשלו; השאירו אותו כך.
• ספר שחסר — עליכם לענות עליו: זרקו את ה‑HTTP exception של FastAPI עם 404.
• ה‑model גם מצייר את דף ה‑OpenAPI, ב‑/docs: נסו שם כל route.