feat: add SQLite support for persistent high scores in terminal games closes 972

Author: knoxiboy

games/Whack-a-Mole/Whack-a-Mole.py

@@ -8,6 +8,10 @@
 import os
 import sys
 
+# Add root directory to sys.path to import utils package
+sys.path.append(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
+from utils import save_score, get_top_scores
+
 # Windows only for non-blocking input
 try:
     import msvcrt
@@ -194,14 +198,19 @@
         avg_rt = sum(reaction_times) / len(reaction_times)
         print(f"  ⚡ Avg Reaction: {avg_rt:.2f}s")
 
-    if accuracy >= 90:
-        print("\n  🌟 Legendary reflexes!")
-    elif accuracy >= 70:
-        print("\n  👏 Great job!")
-    elif accuracy >= 50:
-        print("\n  😅 Not bad — keep practising!")
+    # Save and display high scores
+    name = input("\n  Enter your name for the high scores board: ").strip()
+    if name:
+        save_score("Whack-a-Mole", name, score)
+    
+    print("\n🏆 ===== HIGH SCORES BOARD =====")
+    top_scores = get_top_scores("Whack-a-Mole", 5)
+    if top_scores:
+        for idx, (p_name, p_score, p_time) in enumerate(top_scores):
+            print(f"  {idx+1}. {p_name:15s} : {p_score:4d}  ({p_time})")
     else:
-        print("\n  🐭 The moles win this round...")
+        print("  No high scores yet!")
+    print("================================")
 
     while True:
         replay = input("\n  Play again? (y / n): ").strip().lower()

utilities/Typing-Speed-Tester/Typing-Speed-Tester.py

@@ -2,6 +2,12 @@
 import random
 import urllib.request
 import json
+import sys
+import os
+
+# Add root directory to sys.path to import utils package
+sys.path.append(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
+from utils import save_score, get_top_scores
 
 # Local fallback sentences
 fallback_sentences = [
@@ -97,6 +103,20 @@
         print("👍 Good Attempt!")
     else:
         print("💡 Keep Practicing!")
+
+    # Save and display high scores
+    name = input("\n  Enter your name for the high scores board: ").strip()
+    if name:
+        save_score("Typing-Speed-Tester", name, int(wpm))
+    
+    print("\n🏆 ===== HIGH SCORES BOARD =====")
+    top_scores = get_top_scores("Typing-Speed-Tester", 5)
+    if top_scores:
+        for idx, (p_name, p_score, p_time) in enumerate(top_scores):
+            print(f"  {idx+1}. {p_name:15s} : {p_score:4d} WPM  ({p_time})")
+    else:
+        print("  No high scores yet!")
+    print("================================")
 
     again = input("\n🔄 Do you want to test again? (y/n): ").strip().lower()
     if again != 'y':

utils/__init__.py

@@ -1 +1,2 @@
 # Central utilities package
+from utils.db_manager import save_score, get_top_scores

utils/db_manager.py

@@ -0,0 +1,57 @@
+import os
+import sqlite3
+from datetime import datetime
+
+# Resolve database path to root directory
+BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+DB_PATH = os.path.join(BASE_DIR, "data.db")
+
+def get_connection():
+    """Returns a connection to the SQLite database."""
+    conn = sqlite3.connect(DB_PATH)
+    return conn
+
+def init_db():
+    """Initializes the database and creates high_scores table if it doesn't exist."""
+    conn = get_connection()
+    cursor = conn.cursor()
+    cursor.execute("""
+        CREATE TABLE IF NOT EXISTS high_scores (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            game_name TEXT NOT NULL,
+            player_name TEXT NOT NULL,
+            score INTEGER NOT NULL,
+            timestamp TEXT NOT NULL
+        )
+    """)
+    conn.commit()
+    conn.close()
+
+def save_score(game_name: str, player_name: str, score: int):
+    """Saves a player's score to the database."""
+    init_db()
+    conn = get_connection()
+    cursor = conn.cursor()
+    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    cursor.execute("""
+        INSERT INTO high_scores (game_name, player_name, score, timestamp)
+        VALUES (?, ?, ?, ?)
+    """, (game_name, player_name.strip(), score, timestamp))
+    conn.commit()
+    conn.close()
+
+def get_top_scores(game_name: str, limit: int = 5):
+    """Retrieves top scores for a specific game."""
+    init_db()
+    conn = get_connection()
+    cursor = conn.cursor()
+    cursor.execute("""
+        SELECT player_name, score, timestamp
+        FROM high_scores
+        WHERE game_name = ?
+        ORDER BY score DESC, timestamp ASC
+        LIMIT ?
+    """, (game_name, limit))
+    results = cursor.fetchall()
+    conn.close()
+    return results