Python: Add type annotations

31_Depth_Charge/python/depth_charge.py

@@ -85,7 +85,7 @@ def get_shot_input() -> Tuple[int, int, int]:
             print("Please enter whole numbers only")
 
 
-def play_game(search_area, num_charges):
+def play_game(search_area, num_charges) -> None:
     print("\nYou are the captain of the destroyer USS Computer.")
     print("An enemy sub has been causing you trouble. Your")
     print(f"mission is to destroy it. You have {num_charges} shots.")

38_Fur_Trader/python/furtrader.py

@@ -2,6 +2,7 @@
 
 import random  # for generating random numbers
 import sys  # for system function, like exit()
+from typing import List
 
 # global variables for storing player's status
 player_funds: float = 0  # no money
@@ -62,7 +63,7 @@ def get_fort_choice() -> int:
     return result
 
 
-def show_fort_comment(which_fort):
+def show_fort_comment(which_fort) -> None:
     """Print the description for the fort"""
     print()
     if which_fort == FORT_MONTREAL:
@@ -103,10 +104,10 @@ def get_yes_or_no() -> str:
     return result
 
 
-def get_furs_purchase():
+def get_furs_purchase() -> List[int]:
     """Prompt the player for how many of each fur type they want.
     Accept numeric inputs, re-prompting on incorrect input values"""
-    results = []
+    results: List[int] = []
 
     print("YOUR " + str(MAX_FURS) + " FURS ARE DISTRIBUTED AMONG THE FOLLOWING")
     print("KINDS OF PELTS: MINK, BEAVER, ERMINE AND FOX.")
@@ -123,7 +124,7 @@ def get_furs_purchase():
     return results
 
 
-def main():
+def main() -> None:
     print(" " * 31 + "FUR TRADER")
     print(" " * 15 + "CREATIVE COMPUTING  MORRISTOWN, NEW JERSEY")
     print(" " * 15 + "(Ported to Python Oct 2012 krt@krt.com.au)")
@@ -137,7 +138,7 @@ def main():
         if game_state == "starting":
             show_introduction()
 
-            player_funds = 600  # Initial player start money
+            player_funds: float = 600  # Initial player start money
             player_furs = [0, 0, 0, 0]  # Player fur inventory
 
             print("DO YOU WISH TO TRADE FURS?")

41_Guess/python/guess.py

@@ -26,13 +26,14 @@ From: Basic Computer Games (1978)
 
 from math import log
 from random import random
+from typing import Tuple
 
 
 def insert_whitespaces() -> None:
     print("\n\n\n\n\n")
 
 
-def limit_set():
+def limit_set() -> Tuple[int, int]:
     print("                   Guess")
     print("Creative Computing  Morristown, New Jersey")
     print("\n\n\n")

42_Gunner/python/gunner.py

@@ -71,7 +71,7 @@ def gunner() -> None:
                 return
 
 
-def main():
+def main() -> None:
     print(" " * 33 + "GUNNER")
     print(" " * 15 + "CREATIVE COMPUTING  MORRISTOWN, NEW JERSEY")
     print("\n\n\n")

45_Hello/python/hello.py

@@ -22,7 +22,7 @@ def get_yes_or_no() -> Tuple[bool, Optional[bool], str]:
         return False, None, msg
 
 
-def ask_enjoy_question(user_name):
+def ask_enjoy_question(user_name: str) -> None:
     print(f"HI THERE, {user_name}, ARE YOU ENJOYING YOURSELF HERE?")
 
     while True:
@@ -41,7 +41,7 @@ def ask_enjoy_question(user_name):
             print("PLEASE ANSWER 'YES' OR 'NO'.  DO YOU LIKE IT HERE?")
 
 
-def prompt_for_problems(user_name):
+def prompt_for_problems(user_name: str) -> str:
     print()
     print(f"SAY, {user_name}, I CAN SOLVE ALL KINDS OF PROBLEMS EXCEPT")
     print("THOSE DEALING WITH GREECE.  WHAT KIND OF PROBLEMS DO")

47_Hi-Lo/python/hilo.py

@@ -5,7 +5,7 @@ MAX_ATTEMPTS = 6
 QUESTION_PROMPT = "? "
 
 
-def main():
+def main() -> None:
     print("HI LO")
     print("CREATIVE COMPUTING  MORRISTOWN, NEW JERSEY\n\n\n")
     print("THIS IS THE GAME OF HI LO.\n")

50_Horserace/python/horserace.py

@@ -1,7 +1,7 @@
 import math
 import random
 import time
-from typing import List
+from typing import List, Tuple
 
 
 def basic_print(*zones, **kwargs) -> None:
@@ -81,7 +81,7 @@ def setup_players() -> List[str]:
     return player_names
 
 
-def setup_horses():
+def setup_horses() -> List[float]:
     """Generates random odds for each horse. Returns a list of
     odds, indexed by the order of the global HORSE_NAMES."""
 
@@ -102,14 +102,14 @@ def print_horse_odds(odds) -> None:
     basic_print("")
 
 
-def get_bets(player_names):
+def get_bets(player_names: List[str]) -> List[Tuple[int, float]]:
     """For each player, get the number of the horse to bet on,
     as well as the amount of money to bet"""
 
     basic_print("--------------------------------------------------")
     basic_print("PLACE YOUR BETS...HORSE # THEN AMOUNT")
 
-    bets = []
+    bets: List[Tuple[int, float]] = []
     for name in player_names:
         horse = basic_input(name, int)
         amount = None
@@ -125,7 +125,7 @@ def get_bets(player_names):
     return bets
 
 
-def get_distance(odd):
+def get_distance(odd: float) -> int:
     """Advances a horse during one step of the racing simulation.
     The amount travelled is random, but scaled by the odds of the horse"""
 
@@ -181,7 +181,7 @@ def print_race_state(total_distance, race_pos) -> None:
     basic_print("XXXXFINISHXXXX")
 
 
-def simulate_race(odds):
+def simulate_race(odds) -> List[int]:
     num_horses = len(HORSE_NAMES)
 
     # in spirit of the original implementation, using two arrays to

52_Kinema/python/kinema.py

@@ -20,7 +20,7 @@ g = 10
 EXPECTED_ACCURACY_PERCENT = 15
 
 
-def do_quiz():
+def do_quiz() -> None:
     print()
     print()
     num_questions_correct = 0

54_Letter/python/letter.py

@@ -23,7 +23,7 @@ def print_instructions() -> None:
     print("AS TO HOW CLOSE YOU'RE GETTING TO MY LETTER.")
 
 
-def play_game():
+def play_game() -> None:
     target_value = random.randint(ord("A"), ord("Z"))
     num_guesses = 0
     print()

55_Life/python/life.py

@@ -6,6 +6,7 @@ An implementation of John Conway's popular cellular automaton
 Ported by Dave LeCompte
 """
 
+from typing import Dict
 
 PAGE_WIDTH = 64
 
@@ -26,11 +27,11 @@ def print_header(title) -> None:
     print()
 
 
-def get_pattern():
+def get_pattern() -> Dict[int, str]:
     print("ENTER YOUR PATTERN:")
     c = 0
 
-    pattern = {}
+    pattern: Dict[int, str] = {}
     while True:
         line = input()
         if line == "DONE":
@@ -98,8 +99,8 @@ def main() -> None:
             print()
 
         for x in range(min_x, max_x + 1):
-            print
+            print()
-            line = [" "] * MAX_WIDTH
+            line_list = [" "] * MAX_WIDTH
             for y in range(min_y, max_y + 1):
                 if a[x][y] == 2:
                     a[x][y] = 0
@@ -109,15 +110,14 @@ def main() -> None:
                 elif a[x][y] != 1:
                     continue
 
-                # line 261
+                line_list[y] = "*"
-                line[y] = "*"
 
                 next_min_x = min(x, next_min_x)
                 next_max_x = max(x, next_max_x)
                 next_min_y = min(y, next_min_y)
                 next_max_y = max(y, next_max_y)
 
-            print("".join(line))
+            print("".join(line_list))
 
         # line 295
         for _ in range(max_x + 1, MAX_HEIGHT):

57_Literature_Quiz/python/litquiz.py

@@ -19,7 +19,7 @@ class Question:
         self.incorrect_message = incorrect_message
         self.correct_message = correct_message
 
-    def ask(self):
+    def ask(self) -> bool:
         print(self.question)
 
         options = [f"{i+1}){self.answer_list[i]}" for i in range(len(self.answer_list))]

60_Mastermind/python/mastermind.py

@@ -204,7 +204,7 @@ def print_board(guesses) -> None:
 #    "We did try a version that kept an actual list of all possible combinations
 #    (as a string array), which was significantly faster than this versionn but
 #    which ate tremendous amounts of memory."
-def get_possibility(possibility):
+def get_possibility(possibility) -> List[int]:
     # print(possibility)
     if possibility[0] > -1:  # 3530
         current_position = 0  # Python arrays are zero-indexed

64_Nicomachus/python/nicomachus.py

@@ -15,7 +15,7 @@ Ported by Dave LeCompte
 import time
 
 
-def get_yes_or_no():
+def get_yes_or_no() -> bool:
     while True:
         response = input().upper()
         if response == "YES":
@@ -25,7 +25,7 @@ def get_yes_or_no():
         print(f"EH?  I DON'T UNDERSTAND '{response}'  TRY 'YES' OR 'NO'.")
 
 
-def play_game():
+def play_game() -> None:
     print("PLEASE THINK OF A NUMBER BETWEEN 1 AND 100.")
     print("YOUR NUMBER DIVIDED BY 3 HAS A REMAINDER OF")
     a = int(input())

65_Nim/python/Traditional_NIM.py

@@ -1,12 +1,12 @@
 import random
+from typing import Tuple
 
 
-# Class of the Game
 class NIM:
-    def __init__(self):
+    def __init__(self) -> None:
         self.piles = {1: 7, 2: 5, 3: 3, 4: 1}
 
-    def remove_pegs(self, command):
+    def remove_pegs(self, command) -> None:
         try:
 
             pile, num = command.split(",")
@@ -29,7 +29,7 @@ class NIM:
         else:
             print("\nInvalid value of either Peg or Pile\n")
 
-    def get_ai_move(self):
+    def get_ai_move(self) -> Tuple[int, int]:
         possible_pile = []
         for k, v in self.piles.items():
             if v != 0:
@@ -48,7 +48,7 @@ class NIM:
         for pile, peg in self.piles.items():
             print("Pile {} : {}".format(pile, "O " * peg))
 
-    def help(self):
+    def help(self) -> None:
         print("-" * 10)
         print('\nThe Game is player with a number of Piles of Objects("O" == one peg)')
         print("\nThe Piles are arranged as given below(Tradional NIM)\n")
@@ -62,7 +62,7 @@ class NIM:
         print("\nThe winner is defined as the one that picks the last remaning object")
         print("-" * 10)
 
-    def check_for_win(self):
+    def check_for_win(self) -> bool:
         sum = 0
         for v in self.piles.values():
             sum += v
@@ -96,13 +96,13 @@ def main() -> None:
             break
 
         # Computers Move
-        command = game.get_ai_move()
+        ai_command = game.get_ai_move()
         print(
             "\nA.I MOVE - A.I Removed {} pegs from Pile {}".format(
-                command[1], command[0]
+                ai_command[1], ai_command[0]
             )
         )
-        game.remove_pegs(str(command[0]) + "," + str(command[1]))
+        game.remove_pegs(str(ai_command[0]) + "," + str(ai_command[1]))
         end = game.check_for_win()
         if end:
             print("\nComputer Wins the Game, Better Luck Next Time\n")

66_Number/python/number.py

@@ -19,7 +19,7 @@ def print_instructions() -> None:
     print()
 
 
-def fnr():
+def fnr() -> int:
     return random.randint(1, 5)