Merge pull request #1 from Infinitode/feat/add-hangman-game

feat: Add Hangman game project

Author: Infinitode

Beginner/13_hangman_game.py

@@ -0,0 +1,57 @@
+import random
+
+def play_hangman():
+    """Plays a game of Hangman with the user."""
+
+    words = ["python", "javascript", "coding", "developer", "computer", "science", "algorithm", "programming", "github"]
+    chosen_word = random.choice(words).lower()
+    guessed_letters = []
+    attempts = 6
+    word_display = ["_" for _ in chosen_word]
+
+    print("Welcome to Hangman!")
+
+    while attempts > 0 and "".join(word_display) != chosen_word:
+        print(f"\nWord: {' '.join(word_display)}")
+        print(f"Guessed letters: {', '.join(sorted(guessed_letters))}")
+        print(f"Attempts remaining: {attempts}")
+
+        guess = input("Guess a letter: ").lower()
+
+        # Validate input
+        if not guess.isalpha() or len(guess) != 1:
+            print("Invalid input. Please enter a single letter.")
+            continue
+
+        if guess in guessed_letters:
+            print(f"You've already guessed '{guess}'. Try another letter.")
+            continue
+
+        guessed_letters.append(guess)
+
+        if guess in chosen_word:
+            print(f"Good guess! '{guess}' is in the word.")
+            for i, letter in enumerate(chosen_word):
+                if letter == guess:
+                    word_display[i] = guess
+        else:
+            print(f"Sorry, '{guess}' is not in the word.")
+            attempts -= 1
+
+    # Game over
+    if "".join(word_display) == chosen_word:
+        print(f"\nCongratulations! You guessed the word: {chosen_word}")
+    else:
+        print(f"\nGame Over! You ran out of attempts. The word was: {chosen_word}")
+
+def main():
+    """Main function to run the Hangman game and allow replays."""
+    while True:
+        play_hangman()
+        play_again = input("Play again? (yes/no): ").lower()
+        if play_again != "yes":
+            print("Thanks for playing Hangman!")
+            break
+
+if __name__ == "__main__":
+    main()

README.md

@@ -430,6 +430,46 @@ These projects are ideal for those new to Python. Each project includes a descri
 > [!NOTE]
 > Working code solutions are in the `/Beginner` folder.
 
+### 13. Hangman Game
+- **Description**: Implement the classic Hangman game where the player guesses letters to reveal a hidden word.
+- **Solution**: https://github.com/Infinitode/Python-Projects/blob/main/Beginner/13_hangman_game.py
+- **Steps**:
+  1. Create a list of words for the game.
+  2. Randomly select a word.
+  3. Display the word with blanks for hidden letters.
+  4. Allow the user to guess letters.
+  5. Keep track of guessed letters and remaining attempts.
+  6. Reveal letters in the word as they are guessed correctly.
+  7. End the game when the word is guessed or attempts run out.
+- **Tips:**
+
+    </summary>
+    <details><summary>Tip 1:</summary>
+
+    Use `random.choice()` to select a random word from a list.
+
+    </details>
+    <details><summary>Tip 2:</summary>
+
+    Use a `while` loop for the main game interactions.
+
+    </details>
+    <details><summary>Tip 3:</summary>
+
+    Store guessed letters in a list to avoid repeat guesses and display them to the user.
+
+    </details>
+    <details><summary>Tip 4:</summary>
+
+    Represent the hidden word as a list of characters or underscores, updating it as letters are guessed.
+
+    </details>
+    <details><summary>Tip 5:</summary>
+
+    Keep a counter for incorrect guesses (attempts remaining).
+
+    </details>
+
 ## Intermediate Projects
 These projects are ideal for those with experience in Python. Each project includes a description, steps to follow, and tips for completing it.