-
-
-
+
+
+
+
Daily challenge
+
Sudoku Game
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/starter/tests/__pycache__/test_app.cpython-314-pytest-9.1.1.pyc b/starter/tests/__pycache__/test_app.cpython-314-pytest-9.1.1.pyc
new file mode 100644
index 000000000..2930d3d8d
Binary files /dev/null and b/starter/tests/__pycache__/test_app.cpython-314-pytest-9.1.1.pyc differ
diff --git a/starter/tests/__pycache__/test_sudoku_logic.cpython-314-pytest-9.1.1.pyc b/starter/tests/__pycache__/test_sudoku_logic.cpython-314-pytest-9.1.1.pyc
new file mode 100644
index 000000000..8253b3e98
Binary files /dev/null and b/starter/tests/__pycache__/test_sudoku_logic.cpython-314-pytest-9.1.1.pyc differ
diff --git a/starter/tests/__pycache__/test_timer_ui.cpython-314-pytest-9.1.1.pyc b/starter/tests/__pycache__/test_timer_ui.cpython-314-pytest-9.1.1.pyc
new file mode 100644
index 000000000..d6e056f7d
Binary files /dev/null and b/starter/tests/__pycache__/test_timer_ui.cpython-314-pytest-9.1.1.pyc differ
diff --git a/starter/tests/test_app.py b/starter/tests/test_app.py
new file mode 100644
index 000000000..3d29fae55
--- /dev/null
+++ b/starter/tests/test_app.py
@@ -0,0 +1,72 @@
+import pytest
+import app as sudoku_app
+import sudoku_logic
+
+
+@pytest.fixture(autouse=True)
+def reset_current():
+ sudoku_app.CURRENT["puzzle"] = None
+ sudoku_app.CURRENT["solution"] = None
+ yield
+ sudoku_app.CURRENT["puzzle"] = None
+ sudoku_app.CURRENT["solution"] = None
+
+
+def test_new_game_endpoint_returns_puzzle():
+ client = sudoku_app.app.test_client()
+
+ response = client.get("/new?difficulty=medium")
+
+ assert response.status_code == 200
+ data = response.get_json()
+ assert isinstance(data["puzzle"], list)
+ assert len(data["puzzle"]) == sudoku_logic.SIZE
+ assert all(len(row) == sudoku_logic.SIZE for row in data["puzzle"])
+ assert data["difficulty"] == "medium"
+
+
+def test_check_solution_requires_active_game():
+ client = sudoku_app.app.test_client()
+
+ response = client.post("/check", json={"board": [[1] * sudoku_logic.SIZE for _ in range(sudoku_logic.SIZE)]})
+
+ assert response.status_code == 400
+ assert response.get_json()["error"] == "No game in progress"
+
+
+def test_check_solution_accepts_correct_board():
+ client = sudoku_app.app.test_client()
+ client.get("/new?difficulty=hard")
+
+ response = client.post("/check", json={"board": sudoku_app.CURRENT["solution"]})
+
+ assert response.status_code == 200
+ assert response.get_json()["incorrect"] == []
+
+
+def test_hint_updates_current_board_and_locks_cell():
+ client = sudoku_app.app.test_client()
+ client.get("/new?difficulty=hard")
+
+ response = client.post("/hint", json={"board": sudoku_app.CURRENT["puzzle"]})
+
+ assert response.status_code == 200
+ data = response.get_json()
+ assert data["row"] in range(sudoku_logic.SIZE)
+ assert data["col"] in range(sudoku_logic.SIZE)
+ assert data["value"] == sudoku_app.CURRENT["solution"][data["row"]][data["col"]]
+ assert sudoku_app.CURRENT["puzzle"][data["row"]][data["col"]] == data["value"]
+
+
+def test_hint_fills_one_empty_cell_and_updates_current_board():
+ client = sudoku_app.app.test_client()
+ client.get("/new?difficulty=medium")
+
+ response = client.post("/hint", json={"board": sudoku_app.CURRENT["puzzle"]})
+
+ assert response.status_code == 200
+ data = response.get_json()
+ assert set(data.keys()) == {"row", "col", "value"}
+ assert sudoku_app.CURRENT["puzzle"][data["row"]][data["col"]] == data["value"]
+ assert sudoku_app.CURRENT["solution"][data["row"]][data["col"]] == data["value"]
+ assert sudoku_app.CURRENT["puzzle"][data["row"]][data["col"]] != 0
diff --git a/starter/tests/test_sudoku_logic.py b/starter/tests/test_sudoku_logic.py
new file mode 100644
index 000000000..e78e7b9cc
--- /dev/null
+++ b/starter/tests/test_sudoku_logic.py
@@ -0,0 +1,38 @@
+import sudoku_logic
+
+
+def test_generate_puzzle_returns_valid_board():
+ puzzle, solution = sudoku_logic.generate_puzzle(difficulty="medium")
+
+ assert len(puzzle) == sudoku_logic.SIZE
+ assert len(solution) == sudoku_logic.SIZE
+ assert all(len(row) == sudoku_logic.SIZE for row in puzzle)
+ assert all(len(row) == sudoku_logic.SIZE for row in solution)
+
+ for row in puzzle:
+ for cell in row:
+ assert cell in range(0, sudoku_logic.SIZE + 1)
+
+ for row in solution:
+ for cell in row:
+ assert cell in range(1, sudoku_logic.SIZE + 1)
+
+
+def test_generate_puzzle_supports_difficulty_levels():
+ for difficulty, expected_clues in [("easy", 45), ("medium", 35), ("hard", 25)]:
+ puzzle, _ = sudoku_logic.generate_puzzle(difficulty=difficulty)
+ clue_count = sum(cell != sudoku_logic.EMPTY for row in puzzle for cell in row)
+ assert clue_count == expected_clues
+
+
+def test_generate_puzzle_has_unique_solution():
+ for difficulty in ["easy", "medium", "hard"]:
+ puzzle, _ = sudoku_logic.generate_puzzle(difficulty=difficulty)
+ assert sudoku_logic.count_solutions(puzzle, limit=2) == 1
+
+
+def test_create_empty_board_has_expected_shape():
+ board = sudoku_logic.create_empty_board()
+
+ assert board == [[0] * sudoku_logic.SIZE for _ in range(sudoku_logic.SIZE)]
+ assert len(board) == sudoku_logic.SIZE
diff --git a/starter/tests/test_timer_ui.py b/starter/tests/test_timer_ui.py
new file mode 100644
index 000000000..19e745a14
--- /dev/null
+++ b/starter/tests/test_timer_ui.py
@@ -0,0 +1,21 @@
+import os
+from pathlib import Path
+
+
+def test_timer_markup_and_script_are_present():
+ template_path = Path('templates/index.html')
+ script_path = Path('static/main.js')
+
+ template_text = template_path.read_text(encoding='utf-8')
+ script_text = script_path.read_text(encoding='utf-8')
+
+ assert 'id="timer"' in template_text
+ assert 'id="hint-button"' in template_text
+ assert 'id="check-puzzle"' in template_text
+ assert 'id="leaderboard"' in template_text
+ assert 'startTimer()' in script_text
+ assert 'stopTimer()' in script_text
+ assert 'requestHint' in script_text
+ assert 'checkPuzzle' in script_text
+ assert 'localStorage' in script_text
+ assert 'hintsUsed' in script_text