Add the high score to the scoreboard and replace game_over with reset

Refs #17 Refs #18 Task: MIL-003#2 Task: MIL-003#3
2026-10-13 14:33:54 +08:00
parent 63090fce3d
commit 518133b688
2 changed files with 198 additions and 143 deletions
@@ -1,58 +1,61 @@
-"""! @file
-@brief The scoreboard: the text at the top of the screen that shows the score.
-
-The class follows the day-21 lecture on inheritance: `Scoreboard` is a `Turtle`
-that writes text. Like `food`, this module needs `turtle` when it is imported;
-the game imports it only when it starts, and the tests install a fake `turtle`
-module first.
-"""
-
-from turtle import Turtle
-
-from snake_game.constants import (
-    GAME_OVER_POSITION,
-    GAME_OVER_TEXT,
-    SCORE_LABEL,
-    SCOREBOARD_ALIGNMENT,
-    SCOREBOARD_COLOR,
-    SCOREBOARD_FONT,
-    SCOREBOARD_POSITION,
-)
-
-
-class Scoreboard(Turtle):
-    """! @brief Shows the score as text at the top centre of the screen."""
-
-    def __init__(self) -> None:
-        """! @brief Set the scoreboard up and write the score 0."""
-        super().__init__()
-        ## @brief The number of foods the snake has eaten in this game.
-        self.score = 0
-        self.color(SCOREBOARD_COLOR)
-        self.penup()
-        self.hideturtle()
-        self.goto(SCOREBOARD_POSITION)
-        self.update_scoreboard()
-
-    def update_scoreboard(self) -> None:
-        """! @brief Wipe the old text and write the label and the score."""
-        self.clear()
-        self.write(
-            f"{SCORE_LABEL}{self.score}",
-            align=SCOREBOARD_ALIGNMENT,
-            font=SCOREBOARD_FONT,
-        )
-
-    def increase_score(self) -> None:
-        """! @brief Add 1 to the score and write it."""
-        self.score += 1
-        self.update_scoreboard()
-
-    def game_over(self) -> None:
-        """! @brief Write the game-over text at the centre of the screen.
-
-        The score stays where it is: the old text is not wiped. Automatic drawing is
-        off in the game, so the screen must be updated after this call.
-        """
-        self.goto(GAME_OVER_POSITION)
-        self.write(GAME_OVER_TEXT, align=SCOREBOARD_ALIGNMENT, font=SCOREBOARD_FONT)
+"""! @file
+@brief The scoreboard: the text at the top of the screen that shows the score.
+
+The class follows the day-21 lecture on inheritance: `Scoreboard` is a `Turtle`
+that writes text. Like `food`, this module needs `turtle` when it is imported;
+the game imports it only when it starts, and the tests install a fake `turtle`
+module first.
+"""
+
+from turtle import Turtle
+
+from snake_game.constants import (
+    HIGH_SCORE_LABEL,
+    SCORE_LABEL,
+    SCOREBOARD_ALIGNMENT,
+    SCOREBOARD_COLOR,
+    SCOREBOARD_FONT,
+    SCOREBOARD_POSITION,
+)
+
+
+class Scoreboard(Turtle):
+    """! @brief Shows the score as text at the top centre of the screen."""
+
+    def __init__(self) -> None:
+        """! @brief Set the scoreboard up and write the score 0."""
+        super().__init__()
+        ## @brief The number of foods the snake has eaten since the last reset.
+        self.score = 0
+        ## @brief The largest score reached so far.
+        self.high_score = 0
+        self.color(SCOREBOARD_COLOR)
+        self.penup()
+        self.hideturtle()
+        self.goto(SCOREBOARD_POSITION)
+        self.update_scoreboard()
+
+    def update_scoreboard(self) -> None:
+        """! @brief Wipe the old text and write the score and the high score."""
+        self.clear()
+        self.write(
+            f"{SCORE_LABEL}{self.score} {HIGH_SCORE_LABEL}{self.high_score}",
+            align=SCOREBOARD_ALIGNMENT,
+            font=SCOREBOARD_FONT,
+        )
+
+    def increase_score(self) -> None:
+        """! @brief Add 1 to the score and write it."""
+        self.score += 1
+        self.update_scoreboard()
+
+    def reset(self) -> None:
+        """! @brief Keep the best score, start a new game and write the scoreboard.
+
+        When the score is higher than the high score, it becomes the new high
+        score. The score then goes back to 0.
+        """
+        if self.score > self.high_score:
+            self.high_score = self.score
+        self.score = 0
+        self.update_scoreboard()