Week 8 fixes + Dafi's proofreading

Author: yammesicka

week8/4_Exceptions_Part_2.ipynb

@@ -576,7 +576,7 @@
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    התרעה על חריגה, כפי שלמדנו, היא דרך לדווח למתכנת שמשהו בעייתי התרחש בזמן ריצת התוכנית.<br>\n",
-    "    נוכל ליצור התרעות כאלו בעצמנו כדי להודיע למתכנתים שמשתמשים בקוד שכתבנו, על בעיות אפשריות.\n",
+    "    נוכל ליצור התרעות כאלו בעצמנו, כדי להודיע על בעיות אפשריות למתכנתים שמשתמשים בקוד שלנו.\n",
     "</p>"
    ]
   },
@@ -1251,29 +1251,40 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
+   "execution_count": 343,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 343,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "import os\n",
     "import pathlib\n",
     "\n",
     "\n",
-    "def is_path_writeble(filepath):\n",
-    "    \"\"\"Return if the path is writeable.\"\"\"\n",
+    "def is_path_writable(filepath):\n",
+    "    \"\"\"Return if the path is writable.\"\"\"\n",
     "    path = pathlib.Path(filepath)\n",
     "    directory = path.parent\n",
     "\n",
-    "    is_dir_writeable = directory.is_dir() and os.access(directory, os.W_OK)\n",
+    "    is_dir_writable = directory.is_dir() and os.access(directory, os.W_OK)\n",
     "    is_exists = path.exists()\n",
-    "    is_file_writeable = path.is_file() and os.access(path, os.W_OK)\n",
+    "    is_file_writable = path.is_file() and os.access(path, os.W_OK)\n",
     "    \n",
-    "    return is_dir_writeable and ((not is_exists) or is_file_writeable)\n",
+    "    return is_dir_writable and ((not is_exists) or is_file_writable)\n",
     "\n",
     "\n",
     "def write_textfile(filepath, text):\n",
     "    \"\"\"Safely write `text` to `filepath`.\"\"\"\n",
-    "    if is_path_writeble(filepath):\n",
+    "    if is_path_writable(filepath):\n",
     "        with open(filepath, 'w', encoding='utf-8') as f:\n",
     "            f.write(text)\n",
     "        return True\n",
@@ -1383,7 +1394,7 @@
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    אם תגיעו למצב שבו אתם משתיקים חריגות, עצרו ושאלו את עצמכם אם זה הפתרון הטוב ביותר.<br>\n",
-    "    לרוב, עדיף יהיה לטפל בהתרעה על החריגה ולדאוג להביא את התוכנה למצב תקין,<br>\n",
+    "    לרוב, עדיף יהיה לטפל בהתרעה על החריגה ולהביא את התוכנה למצב תקין,<br>\n",
     "    או לפחות לשמור את פרטי ההתרעה לקובץ המתעד את ההתרעות על החריגות שהתרחשו בזמן ריצת התוכנה.     \n",
     "</p>"
    ]
@@ -1604,7 +1615,7 @@
     "<ol style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    <li><var>load_file</var> – טוענת קובץ טבלאי שהשורה הראשונה שבו היא כותרת, והעמודות שבו מופרדת זו מזו בתו |.<br>\n",
     "        הפונקציה תחזיר רשימה של מילונים. כל מילון ברשימה ייצג שורה בקובץ. המפתחות של כל מילון יהיו שמות השדות מהכותרת.</li>\n",
-    "    <li><var>get_user</var> – שמקבלת את שם המשתמש, ומחזירה את מספר המשתמש שלו.</li>\n",
+    "    <li><var>get_user_id</var> – שמקבלת את שם המשתמש, ומחזירה את מספר המשתמש שלו.</li>\n",
     "    <li><var>get_password</var> – שמקבלת שני מספרים סידוריים של משתמשים ומחזירה את סיסמת ההתקשרות בינם.</li>\n",
     "    <li><var>decrypt_file</var> – שמקבלת מפתח ונתיב לקובץ, ומפענחת אותו באמצעות הפונקציה <var>decrypt</var>.</li>\n",
     "</ol>"
@@ -1639,7 +1650,7 @@
     "    S = list(range(256))\n",
     "    j = 0\n",
     "\n",
-    "    for i in list(range(256)):\n",
+    "    for i in range(256):\n",
     "        j = (j + S[i] + ord(key[i % len(key)])) % 256\n",
     "        S[i], S[j] = S[j], S[i]\n",
     "\n",

week8/5_Summary.ipynb

@@ -27,8 +27,8 @@
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    בהנדסת חשמל, \"שער לוגי\" הוא רכיב בסיסי ולו כניסה אחת או יותר, ויציאה אחת בלבד.<br>\n",
-    "    הכניסות בשער הלוגי משמשות בתור הקלט שלו, והיציאה בתור הפלט שלו.<br>\n",
-    "    כל כניסה יכול לקבל את הערך \"אמת\" או \"שקר\".<br>\n",
+    "    הכניסות בשער הלוגי משמשות בתור הקלט שלו, והיציאה בתור הפלט.<br>\n",
+    "    כל כניסה יכולה לקבל את הערך \"אמת\" או \"שקר\".<br>\n",
     "    השער הלוגי יבצע פעולה לוגית בהתאם לכניסות שלו, ויחזיר ערך חדש – שגם הוא אמת או שקר.\n",
     "</p>"
    ]
@@ -39,9 +39,9 @@
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    שער לוגי שוודאי יצא לכם לשמוע עליו הוא <dfn>AND</dfn>.<br>\n",
-    "    לשער הלוגי AND שתי כניסות. פלט השער יהיה <var>True</var> רק אם הקלט בשתי הכניסות הוא <var>True</var>.<br> \n",
+    "    לשער הלוגי AND שתי כניסות. פלט השער יהיה <var>True</var> רק אם הקלט בשתי הכניסות הוא <var>True</var>, אחרת – יהיה הפלט <var>False</var>.<br> \n",
     "    שער לוגי אחר שוודאי יצא לכם לשמוע עליו הוא <dfn>NOT</dfn>.<br>\n",
-    "    לשער הלוגי NOT כניסה אחת. פלט השער יהיה <var>True</var> אם הקלט בכניסה הוא <var>False</var>, או <var>False</var> אם הקלט בכניסה הוא <var>True</var>. \n",
+    "    לשער הלוגי NOT כניסה אחת. פלט השער יהיה <var>True</var> אם הקלט הוא <var>False</var>, או <var>False</var> אם הקלט הוא <var>True</var>. \n",
     "</p>"
    ]
   },
@@ -59,8 +59,8 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    חיבור של מספר שערים לוגיים אחד לשני יצור רכיב לוגי.<br>\n",
-    "    בדוגמה הבאה, לדוגמה, הקלטים (מלמעלה למטה) <var>True</var>, <var>False</var>, <var>False</var>, <var>True</var> יניבו <var>True</var>.\n",
+    "    חיבור של כמה שערים לוגיים אחד לשני ייצור רכיב לוגי.<br>\n",
+    "    בדוגמה הבאה, הקלטים (מלמעלה למטה) <var>True</var>, <var>False</var>, <var>False</var>, <var>True</var> יניבו <var>True</var>.\n",
     "</p>"
    ]
   },
@@ -119,7 +119,7 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    בונוס: ודאו גם שהקוד הבא עובד ומחזיר <var>False</var>:\n",
+    "    בונוס: ודאו גם שהקוד הבא עובד ומדפיס <var>True</var>:\n",
     "</p>"
    ]
   },
@@ -171,16 +171,16 @@
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    כתבו מחלקה המייצגת קובייה.<br>\n",
     "    לכל קובייה יש צבע, מספר פאות וערכים שמופיעים על הפאות.<br>\n",
-    "    הטלה של קובייה תבחר באופן אקראי ערך מאחת מפאות הקובייה ותחזיר אותה.\n",
+    "    הטלה של קובייה תבחר באופן אקראי ערך מאחת מפאות הקובייה ותחזיר אותו.\n",
     "</p>\n",
     "\n",
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    על כל פאה של \"קובייה מספרית\" מופיע מספר שערכו בין 1 למספר הפאות בקובייה. כל מספר יופיע פעם אחת בלבד על הקובייה.<br>\n",
-    "    ב\"קובייה לא מאוזנת\", ישנו גם ערך שנקרא \"סיכוי הטלה\", שמפרט עבור כל פאה מה הסיכוי שתצא בהטלה.\n",
+    "    ב\"קובייה לא מאוזנת\" ישנו גם ערך שנקרא \"סיכוי הטלה\", שמפרט עבור כל פאה מה הסיכוי שתצא בהטלה.\n",
     "</p>\n",
     "\n",
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    צבע הקובייה חייב להיות מורכב מאותיות בלבד, משקלה של הקובייה חייב להיות חיובי וכמות הפאות חייבת להיות תואמת למספר הערכים המופיעים על הפאות.<br>\n",
+    "    שם הצבע של הקובייה חייב להיות מורכב מאותיות בלבד, סיכויי ההטלה חייבים להיות חיוביים ומספר הפאות חייב להיות תואם למספר הערכים המופיעים על הפאות.<br>\n",
     "</p>\n"
    ]
   },
@@ -189,10 +189,10 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    במשחק \"Yamtzee\" יש שק גדול שמכיל המון \"קוביות אורך\", ושק גדול נוסף של קוביות לא מאוזנות בצבעים שונים שנקראות \"קוביית אות\".<br>\n",
+    "    במשחק \"Yamtzee\" יש שק גדול שמכיל המון \"קוביות אורך\", ושק גדול נוסף של קוביות לא מאוזנות בצבעים שונים שנקראות \"קוביות אות\".<br>\n",
     "    10% מהקוביות בכל שק הן אדומות, 25% הן ירוקות ו־65% הן כחולות.<br>\n",
     "    קוביית אורך היא קובייה מספרית עם 10 פאות. אם הקובייה מורה 1, זורקים אותה שוב עד שיוצא מספר אחר.<br>\n",
-    "    קוביית אות היא קובייה לא מאוזנת עם 26 פאות, כאשר בכל פאה אות מהא\"ב הלטיני. סיכוי ההטלה עבור כל אחד מהערכים הוא לפי <a href=\"https://en.wikipedia.org/wiki/Letter_frequency\">התדירות של האות</a>.<br>\n",
+    "    קוביית אות היא קובייה לא מאוזנת עם 26 פאות, כאשר בכל פאה אות מהא\"ב האנגלי. סיכוי ההטלה עבור כל אחד מהערכים הוא לפי <a href=\"https://en.wikipedia.org/wiki/Letter_frequency\">התדירות של האות</a>.<br>\n",
     "</p>"
    ]
   },
@@ -201,11 +201,11 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    בתחילת המשחק, המשתמש בוחר כמה משתתפים ייקחו חלק במשחק, ומה הניקוד שאליו צריך להגיע כדי שהמשחק יסתיים.<br>\n",
+    "    בתחילת המשחק, המשתמש בוחר את מספר המשתתפים במשחק, ומה הניקוד שאליו צריך להגיע כדי שהמשחק יסתיים.<br>\n",
     "</p>\n",
     "\n",
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    כל שחקן בתורו מטיל את קוביית האורך, ומטיל כמות קוביות אות הזהה למספר שיצא בקוביית האורך.<br>\n",
+    "    כל שחקן בתורו מטיל את קוביית האורך, ומטיל מספר קוביות אות הזהה למספר שהתקבל בקוביית האורך.<br>\n",
     "    לדוגמה, אם קוביית האורך שהטלתי מורה 3, עליי להטיל 3 קוביות אות.\n",
     "</p>"
    ]
@@ -215,9 +215,9 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    המשתתף צריך להשתמש בקוביות האות שיצאו לו כדי ליצור מילה תקנית בשפה האנגלית שאורכה 2 אותיות לפחות.<br>\n",
+    "    המשתתף צריך להשתמש בקוביות האות שיצאו לו כדי ליצור מילה תקנית בשפה האנגלית, שאורכה 2 אותיות לפחות.<br>\n",
     "    הוא יכול לסדר את הקוביות מחדש ולבחור שלא להשתמש בחלק מהן, אבל הוא לא יכול להשתמש באותה קוביית אות פעמיים.<br>\n",
-    "    למרות זאת, יכול לקרות מצב שיותר מקוביית אות אחת תציג את אותה אות.\n",
+    "    למרות זאת, יכול לקרות מצב שיותר מקוביית אות אחת תציג את אותה האות.\n",
     "</p>"
    ]
   },
@@ -226,9 +226,9 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    אם המשתמש הצליח, עבור כל אות שבה השתמש הוא זוכה ב־$\\lfloor{\\frac{12}{\\lceil{f}\\rceil^{\\frac{3}{4}}}}\\rfloor$ נקודות, כאשר f זו תדירות האות בא\"ב האנגלי מעוגלת כלפי מעלה.<br>\n",
-    "    במילים: 12 חלקי הביטוי הבא: הסיכוי שהאות תצא מעוגל כלפי מעלה, בחזקת 1.5 ואז להוציא מזה שורש. כל זה – מעוגל כלפי מטה.<br>\n",
-    "    לדוגמה, עבור המילה \"zone\" השחקן ינוקד 17 לפי החישוב הבא:\n",
+    "    אם המשתמש הצליח להרכיב מילה, עבור כל אות שבה השתמש הוא זוכה ב־$\\lfloor{\\frac{12}{\\lceil{f}\\rceil^{\\frac{3}{4}}}}\\rfloor$ נקודות, כאשר f זו תדירות האות בא\"ב האנגלי, מעוגלת כלפי מעלה.<br>\n",
+    "    במילים: 12 חלקי הביטוי הבא – הסיכוי שהאות תצא מעוגל כלפי מעלה, בחזקת 1.5 ואז להוציא מזה שורש. כל זה – מעוגל כלפי מטה.<br>\n",
+    "    לדוגמה, עבור המילה \"zone\" יזכה השחקן ב־17 נקודות לפי החישוב הזה:\n",
     "</p>"
    ]
   },
@@ -249,7 +249,7 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    קוביית אורך אדומה נותנת למשתתף שהטיל אותה עוד קוביית אות במתנה.<br>\n",
+    "    קוביית אורך אדומה מעניקה למשתתף שהטיל אותה עוד קוביית אות במתנה.<br>\n",
     "    קוביית אות אדומה מאפשרת למשתתף להשתמש באות שמופיעה על הקובייה כמה פעמים שירצה.<br>\n",
     "    קוביות ירוקות נותנות למשתתף את האפשרות לבחור אם להטילן מחדש.<br>\n",
     "</p>"
@@ -261,7 +261,7 @@
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    ממשו את Yamtzee.<br>\n",
-    "    השתמשו ב־<a href=\"https://raw.githubusercontent.com/dwyl/english-words/master/words.txt\">words.txt</a> כדי לוודא אם המילים שהכניס המשתמש תקינות.\n",
+    "    השתמשו ב־<a href=\"https://raw.githubusercontent.com/dwyl/english-words/master/words.txt\">words.txt</a> כדי לוודא שהמילים שהכניס המשתמש תקינות.\n",
     "</p>"
    ]
   }