Refactor and optimize repository

Author: varada610

src/main/java/com/thealgorithms/backtracking/ParenthesesGenerator.java

@@ -1,5 +1,7 @@
 package com.thealgorithms.backtracking;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 import java.util.ArrayList;
 import java.util.List;
 
@@ -17,10 +19,9 @@ private ParenthesesGenerator() {
      * @return A list of strings representing valid combinations of parentheses.
      * @throws IllegalArgumentException if n is less than 0.
      */
-    public static List<String> generateParentheses(final int n) {
-        if (n < 0) {
-            throw new IllegalArgumentException("The number of pairs of parentheses cannot be negative");
-        }
+    public static List<String> generateParentheses(final int n) {        
+        checkInputIsPositive(n, "The number of pairs of parentheses cannot be negative.");
+
         List<String> result = new ArrayList<>();
         generateParenthesesHelper(result, "", 0, 0, n);
         return result;

src/main/java/com/thealgorithms/bitmanipulation/HighestSetBit.java

@@ -1,5 +1,7 @@
 package com.thealgorithms.bitmanipulation;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 import java.util.Optional;
 
 /**
@@ -34,10 +36,8 @@ private HighestSetBit() {
      *         Returns {@link Optional#empty()} if the number is 0.
      * @throws IllegalArgumentException if the input number is negative.
      */
-    public static Optional<Integer> findHighestSetBit(int num) {
-        if (num < 0) {
-            throw new IllegalArgumentException("Input cannot be negative");
-        }
+    public static Optional<Integer> findHighestSetBit(int num) {       
+        checkInputIsPositive(num, "Input cannot be negative.");
 
         if (num == 0) {
             return Optional.empty();

src/main/java/com/thealgorithms/datastructures/buffers/CircularBuffer.java

@@ -1,5 +1,7 @@
 package com.thealgorithms.datastructures.buffers;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
@@ -23,9 +25,8 @@ public class CircularBuffer<Item> {
      * @throws IllegalArgumentException if the size is zero or negative.
      */
     public CircularBuffer(int size) {
-        if (size <= 0) {
-            throw new IllegalArgumentException("Buffer size must be positive");
-        }
+        checkInputIsPositive(size, "Buffer size must be positive.");
+
         // noinspection unchecked
         this.buffer = (Item[]) new Object[size];
         this.putPointer = new CircularPointer(0, size);

src/main/java/com/thealgorithms/datastructures/graphs/BoruvkaAlgorithm.java

@@ -1,5 +1,7 @@
 package com.thealgorithms.datastructures.graphs;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 import java.util.ArrayList;
 import java.util.List;
 
@@ -43,9 +45,8 @@ static class Graph {
          * @param edges  list of edges
          */
         Graph(final int vertex, final List<Edge> edges) {
-            if (vertex < 0) {
-                throw new IllegalArgumentException("Number of vertices must be positive");
-            }
+            checkInputIsPositive(vertex, "Number of vertices must be positive.");
+
             if (edges == null || edges.isEmpty()) {
                 throw new IllegalArgumentException("Edges list must not be null or empty");
             }

src/main/java/com/thealgorithms/maths/Area.java renamed to src/main/java/com/thealgorithms/geometry/Area.java

@@ -1,4 +1,6 @@
-package com.thealgorithms.maths;
+package com.thealgorithms.geometry;
+
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
 
 /**
  * Find the area of various geometric shapes
@@ -89,9 +91,8 @@ public static double surfaceAreaCylinder(final double radius, final double heigh
      * @return area of given square
      */
     public static double surfaceAreaSquare(final double sideLength) {
-        if (sideLength <= 0) {
-            throw new IllegalArgumentException("Must be a positive sideLength");
-        }
+        checkInputIsPositive(sideLength, "Must be a positive sideLength.");
+        
         return sideLength * sideLength;
     }
 
@@ -103,12 +104,8 @@ public static double surfaceAreaSquare(final double sideLength) {
      * @return area of given triangle
      */
     public static double surfaceAreaTriangle(final double base, final double height) {
-        if (base <= 0) {
-            throw new IllegalArgumentException(POSITIVE_BASE);
-        }
-        if (height <= 0) {
-            throw new IllegalArgumentException(POSITIVE_HEIGHT);
-        }
+        checkInputIsPositive(base, POSITIVE_BASE);
+        checkInputIsPositive(height, POSITIVE_HEIGHT);
         return base * height / 2;
     }
 
@@ -120,12 +117,8 @@ public static double surfaceAreaTriangle(final double base, final double height)
      * @return area of given parallelogram
      */
     public static double surfaceAreaParallelogram(final double base, final double height) {
-        if (base <= 0) {
-            throw new IllegalArgumentException(POSITIVE_BASE);
-        }
-        if (height <= 0) {
-            throw new IllegalArgumentException(POSITIVE_HEIGHT);
-        }
+        checkInputIsPositive(base, POSITIVE_BASE);
+        checkInputIsPositive(height, POSITIVE_HEIGHT);
         return base * height;
     }
 
@@ -144,9 +137,7 @@ public static double surfaceAreaTrapezium(final double base1, final double base2
         if (base2 <= 0) {
             throw new IllegalArgumentException(POSITIVE_BASE + 2);
         }
-        if (height <= 0) {
-            throw new IllegalArgumentException(POSITIVE_HEIGHT);
-        }
+        checkInputIsPositive(height, POSITIVE_HEIGHT);
         return (base1 + base2) * height / 2;
     }
 
@@ -157,9 +148,8 @@ public static double surfaceAreaTrapezium(final double base1, final double base2
      * @return area of given circle
      */
     public static double surfaceAreaCircle(final double radius) {
-        if (radius <= 0) {
-            throw new IllegalArgumentException(POSITIVE_RADIUS);
-        }
+        checkInputIsPositive(radius, POSITIVE_RADIUS);
+
         return Math.PI * radius * radius;
     }
 
@@ -170,9 +160,8 @@ public static double surfaceAreaCircle(final double radius) {
      * @return surface area of given hemisphere
      */
     public static double surfaceAreaHemisphere(final double radius) {
-        if (radius <= 0) {
-            throw new IllegalArgumentException(POSITIVE_RADIUS);
-        }
+        checkInputIsPositive(radius, POSITIVE_RADIUS);
+
         return 3 * Math.PI * radius * radius;
     }
 
@@ -184,12 +173,9 @@ public static double surfaceAreaHemisphere(final double radius) {
      * @return surface area of given cone.
      */
     public static double surfaceAreaCone(final double radius, final double height) {
-        if (radius <= 0) {
-            throw new IllegalArgumentException(POSITIVE_RADIUS);
-        }
-        if (height <= 0) {
-            throw new IllegalArgumentException(POSITIVE_HEIGHT);
-        }
+        checkInputIsPositive(radius, POSITIVE_RADIUS);
+        checkInputIsPositive(height, POSITIVE_HEIGHT);
+
         return Math.PI * radius * (radius + Math.pow(height * height + radius * radius, 0.5));
     }
 }

src/main/java/com/thealgorithms/maths/Volume.java renamed to src/main/java/com/thealgorithms/geometry/Volume.java

@@ -1,4 +1,4 @@
-package com.thealgorithms.maths;
+package com.thealgorithms.geometry;
 
 /* Calculate the volume of various shapes.*/
 public final class Volume {

src/main/java/com/thealgorithms/maths/Armstrong.java

@@ -1,5 +1,7 @@
 package com.thealgorithms.maths;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 /**
  * This class checks whether a given number is an Armstrong number or not.
  * An Armstrong number is a number that is equal to the sum of its own digits,
@@ -21,9 +23,8 @@ public class Armstrong {
      * @return {@code true} if the given number is an Armstrong number, {@code false} otherwise
      */
     public boolean isArmstrong(int number) {
-        if (number < 0) {
-            return false; // Negative numbers cannot be Armstrong numbers
-        }
+        checkInputIsPositive(number, "Negative numbers cannot be Armstrong numbers.");
+
         long sum = 0;
         int totalDigits = (int) Math.log10(number) + 1; // get the length of the number (number of digits)
         long originalNumber = number;

src/main/java/com/thealgorithms/maths/Combinations.java

@@ -1,5 +1,7 @@
 package com.thealgorithms.maths;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 /**
  * @see <a href="https://en.wikipedia.org/wiki/Combination">Combination</a>
  */
@@ -14,9 +16,8 @@ private Combinations() {
      * @return factorial of given number
      */
     public static long factorial(int n) {
-        if (n < 0) {
-            throw new IllegalArgumentException("number is negative");
-        }
+        checkInputIsPositive(n, "Input number cannot be negative.");
+
         return n == 0 || n == 1 ? 1 : n * factorial(n - 1);
     }
 

src/main/java/com/thealgorithms/maths/DudeneyNumber.java

@@ -6,17 +6,18 @@
  */
 package com.thealgorithms.maths;
 
+import static com.thealgorithms.maths.PerfectCube.getCubeRoot;
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 public final class DudeneyNumber {
     private DudeneyNumber() {
     }
 
     // returns True if the number is a Dudeney number and False if it is not a Dudeney number.
     public static boolean isDudeney(final int n) {
-        if (n <= 0) {
-            throw new IllegalArgumentException("Input must me positive.");
-        }
+        checkInputIsPositive(n, "Input number should be positive.");
         // Calculating Cube Root
-        final int cubeRoot = (int) Math.round(Math.pow(n, 1.0 / 3.0));
+        final int cubeRoot = getCubeRoot(n);
         // If the number is not a perfect cube the method returns false.
         if (cubeRoot * cubeRoot * cubeRoot != n) {
             return false;

src/main/java/com/thealgorithms/maths/EulersFunction.java

@@ -1,24 +1,14 @@
 package com.thealgorithms.maths;
 
+import static com.thealgorithms.maths.utils.MathsUtil.checkInputIsPositive;
+
 /**
  * Utility class for computing
  * <a href="https://en.wikipedia.org/wiki/Euler%27s_totient_function">Euler's totient function</a>.
  */
 public final class EulersFunction {
     private EulersFunction() {
-    }
-
-    /**
-     * Validates that the input is a positive integer.
-     *
-     * @param n the input number to validate
-     * @throws IllegalArgumentException if {@code n} is non-positive
-     */
-    private static void checkInput(int n) {
-        if (n <= 0) {
-            throw new IllegalArgumentException("n must be positive.");
-        }
-    }
+    }   
 
     /**
      * Computes the value of Euler's totient function for a given input.
@@ -29,7 +19,7 @@ private static void checkInput(int n) {
      * @throws IllegalArgumentException if {@code n} is non-positive
      */
     public static int getEuler(int n) {
-        checkInput(n);
+        checkInputIsPositive(n, "Input number should be positive.");
         int result = n;
         for (int i = 2; i * i <= n; i++) {
             if (n % i == 0) {