Merge pull request #168 from pryn-kb/main

links + solutions

Author: pryn-kb

_build/.doctrees/_to_be_deleted_later/notebooks.doctree

@@ -1150,10 +1150,17 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 98,
+   "execution_count": 1,
    "id": "454db57f-1737-43a5-a778-5d692bdf891c",
    "metadata": {
     "editable": true,
+    "execution": {
+     "iopub.execute_input": "2025-10-03T18:32:18.665515Z",
+     "iopub.status.busy": "2025-10-03T18:32:18.664963Z",
+     "iopub.status.idle": "2025-10-03T18:32:21.045722Z",
+     "shell.execute_reply": "2025-10-03T18:32:21.044452Z",
+     "shell.execute_reply.started": "2025-10-03T18:32:18.665450Z"
+    },
     "slideshow": {
      "slide_type": ""
     },
@@ -1167,13 +1174,12 @@
      "name": "stdin",
      "output_type": "stream",
      "text": [
-      "Enter 'quit' to exit:  exit\n",
       "Enter 'quit' to exit:  quit\n"
      ]
     }
    ],
    "source": [
-    "user_input = \"\"\n",
+    "user_input = None\n",
     "while user_input != \"quit\":\n",
     "  user_input = input(\"Enter 'quit' to exit: \")"
    ]
@@ -1191,8 +1197,10 @@
    "source": [
     "```{admonition} Solution\n",
     ":class: dropdown\n",
-    "This loop continuously asks the user for input until they type “quit.”\n",
-    "It checks the value of user_input in each iteration.\n",
+    "Before the loop starts, `user_input` is set to `None` to indicate that it has no value yet.\\\n",
+    "(`None` is a special value in Python that represents “no value” or “nothing.”)\\\n",
+    "This loop continuously asks the user for input until they type “quit.”\\\n",
+    "It checks the value of `user_input` in each iteration.\n",
     "````"
    ]
   },
@@ -1276,8 +1284,7 @@
     "**Requirements:**\n",
     "\n",
     "- Use a `while` loop to repeatedly ask the user for their guess until they guess correctly.\n",
-    "- Use `if`, `elif`, and `else` statements to provide appropriate hints based on the user’s guess.\n",
-    "- You can assume that the user will only enter whole numbers (integers); other input does not need to be considered."
+    "- Use `if`, `elif`, and `else` statements to provide appropriate hints based on the user’s guess."
    ]
   },
   {
@@ -1291,11 +1298,11 @@
     "tags": []
    },
    "source": [
-    "````{hint}\n",
-    ":class: dropdown\n",
-    "You will need to use the `input()` function introduced in the exercise above.\n",
-    "We expect the users to only type in integers.\n",
-    "You can use the `random` module to generate the secret number. Here’s an example of how to import and use it:\n",
+    "````{admonition} Input & random generator\n",
+    ":class: hint\n",
+    "- You will need to use the `input()` function introduced in the exercise above.\n",
+    "- We expect the users to only type in integers.\n",
+    "- You can use the `random` module to generate the secret number. Here’s an example of how to import and use it:\n",
     "\n",
     "```\n",
     "import random\n",
@@ -1360,7 +1367,7 @@
    "source": [
     "````{admonition} Solution\n",
     ":class: dropdown\n",
-    "This problem can be solved in more than one way - however this is how we would recommend it done to provide clarity and to use the skills you have learned so far.\n",
+    "This problem can be solved in more than one way. However, this is how we would recommend it done to provide clarity and to use the skills you have learned so far.\n",
     "```\n",
     "import random\n",
     "\n",
@@ -1391,6 +1398,10 @@
     "    else:\n",
     "        print(\"Too high. Try again.\")\n",
     "```\n",
+    "\n",
+    "**Note:** At this stage, the game will crash if the user types something that is not an integer.\\\n",
+    "If you want to learn how to handle such cases gracefully, take a look at the chapter on [Error Handling](99_try_except).\n",
+    "\n",
     "`````"
    ]
   },

_build/.doctrees/docs/101/07_conditionals.doctree

@@ -491,8 +491,41 @@
     "___\n",
     "### <i class=\"fa-solid fa-pencil\"></i> Exercise 3: Fixing The number guessing game\n",
     "\n",
-    "In this exercise, you will update {ref}`The number guessing game <number-guessing-game>` so that it can handle invalid input.\\\n",
-    "At the moment, if the user types something that is not a whole number (integer), the program will crash.\\\n",
+    "In this exercise, you will update the solution {ref}`the number guessing game <number-guessing-game>` so that it can handle invalid input.\n",
+    "\n",
+    "```python\n",
+    "import random\n",
+    "\n",
+    "# Generate a random secret number between 1 and 20\n",
+    "secret_number = random.randint(1, 20)\n",
+    "\n",
+    "# Keep track of the number of attempts\n",
+    "attempts = 0\n",
+    "\n",
+    "# Initialise the variable to store the user's guess\n",
+    "user_guess = None  \n",
+    "\n",
+    "print(\"Welcome to the Number Guessing Game!\")\n",
+    "\n",
+    "# Continue looping until the correct number is guessed\n",
+    "while user_guess != secret_number:\n",
+    "    # Ask the user to guess the secret number\n",
+    "    user_guess = int(input(\"Guess the secret number (1-20): \"))\n",
+    "\n",
+    "    # Increase the attempts counter\n",
+    "    attempts = attempts + 1\n",
+    "\n",
+    "    # Compare the guess with the secret number\n",
+    "    if user_guess == secret_number:\n",
+    "        print(\"Congratulations! You guessed the correct number in\", attempts, \"attempts.\")\n",
+    "    elif user_guess < secret_number:\n",
+    "        print(\"Too low. Try again.\")\n",
+    "    else:\n",
+    "        print(\"Too high. Try again.\")\n",
+    "```\n",
+    "\n",
+    "At the moment, if the user types something that is not a whole number (integer), the program will crash.\n",
+    "\n",
     "Your task is to place the code that asks for a guess inside a `try/except` block. If the input is not an integer, the program should print a helpful message and allow the user to try again.\n",
     "\n",
     "**Requirements**\n",
@@ -547,6 +580,47 @@
     "- The `except Exception as e` block prints a helpful message and the program continues without crashing.\n",
     "\n",
     "This way, the game only accepts valid integers, but still lets the user try again if they make a mistake.\n",
+    "\n",
+    "An even cleaner solution would be to use a `try/except/else` structure.\\\n",
+    "In this way, the `try` block only contains the code that might fail, the `except` block handles the error, and the `else` block contains the normal program logic.\\\n",
+    "This separation can make the code easier to read and maintain.\n",
+    "\n",
+    "```python\n",
+    "import random\n",
+    "\n",
+    "# Generate a random secret number between 1 and 20\n",
+    "secret_number = random.randint(1, 20)\n",
+    "\n",
+    "# Keep track of the number of attempts\n",
+    "attempts = 0\n",
+    "\n",
+    "# Initialise the variable to store the user's guess\n",
+    "user_guess = None  \n",
+    "\n",
+    "print(\"Welcome to the Number Guessing Game!\")\n",
+    "\n",
+    "# Continue looping until the correct number is guessed\n",
+    "while user_guess != secret_number:\n",
+    "    try:\n",
+    "        # Ask the user to guess the secret number\n",
+    "        user_guess = int(input(\"Guess the secret number (1-20): \"))\n",
+    "    \n",
+    "    except Exception as e:\n",
+    "        # Handle invalid input\n",
+    "        print(\"Invalid input. Please enter a number.\")\n",
+    "    \n",
+    "    else:\n",
+    "        # Increase the attempts counter\n",
+    "        attempts = attempts + 1\n",
+    "\n",
+    "        # Compare the guess with the secret number\n",
+    "        if user_guess == secret_number:\n",
+    "            print(\"Congratulations! You guessed the correct number in\", attempts, \"attempts.\")\n",
+    "        elif user_guess < secret_number:\n",
+    "            print(\"Too low. Try again.\")\n",
+    "        else:\n",
+    "            print(\"Too high. Try again.\")\n",
+    "```\n",
     "````"
    ]
   },

_build/.doctrees/docs/101/99_sets_and_dictionaries.doctree

@@ -468,7 +468,7 @@ <h2>Code blocks and outputs<a class="headerlink" href="#code-blocks-and-outputs"
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;contextlib.ExitStack at 0x10ba208c0&gt;
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;contextlib.ExitStack at 0x10fbf1100&gt;
 </pre></div>
 </div>
 </div>