Merge pull request #1913 from srujana-16/Hangman

GSSOC'23 - Added python script to play hangman

Author: avinashkranjan

SCRIPTS.md

@@ -104,5 +104,5 @@
 | 102\.     | Scientific Calculator | This python program will help to solve the hardest problems of trigonometry, exponents functions, logarithmic functions, etc. in very easy way. This program has a best User interface of the scientific calculator and provide a best user experience | [Take Me](./Scientific_Calculator) | [Avdhesh Varshney](https://github.com/Avdhesh-Varshney)
 | 103\.     | Chess Game | Chess Game is created using PYTHON script that provides user a interactive platform to play chess game. This program will create a interactive GUI of chess board for the user. Directly started in the terminal. | [Take Me](./Chess-Game/) | [Avdhesh Varshney](https:github.com/Avdhesh-Varshney)
 | 104\.     | Audio splitting script  | This Python script allows you to split large audio files into smaller segments based on silence, making them suitable for transcription or further analysis. | [Take Me](https://github.com/avinashkranjan/Amazing-Python-Scripts/tree/master/Audio\Splitting) |  [Srujana Vanka](https://github.com/srujana-16) |
-
+| 105\.     | Hangman game script | The Hangman game is a classic word-guessing game where the player tries to guess a secret word within a certain number of attempts. | [Take Me](https://github.com/avinashkranjan/Amazing-Python-Scripts/tree/master/hangman) | [Srujana Vanka](https://github.com/srujana-16) 
 

hangman/Readme.md

@@ -0,0 +1,23 @@
+# Terminal-games - Hangman 
+## Description 
+
+This Hangman game is a simple implementation in Python where the player tries to guess a secret word by suggesting letters within a certain number of attempts. This is a classic word-guessing game that can be played in the terminal.
+
+## To compile and run
+
+- Clone the directory and `cd` into it.
+- To play Hangman:
+  - `cd` into the hangman folder and run `python3 hangman.py`
+  
+## How to play?
+1. The game will start by displaying a series of underscores representing each letter of the secret word. You need to guess the letters and try to complete the word before running out of attempts.
+
+2. Guess a letter by entering it through the terminal. If the letter is present in the word, it will be revealed in the appropriate position(s). If the letter is not in the word, you will lose one attempt.
+
+3. Keep guessing letters until you either guess the word correctly or run out of attempts. The game will let you know if you win or lose.
+
+4. After the game ends, you can choose to play again or exit the program.
+  
+## Built with - Python 3
+
+

hangman/__pycache__/hangman_visual.cpython-38.pyc

@@ -0,0 +1,58 @@
+import random
+from words import words
+from hangman_visual import lives_visual_dict
+import string
+
+
+def get_valid_word(words):
+    word = random.choice(words)                                                                                    # Randomly choose a word for the given list 
+    while '-' in word or ' ' in word:
+        word = random.choice(words)
+
+    return word.upper()                                                                                            # Return the word in uppercase
+
+
+def hangman():
+    word = get_valid_word(words)
+    word_letters = set(word)                                                                                       # Alphabets in the word
+    alphabet = set(string.ascii_uppercase)
+    used_letters = set()                                                                                           # Letters guessed by the user 
+
+    lives = 7
+
+    # Get user input
+    while len(word_letters) > 0 and lives > 0:
+        print('You have', lives, 'lives left, and you have used these letters: ', ' '.join(used_letters))          # Join the used letters from the list
+
+        # Display what current word is for each guess
+        word_list = [letter if letter in used_letters else '-' for letter in word]
+        print(lives_visual_dict[lives])
+        print('Current word: ', ' '.join(word_list))
+
+        user_letter = input('Guess a letter: ').upper()                                                            # Add the letter entered to the list 
+        if user_letter in alphabet - used_letters:
+            used_letters.add(user_letter)
+            if user_letter in word_letters:
+                word_letters.remove(user_letter)
+                print('')
+
+            else:
+                lives = lives - 1                                                                                 # Decrease number of lives by 1 
+                print('\nYour letter,', user_letter, 'is not in the word.')
+
+        elif user_letter in used_letters:
+            print('\nYou have already used this letter. Guess another letter.')
+
+        else:
+            print('\nInvalid letter. Enter a valid letter.')
+
+    # When number of lives is 0 or if the word is guessed 
+    if lives == 0:
+        print(lives_visual_dict[lives])
+        print('You died, sorry. The word was', word)
+    else:
+        print('YAY! You guessed the word correctly', word, '!!')
+
+
+if __name__ == '__main__':
+    hangman()

hangman/__pycache__/words.cpython-38.pyc

@@ -0,0 +1,59 @@
+# Hangman representation after every turn on the terminal 
+lives_visual_dict = {
+        0: """
+                ___________
+               | /        | 
+               |/        ( )
+               |          |
+               |         / \\
+               |
+           """,
+        1: """
+                ___________
+               | /        | 
+               |/        ( )
+               |          |
+               |         / 
+               |
+            """,
+        2: """
+                ___________
+               | /        | 
+               |/        ( )
+               |          |
+               |          
+               |
+            """,
+        3: """
+                ___________
+               | /        | 
+               |/        ( )
+               |          
+               |          
+               |
+            """,
+        4: """
+                ___________
+               | /        | 
+               |/        
+               |          
+               |          
+               |
+            """,
+        5: """
+                ___________
+               | /        
+               |/        
+               |          
+               |          
+               |
+            """,
+        6: """
+               |
+               |
+               |
+               |
+               |
+            """,
+        7: "",
+    }