Merge pull request steam-bell-92#1094 from knoxiboy/feat/issue-972-sqlite-support

feat: Add SQLite Support for Persistent High Scores in Games

Author: steam-bell-92

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

@@ -11,6 +11,10 @@ def main():
     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
@@ -206,6 +210,20 @@ def main():
         else:
             print("\n  🐭 The moles win this round...")
 
+        # 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("  No high scores yet!")
+        print("================================")
+
         while True:
             replay = input("\n  Play again? (y / n): ").strip().lower()
             if replay in ['y', 'yes', 'n', 'no']:

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 = [
@@ -102,6 +108,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