נושא
לכתוב טוב
מה שהקורס מבקש מעבר לקוד שרץ. PEP 8, ועוד שני הרגלים.
הקוד ירוץ גם בלי הכללים האלה. פייתון לא אוכפת אותם. הם קיימים בשביל מי שיקרא את הקוד, כולל אתם בעוד חודש. המסמך שמרכז אותם הוא PEP 8.
שמות
| כלל | נכון | לא |
|---|---|---|
| אותיות קטנות | character |
Character |
| מילים מופרדות בקו תחתון | nose_length |
noselength, noseLength |
| קבוע באותיות גדולות | PI = 3.14 |
pi = 3.14 |
| שם שאומר מה יש בו | fairy_tale_file_with_extension |
file |
קבוע הוא הבטחה, לא נעילה. פייתון תאפשר לשנות את PI. האחריות על
המתכנת.
גודל אות משנה. nose_length ו-Nose_length הם שני משתנים. זה
חוקי, ובדיוק בגלל זה מבלבל.
רווחים
| כלל | נכון | לא |
|---|---|---|
| משני צדי אופרטור | x = a + 1 |
x=a+1 |
| אחרי פסיק | f(a, b, c) |
f(a,b,c) |
| פרמטר אחד | f(a) |
f( a ) |
ביטוי לוגי ארוך
כל תנאי בסוגריים, ורווחים סביב האופרטורים:
((sandwiches >= 1) and (sandwiches < 4)) or (bowls_of_soup == 2)
טיפוס קבוע למשתנה
משתנה שהתחיל כמספר נשאר מספר. לעבור ממנו למחרוזת זה אפשרי, וbad practice.
בדיקה עצמית
מה לא בסדר, לפי PEP 8?
NumberOfStudents=30MAX_SCORE = 100, כשהערך משתנה בהמשך התוכניתprint(a,b)
תשובות. 1: אותיות גדולות וחסרים רווחים, צריך
number_of_students = 30. 2: אותיות גדולות שמורות לקבוע, וזה לא קבוע.
3: חסר רווח אחרי הפסיק.