feat(highscore): add comments and json file

src/highscore.py

@@ -13,14 +13,33 @@ class Highscore:
             self.save_scores([])
 
     def load_scores(self):
+        """
+        Will load the highscore json file.
+        :return: All scores form json file.
+        """
         with open(self.path, "r") as f:
             return json.load(f)
 
     def save_scores(self, scores):
+        """
+        Write score data into json file. File will be overwritten.
+        :param scores: Scores to store in json highscore file.
+        :return: None.
+        """
+        # save scores to file
         with open(self.path, "w") as file:
             json.dump(scores, file, indent=4)
 
     def add_score(self, player_name, score_ects, time_survived, won):
+        """
+        Add a new score to the list of existing scores from highscore file. The
+        number of entries is limited to 50.
+        :param player_name: Name of the player.
+        :param score_ects: Scored ECTS in game.
+        :param time_survived: Time survived in game.
+        :param won: Game won/lose.
+        :return: None.
+        """
         # load existing scores from file
         scores = self.load_scores()
 
@@ -42,11 +61,19 @@ class Highscore:
         self.save_scores(scores)
 
     def get_top_scores(self):
+        """
+        Get top 5 scores from highscore file.
+        :return: Return top 5 scores as list.
+        """
         scores = self.load_scores()
         scores.sort(key=lambda score: score["ects"], reverse=True)
         return scores[:5]
 
     def get_top_scores_formatted(self):
+        """
+        Get top 5 scores from highscore file in nice format.
+        :return: Return top 5 scores as formatted string in list.
+        """
         top_scores = self.get_top_scores()
         formatted_scores = []