Merge pull request larymak#59 from Mannuel25/main

Addition of Number Guessing Game

Author: larymak

Number Guessing Game/README.md

@@ -0,0 +1,22 @@
+# Number Guessing Game
+
+This is a game that allows you guess a number between the range of 1- 10 in just 7 trials.
+
+# Prerequisites
+
+It requires no prerequisites, you only need to run the script. If you don't have Python installed, you can visit [here](https://www.python.org/downloads/) to download Python
+
+# How to run the script
+
+Running the script is pretty easy, open a terminal in the folder where your script is located and run the following command :
+
+`python numberGuessingGame.py`
+
+# Sample use of the script
+
+![alt text](https://github.com/Mannuel25/Python-project-Scripts/blob/main/Number%20Guessing%20Game/script_screenshot.png)
+
+
+# Author's name
+
+[Emmanuel Tanimowo](https://github.com/Mannuel25)

Number Guessing Game/numberGuessingGame.py

@@ -0,0 +1,82 @@
+import random
+# random module is a built-in module to generate pseudo-random variables
+
+def display_gameplay():
+    """
+    Displays the gameplay
+    : return: None
+    """
+    print('\nWelcome to Number Guessing Game!')
+    print('In this game you\'ve just 7 trials to guess a number between the range of 1-10')
+    print('Note: enter \'exit\' to end game')
+
+def startGame():
+    """
+    Gets user response to start or end the game
+    : return: str
+    """
+    # call the function to display gameplay
+    displayGameplay = display_gameplay()
+    # make a list of the possible inputs
+    # to start or end the game
+    POSSIBLE_RESPONSES = ['Y','YES','N','NO','EXIT']
+    # get user's response
+    user_response = input('\nStart game? (yes/no): ').strip().upper()
+    while user_response not in POSSIBLE_RESPONSES:
+        print('\nInvalid Input!')
+        user_response = input('\nStart game? (yes/no): ').strip().upper()
+    else: return user_response
+
+def game():
+    """
+    Controls the game
+    : return: None
+    """
+    # call the function to get user's response
+    play_game = startGame()
+    # assign the number of trials the user has to a variable
+    number_of_trials = 7
+    while play_game == 'YES' or play_game == 'Y':
+        # make a list that contains all the
+        # numbers a user can guess
+        ACCEPTED_NUMBER_PICKS = [str(i) for i in range(1,11)]
+        # get user's number
+        user_input = input('\nGuess a number between the range of 1-10: ').strip().upper()
+        while user_input not in ACCEPTED_NUMBER_PICKS and user_input != 'EXIT' :
+            print('Invalid Input!')
+            user_input = input('\nGuess a valid number between the range of 1-10: ').strip().upper()
+        if user_input == 'EXIT':
+            print('Bye Player!')
+            break
+        else:
+            # generate a random number in the range 1-10
+            # and assign it to a variable
+            computer_number = random.randint(1,10)
+            user_input = int(user_input)
+            if user_input < computer_number:
+                number_of_trials -= 1
+                print(f'Oops, {user_input} is too low')
+                if number_of_trials != 0:
+                    print(f'You\'ve {number_of_trials} trial(s) left')
+                    play_game = input('\nGuess again? (yes/no): ').strip().upper()
+                else:
+                    print(F'\nGame over!, you\'ve 0 trial left..try harder next time 😉')
+                    break
+            elif user_input > computer_number:
+                number_of_trials -= 1
+                print(f'Oops, {user_input} is too high')
+                if number_of_trials != 0:
+                    print(f'You\'ve {number_of_trials} trial(s) left')
+                    play_game = input('\nGuess again? (yes/no): ').strip().upper()
+                else:
+                    print(F'\nGame over!, you\'ve 0 trial left..try harder next time 😉')
+                    break
+            elif user_input == computer_number:
+                number_of_trials -= 1
+                print(f'Congratulations!!..you guessed right, after {7 - number_of_trials} trial(s)')
+                play_game = input('\nDo you wish to play again? (yes/no): ').strip().upper()
+                # if the user wishes to play again, assign
+                # the number of trials the user has to a variable
+                number_of_trials = 7 
+
+game()

Number Guessing Game/script_screenshot.png

@@ -78,3 +78,4 @@ The contribution guidelines are as per the guide [HERE](https://github.com/larym
 | 35    | [Image to ASCII](https://github.com/larymak/Python-project-Scripts/tree/main/image-ascii)                                              | [Lary Mak](https://github.com/larymak)                  |
 | 36    | [Password Validator](https://github.com/larymak/Python-project-Scripts/tree/main/password-validator)                                   | [Emmanuel Tanimowo](https://github.com/Mannuel25)       |
 | 37    | [Text to Audio](https://github.com/larymak/Python-project-Scripts/tree/main/texttoaudio)                                               | [Azmine Toushik](https://github.com/azminewasi)         |
+| 38    | [Number Guessing Game](https://github.com/Mannuel25/Python-project-Scripts/tree/main/Number%20Guessing%20Game)                                               | [Emmanuel Tanimowo](https://github.com/Mannuel25)         |