Add notebook 2 about classes (week7)

Author: yammesicka

week7/1_Classes.ipynb

@@ -1743,6 +1743,12 @@
     "        פעולה שרצה עם יצירת מופע חדש מתוך מחלקה.<br>\n",
     "        לרוב משתמשים בפעולה זו כדי להזין במופע ערכים התחלתיים.\n",
     "    </dd>\n",
+    "    <dt>תכנות מונחה עצמים (Object Oriented Programming)</dt>\n",
+    "    <dd>\n",
+    "        פרדיגמת תכנות שמשתמשת במחלקות בקוד ככלי העיקרי להפשטה של העולם האמיתי.<br>\n",
+    "        בפרדיגמה זו נהוג ליצור מחלקות המייצגות תבניות של עצמים, ולאפיין את העצמים באמצעות תכונות ופעולות.<br>\n",
+    "        בעזרת המחלקות אפשר ליצור מופעים, שהם ייצוג של פריט בודד (עצם, אובייקט) שנוצר לפי תבנית המחלקה.\n",
+    "    </dd>\n",
     "</dl>"
    ]
   },
@@ -1835,9 +1841,11 @@
     "        return self.parts[-1]\n",
     "\n",
     "    def get_extension(self):\n",
-    "        full_name = self.get_basename()\n",
-    "        filename, _, extension = full_name.rpartition(\".\")\n",
-    "        return extension\n",
+    "        name = self.get_basename()\n",
+    "        i = name.rfind('.')\n",
+    "        if 0 < i < len(name) - 1:\n",
+    "            return name[i + 1:]\n",
+    "        return ''\n",
     "\n",
     "    def is_exists(self):\n",
     "        return os.path.exists(str(self))\n",

week7/2_Documentation.ipynb

@@ -146,7 +146,7 @@
     "        yield 2\n",
     "        number = number // 2\n",
     "          \n",
-    "    # n must be odd at this point (we've just factored 2 out).\n",
+    "    # `number` must be odd at this point (we've just factored 2 out).\n",
     "    # Skip even numbers.  Square root is good upper limit, check\n",
     "    # https://math.stackexchange.com/a/1039525 for more info.\n",
     "    divisor = 3\n",
@@ -158,7 +158,7 @@
     "        else:\n",
     "            divisor += 2\n",
     "              \n",
-    "    # If n is a prime, just print n.\n",
+    "    # If `number` is a prime, just print `number`.\n",
     "    # 1 is not a prime, 2 already taken care of.\n",
     "    if number > 2:\n",
     "        yield number\n",
@@ -358,7 +358,7 @@
     "    <li>קוד צריך להסביר את עצמו. אם הוספת הערות לקוד, סימן שהקוד לא מובן דיו, וזה מצב שיפגע במפתחי הקוד בעתיד.</li>\n",
     "    <li>הערות שמסבירות קוד יוצרות שכפול – ושכפול בקוד <a href=\"https://en.wikipedia.org/wiki/Don%27t_repeat_yourself\">זה רע</a>.</li>\n",
     "    <li>\n",
-    "        הערות מצריכות תחזוקה בפני עצמן – שינוי של קוד יצריך לרוב שינוי של ההערה שמתייחסת אליו..<br>\n",
+    "        הערות מצריכות תחזוקה בפני עצמן – שינוי של קוד יצריך לרוב שינוי של ההערה שמתייחסת אליו.<br>\n",
     "        רוב המפתחים שוכחים לתחזק את ההערות, ולעיתים נשארות הערות שלא תואמות את הקוד עצמו.<br>\n",
     "        הערה שאומרת דבר לא נכון על הקוד גרועה בהרבה מחוסר הערה.\n",
     "    </li>\n",
@@ -534,7 +534,7 @@
    "source": [
     "<ul style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
     "    <li>תיעוד של שורה אחת מיועד עבור מקרים ברורים במיוחד, כמו הפונקציה <var>add</var> שכתבנו.</li>\n",
-    "    <li>התיעוד יבוא בשורה אחת, צמוד למירכאות, ללא שורות ריקות לפניו או אחריו.</li>\n",
+    "    <li>התיעוד ייכתב בשורה אחת, צמוד למירכאות, ללא שורות ריקות לפניו או אחריו.</li>\n",
     "    <li>התיעוד ינוסח בצורת פקודה ולא כסיפור (\"החזר את התוצאה\" ולא \"הפונקציה מחזירה...\").<br>\n",
     "        כלל אצבע טוב הוא לשמור על הצורה \"עשה X, החזר Y\" <span div=\"ltr\">(באנגלית: Do X, Return Y)</span>.</li>\n",
     "    <li>תיעוד של שורה אחת לא יכלול את סוג הפרמטרים (a או b, במקרה שלנו). הוא יכול לכלול את הסוג של ערך ההחזרה.</li>\n",
@@ -760,10 +760,15 @@
     "        \"\"\"Return the extension of the filename.\n",
     "        \n",
     "        If there is no extension, return an empty string.\n",
+    "        This does not include the leading period.\n",
+    "        For example: 'txt'\n",
     "        \"\"\"\n",
-    "        full_name = self.get_basename()\n",
-    "        filename, _, extension = full_name.rpartition(\".\")\n",
-    "        return extension\n",
+    "        name = self.get_basename()\n",
+    "        i = name.rfind('.')\n",
+    "        if 0 < i < len(name) - 1:\n",
+    "            return name[i + 1:]\n",
+    "        return ''\n",
+    "\n",
     "\n",
     "    def is_exists(self):\n",
     "        \"\"\"Check if the path exists, return boolean value.\"\"\"\n",
@@ -788,12 +793,12 @@
     "        Should be used to easily print the details about the path.\n",
     "        \"\"\"\n",
     "        return f\"\"\"\n",
-    "            Some info about \"{path}\":\n",
-    "            Drive letter: {path.get_drive_letter()}\n",
-    "            Dirname: {path.get_dirname()}\n",
-    "            Last part of path: {path.get_basename()}\n",
-    "            File extension: {path.get_extension()}\n",
-    "            Is exists?: {path.is_exists()}\n",
+    "            Some info about \"{self}\":\n",
+    "            Drive letter: {self.get_drive_letter()}\n",
+    "            Dirname: {self.get_dirname()}\n",
+    "            Last part of path: {self.get_basename()}\n",
+    "            File extension: {self.get_extension()}\n",
+    "            Is exists?: {self.is_exists()}\n",
     "        \"\"\".strip()\n",
     "\n",
     "    def __str__(self):\n",
@@ -981,7 +986,7 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    מלל שנכתב ב־reStructuredText יראה כך עבור מי שכתב אותו:\n",
+    "    מלל שנכתב ב־reStructuredText ייראה כך עבור מי שכתב אותו:\n",
     "</p>"
    ]
   },
@@ -995,7 +1000,7 @@
     "\n",
     "* הדגשה, מלל מוטה וקו תחתון.\n",
     "* רשימות.\n",
-    "* סימון של קוד, כמו `print(\"Hello\")`.\n",
+    "* סימון של קוד, כמו `print(\"Hello World\")`.\n",
     "</pre>"
    ]
   },
@@ -1168,10 +1173,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import string\n",
-    "import random\n",
-    "\n",
-    "\n",
     "class PostOffice:\n",
     "    def __init__(self, usernames):\n",
     "        self.message_id = 0\n",
@@ -1266,10 +1267,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import string\n",
-    "import random\n",
-    "\n",
-    "\n",
     "class PostOffice:\n",
     "    \"\"\"A Post Office class. Allows users to message each other.\n",
     "    \n",
@@ -1292,8 +1289,8 @@
     "            sender (str): The message sender's username.\n",
     "            recipient (str): The message recipient's username.\n",
     "            message_body (str): The body of the message.\n",
-    "            urgency (str, optional): The urgency of the message.\n",
-    "                                     Urgent messages appear first.\n",
+    "            urgent (bool, optional): The urgency of the message.\n",
+    "                                    Urgent messages appear first.\n",
     "\n",
     "        Returns:\n",
     "            int: The message ID, auto incremented number.\n",
@@ -1307,8 +1304,8 @@
     "            inbox.\n",
     "\n",
     "            >>> po_box = PostOffice(['a', 'b'])\n",
-    "            >>> message_id = po_box.send('a', 'b', 'Hello!')\n",
-    "            >>> len(pobox['b'])\n",
+    "            >>> message_id = po_box.send_message('a', 'b', 'Hello!')\n",
+    "            >>> len(po_box.boxes['b'])\n",
     "            1\n",
     "            >>> message_id\n",
     "            1\n",
@@ -1391,10 +1388,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import string\n",
-    "import random\n",
-    "\n",
-    "\n",
     "class PostOffice:\n",
     "    \"\"\"A Post Office class. Allows users to message each other.\n",
     "    \n",
@@ -1426,7 +1419,7 @@
     "            The message recipient's username.\n",
     "        message_body : str\n",
     "            The body of the message.\n",
-    "        urgency : str, optional\n",
+    "        urgent : bool, optional\n",
     "            The urgency of the message.\n",
     "            Urgent messages appear first.\n",
     "\n",
@@ -1447,8 +1440,8 @@
     "        inbox.\n",
     "\n",
     "        >>> po_box = PostOffice(['a', 'b'])\n",
-    "        >>> message_id = po_box.send('a', 'b', 'Hello!')\n",
-    "        >>> len(pobox['b'])\n",
+    "        >>> message_id = po_box.send_message('a', 'b', 'Hello!')\n",
+    "        >>> len(po_box.boxes['b'])\n",
     "        1\n",
     "        >>> message_id\n",
     "        1\n",
@@ -1492,15 +1485,11 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import string\n",
-    "import random\n",
-    "\n",
-    "\n",
     "class PostOffice:\n",
     "    \"\"\"A Post Office class. Allows users to message each other.\n",
     "\n",
-    "    :param str message_id: Incremental id of the last message sent.\n",
-    "    :param str boxes: Users' inboxes.\n",
+    "    :param int message_id: Incremental id of the last message sent.\n",
+    "    :param dict boxes: Users' inboxes.\n",
     "\n",
     "    :ivar list usernames: Users for which we should create PO Boxes.\n",
     "    \"\"\"\n",
@@ -1699,7 +1688,7 @@
    "metadata": {},
    "source": [
     "<p style=\"text-align: right; direction: rtl; float: right; clear: both;\">\n",
-    "    אם בעקבות פעולת התקפה שחקן מסוים הגיע הגיע ל־0 חיים או פחות מכך, הוא נחשב למת ברובו.<br>\n",
+    "    אם בעקבות פעולת התקפה שחקן מסוים הגיע ל־0 חיים או פחות מכך, הוא נחשב למת ברובו.<br>\n",
     "    דאגו שהשחקן יעבור החייאה וצרפו את מי שהתקיף אותו לרשימת ה־<var>nemeses</var> של השחקן.\n",
     "</p>"
    ]