תכנות — שיעור 70 27/November/2008    

מחרוזת תיעוד בפייתון

בפייתון כשבתחילת הפונקציה (או ב- class) מופיעה מחרוזת (string), היא משמשת לתיעוד של הפונקציה. בעגה של פייתון זה נקרא docstring. אנחנו משתמשים בזה לדוגמא בפונקציה Board.draw_rects_card(...) באחת הגירסאות שלנו של setgame. ניתן לגשת למחרוזת הזאת על ידי הוספת .__doc__ לשם הפונקציה. להלן דוגמא:

Set-Game

ּאחד המשתתפים הציג פתרון שלו לתרגיל של שעור קודם. הפתרון (שלו) נמצא בגירסא: setgame-2008-11-28-095251.tar .

תרגילים

1. הורד את הגירסא setgame-2008-11-28-095251.tar עם הפתרון שהוצג בשעור. הבן היטב כיצד הפונקציה
   Board.draw_rects_card(...)
   עובדת.
2. הורד את הגירסא (חדשה יותר) setgame-2008-11-28-113854.tar .
   בגירסא זו יש שינויים לעומת הגירסא הקודמת:
   • במקום הצבע הכחול value.BLUE עברנו לצבע סגול value.PURPLE לכן יש לתקן את קביעת הצבע בפונקציה Board.draw_rects_card(...) .
   • לפונקציה Board.draw_rects_card(...)  נוסף פרמטר: selected. כאשר הוא True, על הפונקציה לצייר מסגרת שחורה סביב הקלף. זה מתבצע על ידי קריאה לפונקציה
     Board.draw_card_frame(...)
     הפונקציה ממומשת רק בחלקה. השלם את החסר.
     
   במקומות בקוד בהם יש לתקן או להוסיף, ישנן הערות עם 5 סימני קריאה. לאחר השיפורים, ההערות יהפכו להיות מיושנות ובלתי נכונות, ולכן מחק אותן.