Create package prime, matrix and games (#6139)

src/test/java/com/thealgorithms/puzzlesandgames/SudokuTest.java

@@ -0,0 +1,38 @@
+package com.thealgorithms.puzzlesandgames;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import org.junit.jupiter.api.Test;
+
+public class SudokuTest {
+
+    @Test
+    void testIsSafe2() {
+        int[][] board = {{3, 0, 6, 5, 0, 8, 4, 0, 0}, {5, 2, 0, 0, 0, 0, 0, 0, 0}, {0, 8, 7, 0, 0, 0, 0, 3, 1}, {0, 0, 3, 0, 1, 0, 0, 8, 0}, {9, 0, 0, 8, 6, 3, 0, 0, 5}, {0, 5, 0, 0, 9, 0, 6, 0, 0}, {1, 3, 0, 0, 0, 0, 2, 5, 0}, {0, 0, 0, 0, 0, 0, 0, 7, 4}, {0, 0, 5, 2, 0, 6, 3, 0, 0}};
+
+        assertFalse(Sudoku.isSafe(board, 0, 1, 3));
+        assertTrue(Sudoku.isSafe(board, 1, 2, 1));
+        assertThrows(ArrayIndexOutOfBoundsException.class, () -> { Sudoku.isSafe(board, 10, 10, 5); });
+        assertThrows(ArrayIndexOutOfBoundsException.class, () -> { Sudoku.isSafe(board, -1, 0, 5); });
+    }
+
+    @Test
+    void testSolveSudoku() {
+        int[][] board = {{3, 0, 6, 5, 0, 8, 4, 0, 0}, {5, 2, 0, 0, 0, 0, 0, 0, 0}, {0, 8, 7, 0, 0, 0, 0, 3, 1}, {0, 0, 3, 0, 1, 0, 0, 8, 0}, {9, 0, 0, 8, 6, 3, 0, 0, 5}, {0, 5, 0, 0, 9, 0, 6, 0, 0}, {1, 3, 0, 0, 0, 0, 2, 5, 0}, {0, 0, 0, 0, 0, 0, 0, 7, 4}, {0, 0, 5, 2, 0, 6, 3, 0, 0}};
+
+        assertTrue(Sudoku.solveSudoku(board, board.length));
+        assertEquals(1, board[0][1]);
+        assertThrows(ArrayIndexOutOfBoundsException.class, () -> { Sudoku.solveSudoku(board, 10); });
+        assertTrue(Sudoku.solveSudoku(board, -1));
+    }
+
+    @Test
+    void testUnsolvableSudoku() {
+        int[][] unsolvableBoard = {{5, 1, 6, 8, 4, 9, 7, 3, 2}, {3, 0, 7, 6, 0, 5, 0, 0, 0}, {8, 0, 9, 7, 0, 0, 0, 6, 5}, {1, 3, 5, 0, 6, 0, 9, 0, 7}, {4, 7, 2, 5, 9, 1, 0, 0, 6}, {9, 6, 8, 3, 7, 0, 0, 5, 0}, {2, 5, 3, 1, 8, 6, 0, 7, 4}, {6, 8, 4, 2, 5, 7, 3, 9, 0}, {7, 9, 1, 4, 3, 0, 5, 0, 0}};
+
+        assertFalse(Sudoku.solveSudoku(unsolvableBoard, unsolvableBoard.length));
+    }
+}

src/test/java/com/thealgorithms/puzzlesandgames/TowerOfHanoiTest.java

@@ -0,0 +1,50 @@
+package com.thealgorithms.puzzlesandgames;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.util.ArrayList;
+import java.util.List;
+import org.junit.jupiter.api.Test;
+
+public class TowerOfHanoiTest {
+
+    @Test
+    public void testHanoiWithOneDisc() {
+        List<String> result = new ArrayList<>();
+        TowerOfHanoi.shift(1, "Pole1", "Pole2", "Pole3", result);
+
+        // Expected output for 1 disc
+        List<String> expected = List.of("Move 1 from Pole1 to Pole3");
+        assertEquals(expected, result);
+    }
+
+    @Test
+    public void testHanoiWithTwoDiscs() {
+        List<String> result = new ArrayList<>();
+        TowerOfHanoi.shift(2, "Pole1", "Pole2", "Pole3", result);
+
+        // Expected output for 2 discs
+        List<String> expected = List.of("Move 1 from Pole1 to Pole2", "Move 2 from Pole1 to Pole3", "Move 1 from Pole2 to Pole3");
+        assertEquals(expected, result);
+    }
+
+    @Test
+    public void testHanoiWithThreeDiscs() {
+        List<String> result = new ArrayList<>();
+        TowerOfHanoi.shift(3, "Pole1", "Pole2", "Pole3", result);
+
+        // Expected output for 3 discs
+        List<String> expected = List.of("Move 1 from Pole1 to Pole3", "Move 2 from Pole1 to Pole2", "Move 1 from Pole3 to Pole2", "Move 3 from Pole1 to Pole3", "Move 1 from Pole2 to Pole1", "Move 2 from Pole2 to Pole3", "Move 1 from Pole1 to Pole3");
+        assertEquals(expected, result);
+    }
+
+    @Test
+    public void testHanoiWithZeroDiscs() {
+        List<String> result = new ArrayList<>();
+        TowerOfHanoi.shift(0, "Pole1", "Pole2", "Pole3", result);
+
+        // There should be no moves if there are 0 discs
+        assertTrue(result.isEmpty());
+    }
+}

src/test/java/com/thealgorithms/puzzlesandgames/WordBoggleTest.java

@@ -0,0 +1,57 @@
+package com.thealgorithms.puzzlesandgames;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.List;
+import java.util.stream.Stream;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.Arguments;
+import org.junit.jupiter.params.provider.MethodSource;
+
+class WordBoggleTest {
+    private char[][] board;
+
+    @BeforeEach
+    void setup() {
+        board = new char[][] {
+            {'t', 'h', 'i', 's', 'i', 's', 'a'},
+            {'s', 'i', 'm', 'p', 'l', 'e', 'x'},
+            {'b', 'x', 'x', 'x', 'x', 'e', 'b'},
+            {'x', 'o', 'g', 'g', 'l', 'x', 'o'},
+            {'x', 'x', 'x', 'D', 'T', 'r', 'a'},
+            {'R', 'E', 'P', 'E', 'A', 'd', 'x'},
+            {'x', 'x', 'x', 'x', 'x', 'x', 'x'},
+            {'N', 'O', 'T', 'R', 'E', '_', 'P'},
+            {'x', 'x', 'D', 'E', 'T', 'A', 'E'},
+        };
+    }
+
+    @ParameterizedTest
+    @MethodSource("provideTestCases")
+    void testBoggleBoard(String[] words, List<String> expectedWords, String testDescription) {
+        List<String> result = WordBoggle.boggleBoard(board, words);
+        assertEquals(expectedWords.size(), result.size(), "Test failed for: " + testDescription);
+        assertTrue(expectedWords.containsAll(result), "Test failed for: " + testDescription);
+    }
+
+    private static Stream<Arguments> provideTestCases() {
+        return Stream.of(Arguments.of(new String[] {"this", "is", "not", "a", "simple", "test", "boggle", "board", "REPEATED", "NOTRE_PEATED"}, Arrays.asList("this", "is", "a", "simple", "board", "boggle", "NOTRE_PEATED"), "All words"),
+            Arguments.of(new String[] {"xyz", "hello", "world"}, List.of(), "No matching words"), Arguments.of(new String[] {}, List.of(), "Empty words array"), Arguments.of(new String[] {"this", "this", "board", "board"}, Arrays.asList("this", "board"), "Duplicate words in input"));
+    }
+
+    @ParameterizedTest
+    @MethodSource("provideSpecialCases")
+    void testBoggleBoardSpecialCases(char[][] specialBoard, String[] words, Collection<String> expectedWords, String testDescription) {
+        List<String> result = WordBoggle.boggleBoard(specialBoard, words);
+        assertEquals(expectedWords.size(), result.size(), "Test failed for: " + testDescription);
+        assertTrue(expectedWords.containsAll(result), "Test failed for: " + testDescription);
+    }
+
+    private static Stream<Arguments> provideSpecialCases() {
+        return Stream.of(Arguments.of(new char[0][0], new String[] {"this", "is", "a", "test"}, List.of(), "Empty board"));
+    }
+}