Merge pull request #167 from pryn-kb/main

x

Author: pryn-kb

_build/.doctrees/_to_be_deleted_later/notebooks.doctree

@@ -1240,6 +1240,7 @@
     "tags": []
    },
    "source": [
+    "(number-guessing-game)=\n",
     "### <i class=\"fa-solid fa-dice\"></i> Exercise 4: The number guessing game"
    ]
   },
@@ -1274,8 +1275,9 @@
     "\n",
     "**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."
+    "- 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."
    ]
   },
   {
@@ -1365,22 +1367,24 @@
     "# Generate a random secret number between 1 and 20\n",
     "secret_number = random.randint(1, 20)\n",
     "\n",
-    "# Initialize variables\n",
+    "# Keep track of the number of attempts\n",
     "attempts = 0\n",
-    "guessed_correctly = False\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",
-    "while not guessed_correctly:\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",
-    "    # Increment the attempts counter\n",
+    "\n",
+    "    # Increase the attempts counter\n",
     "    attempts = attempts + 1\n",
     "\n",
-    "    # Check if the guess is correct, too low, or too high\n",
+    "    # Compare the guess with the secret number\n",
     "    if user_guess == secret_number:\n",
-    "        guessed_correctly = True\n",
     "        print(\"Congratulations! You guessed the correct number in\", attempts, \"attempts.\")\n",
     "    elif user_guess < secret_number:\n",
     "        print(\"Too low. Try again.\")\n",
@@ -1446,7 +1450,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.5"
+   "version": "3.13.5"
   }
  },
  "nbformat": 4,

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

@@ -483,6 +483,73 @@
     "    print(\"You chose:\", choice)\n"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "8660edde-8b01-4da6-b775-62601df4f3e6",
+   "metadata": {},
+   "source": [
+    "___\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",
+    "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",
+    "- Use a `try/except` block around the line where the program converts input to an integer.\n",
+    "- If the user does not type a valid number, print an error message such as:\n",
+    "  `\"Invalid input. Please enter a number.\"`\n",
+    "- Make sure the game continues running until the secret number is guessed.\n",
+    "\n",
+    "---\n",
+    "\n",
+    "````{admonition} Solution\n",
+    ":class: dropdown\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",
+    "        # 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",
+    "    except Exception as e:\n",
+    "        # Handle invalid input\n",
+    "        print(\"Invalid input. Please enter a number.\")\n",
+    "```\n",
+    "**Explanation:**\n",
+    "- The line `user_guess = int(input(...))` can raise an exception if the user types something that is not a number.\n",
+    "- By placing this line inside a `try/except` block, we can catch the error and respond gracefully.\n",
+    "- 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",
+    "````"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "1bdd4b2d-411a-4992-9e81-f6b76921a722",

_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 0x10b943fb0&gt;
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;contextlib.ExitStack at 0x10ba208c0&gt;
 </pre></div>
 </div>
 </div>