Add comments to solutions so far

2022/Day-02/day02-1.py

@@ -1,5 +1,6 @@
 #!/usr/bin/python3
 
+# Define points values for each move and outcome.
 points = {
     'rock': 1,
     'paper': 2,
@@ -9,6 +10,7 @@ points = {
     'win': 6 
 }
 
+# Map letters to moves.
 shapes = {
     'A': 'rock',
     'B': 'paper',
@@ -18,6 +20,7 @@ shapes = {
     'Z': 'scissors'
 }
 
+# Calculate whether we won or lost for a given pair of moves.
 def outcome(myMove, yourMove):
     wins = {
         'rock': 'scissors',
@@ -31,8 +34,8 @@ def outcome(myMove, yourMove):
     else:
         return 'lose'
 
+# For each set of moves in the input, work out our total score.
 totalScore = 0
-
 with open('input.txt', 'r') as inputFile:
     for line in inputFile:
         moves = line.strip().split(' ')
@@ -41,4 +44,5 @@ with open('input.txt', 'r') as inputFile:
         totalScore += points[ourMove]
         totalScore += points[outcome(ourMove, theirMove)]
 
+# Print the answer.
 print(totalScore)

2022/Day-02/day02-2.py

@@ -1,5 +1,6 @@
 #!/usr/bin/python3
 
+# Define points values for each move and outcome.
 points = {
     'rock': 1,
     'paper': 2,
@@ -9,27 +10,29 @@ points = {
     'win': 6 
 }
 
+# Map letters to moves.
 shapes = {
     'A': 'rock',
     'B': 'paper',
     'C': 'scissors',
 }
 
+# Define what move will win/lose for a given move.
 wins = {
     'rock': ['paper', 'scissors'],
     'paper': ['scissors', 'rock'],
     'scissors': ['rock', 'paper']
 }
 
-
+# Map letters to the outcome they represent.
 outcomes = {
     'X': 'lose',
     'Y': 'draw',
     'Z': 'win'
 }
 
+# For each line in the input, work out what move we require and what our score would be.
 totalScore = 0
-
 with open('input.txt', 'r') as inputFile:
     for line in inputFile:
         moves = line.strip().split(' ')
@@ -44,5 +47,5 @@ with open('input.txt', 'r') as inputFile:
         
         totalScore += (points[requiredOutcome] + points[requiredMove])
 
-
+# Print the answer.
 print(totalScore)