Add tkinter Binary Search GUI Game

mini_number_game/README.md

@@ -0,0 +1,33 @@
+# Binary Search Guessing Game (GUI)
+
+This is a small desktop application built with Python's built-in `tkinter` module. It's a game designed to help users practice the logic of a binary search.
+
+## Description
+
+The game generates a secret random number between 1 and 100. The user then has a limited number of 7 guesses to find the number. After each guess, the app will provide a hint:
+* **"Too LOW"**
+* **"Too HIGH"**
+
+The user must use these hints to "zero in" on the correct number, just like a binary search algorithm. 7 guesses is the mathematical minimum required to find any number between 1-100 (since $2^7 = 128$).
+
+## Features
+
+* Full graphical user interface (GUI).
+* Random number generation for endless replayability.
+* "Too HIGH" / "Too LOW" hints to guide the user.
+* Tracks the number of guesses remaining.
+* "Reset" button to start a new game at any time.
+
+## How to Run
+
+1.  Ensure you have Python 3 installed (which includes `tkinter`).
+2.  Run the script from your terminal:
+    ```sh
+    python binary_search_game.py
+    ```
+3.  A GUI window will pop up to play the game.
+
+## Modules Used
+
+* **`tkinter`**: (Python's built-in GUI library)
+* **`random`**: (Built-in module for generating the secret number)

mini_number_game/binary_search_game.py

@@ -0,0 +1,98 @@
+import tkinter as tk
+import random
+
+# --- Main Application Class ---
+class BinarySearchGame:
+    def __init__(self, root):
+        """Initializes the main GUI window and all its widgets."""
+        self.root = root
+        self.root.title("Binary Search Game")
+        self.root.geometry("350x250") # Set window size
+
+        # --- Create and Pack GUI Widgets ---
+
+        # 1. Instruction Label: Tells the user the rules
+        self.instruction_label = tk.Label(
+            root, 
+            text="I'm thinking of a number between 1 and 100.\n"
+                 "You have 7 guesses to find it (using binary search!)",
+            font=("Arial", 10),
+            pady=10
+        )
+        self.instruction_label.pack()
+
+        # 2. Guesses Remaining Label: Shows remaining attempts
+        self.guess_label = tk.Label(root, text="Guesses remaining: 7", font=("Arial", 12, "bold"))
+        self.guess_label.pack()
+
+        # 3. Hint/Feedback Label: Gives "too high/low" hints
+        self.hint_label = tk.Label(root, text="Make your first guess.", font=("Arial", 10, "italic"), fg="blue")
+        self.hint_label.pack()
+
+        # 4. User Input Entry Box
+        self.entry = tk.Entry(root, width=10, font=("Arial", 14))
+        self.entry.pack(pady=10)
+        self.entry.focus_set() # Start with the cursor in the entry box
+
+        # 5. Guess Button: Calls the check_guess function
+        self.guess_button = tk.Button(root, text="Guess", command=self.check_guess)
+        self.guess_button.pack()
+
+        # 6. Reset Button: Calls the reset_game function
+        self.reset_button = tk.Button(root, text="Reset", command=self.reset_game)
+        self.reset_button.pack(pady=5)
+
+        # Start the first game
+        self.reset_game()
+
+    def reset_game(self):
+        """Resets the game to a new, fresh state."""
+        # Pick a new secret number
+        self.secret_number = random.randint(1, 100)
+        self.guesses_left = 7 # Max guesses for binary search on 1-100 is 7 (2^7 > 100)
+
+        # Reset all labels and buttons to their starting state
+        self.hint_label.config(text="New game started. Make your guess.", fg="blue")
+        self.guess_label.config(text=f"Guesses remaining: {self.guesses_left}")
+        self.entry.delete(0, tk.END) # Clear the entry box
+        self.guess_button.config(state=tk.NORMAL) # Re-enable the guess button
+        self.entry.config(state=tk.NORMAL) # Re-enable the entry box
+
+    def check_guess(self):
+        """Runs every time the user clicks the 'Guess' button."""
+        try:
+            # Get the guess from the entry box and convert to an integer
+            guess = int(self.entry.get())
+        except ValueError:
+            # Handle bad input (e.g., "abc")
+            self.hint_label.config(text="That's not a number! Try again.", fg="red")
+            return # Stop the function here
+
+        # A valid guess was made
+        self.guesses_left -= 1
+        self.guess_label.config(text=f"Guesses remaining: {self.guesses_left}")
+        self.entry.delete(0, tk.END) # Clear the box for the next guess
+
+        # --- Check Win/Loss/Hint Conditions ---
+        if guess == self.secret_number:
+            # --- WIN ---
+            self.hint_label.config(text=f"You got it! The number was {self.secret_number}!", fg="green")
+            self.guess_button.config(state=tk.DISABLED) # Disable button
+            self.entry.config(state=tk.DISABLED) # Disable entry
+        elif self.guesses_left == 0:
+            # --- LOSE ---
+            self.hint_label.config(text=f"You lost! The number was {self.secret_number}.", fg="red")
+            self.guess_button.config(state=tk.DISABLED)
+            self.entry.config(state=tk.DISABLED)
+        elif guess < self.secret_number:
+            # --- HINT: TOO LOW ---
+            self.hint_label.config(text=f"Your guess {guess} is too LOW.", fg="orange")
+        elif guess > self.secret_number:
+            # --- HINT: TOO HIGH ---
+            self.hint_label.config(text=f"Your guess {guess} is too HIGH.", fg="orange")
+
+# --- Main execution: Runs the program ---
+if __name__ == "__main__":
+    main_root = tk.Tk()           # Create the main window
+    app = BinarySearchGame(main_root) # Create our game app instance
+    main_root.mainloop()          # Start the GUI event loop