jugaadcode 0.1.13__tar.gz → 0.1.15__tar.gz

{jugaadcode-0.1.13 → jugaadcode-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jugaadcode
-Version: 0.1.13
+Version: 0.1.15
 Summary: A Python library for common programming logic and algorithms
 Author: Mohamed Faraazman Bin Farooq S, Surya Deepta
 Requires-Python: >=3.9

{jugaadcode-0.1.13 → jugaadcode-0.1.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jugaadcode"
-version = "0.1.13"
+version = "0.1.15"
 description = "A Python library for common programming logic and algorithms"
 readme = "README.md"
 requires-python = ">=3.9"

jugaadcode-0.1.15/src/jugaadcode/factorial_with_trailing_zeros.py

@@ -0,0 +1,83 @@
+from collections.abc import Iterable
+from .trailing_zeros import trailing_zeros
+
+
+def factorial_with_trailing_zeros(*args):
+    """
+    Find the smallest non-negative integer n whose factorial
+    contains exactly the requested number of trailing zeros.
+
+    Examples:
+        factorial_with_trailing_zeros(0)       -> 0
+        factorial_with_trailing_zeros(1)       -> 5
+        factorial_with_trailing_zeros(6)       -> 25
+        factorial_with_trailing_zeros(5)       -> None
+        factorial_with_trailing_zeros([1, 2, 6]) -> [5, 10, 25]
+        factorial_with_trailing_zeros((1, 2, 6)) -> (5, 10, 25)
+        factorial_with_trailing_zeros(1, 2, 6) -> (5, 10, 25)
+
+    Returns:
+        int | None: Result for a single input.
+        list: Results for a list or other iterable.
+        tuple: Results for a tuple or multiple positional inputs.
+    """
+
+    def find_number(zeros):
+        if isinstance(zeros, bool) or not isinstance(zeros, int):
+            raise TypeError("Input must be an integer.")
+
+        if zeros < 0:
+            raise ValueError("Number of trailing zeros must be non-negative.")
+
+        low = 0
+        high = max(5, zeros * 5)
+
+        while low < high:
+            mid = (low + high) // 2
+
+            if trailing_zeros(mid) < zeros:
+                low = mid + 1
+            else:
+                high = mid
+
+        if trailing_zeros(low) == zeros:
+            return low
+
+        return None
+
+    # Interactive input
+    if not args:
+        value = input(
+            "Enter the required number of trailing zeros: "
+        ).strip()
+
+        numbers = [int(item.strip()) for item in value.split(",")]
+        results = [find_number(number) for number in numbers]
+
+        return results[0] if len(results) == 1 else results
+
+    # Multiple positional inputs
+    if len(args) > 1:
+        return tuple(find_number(number) for number in args)
+
+    value = args[0]
+
+    # Single integer
+    if isinstance(value, int) and not isinstance(value, bool):
+        return find_number(value)
+
+    # Reject strings and bytes
+    if isinstance(value, (str, bytes, bytearray)):
+        raise TypeError("Input must be an integer or an iterable of integers.")
+
+    # Collections and other iterables
+    if isinstance(value, Iterable):
+        numbers = list(value)
+        results = [find_number(number) for number in numbers]
+
+        if isinstance(value, tuple):
+            return tuple(results)
+
+        return results
+
+    raise TypeError("Input must be an integer or an iterable of integers.")

{jugaadcode-0.1.13 → jugaadcode-0.1.15}/src/jugaadcode/trailing_zeros.py

@@ -1,4 +1,6 @@
-def trailing_zeros(n=None):
+from collections.abc import Iterable
+
+def trailing_zeros(*args):
     if n is None:
         n = int(input("Enter a number: "))
 

{jugaadcode-0.1.13 → jugaadcode-0.1.15}/src/jugaadcode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jugaadcode
-Version: 0.1.13
+Version: 0.1.15
 Summary: A Python library for common programming logic and algorithms
 Author: Mohamed Faraazman Bin Farooq S, Surya Deepta
 Requires-Python: >=3.9

jugaadcode-0.1.13/src/jugaadcode/factorial_with_trailing_zeros.py

@@ -1,71 +0,0 @@
-from collections.abc import Iterable
-
-
-def trailing_zeros(*args):
-    """
-    Count trailing zeros in the factorial of one or more non-negative integers.
-
-    Supports:
-        trailing_zeros(5)           -> 1
-        trailing_zeros(10)          -> 2
-        trailing_zeros([5, 10, 25]) -> [1, 2, 6]
-        trailing_zeros((5, 10, 25)) -> (1, 2, 6)
-        trailing_zeros(5, 10, 25)   -> (1, 2, 6)
-
-    If no arguments are supplied, prompts the user for input.
-
-    Returns:
-        int: Trailing-zero count for one integer.
-        list: Results for a list or another iterable.
-        tuple: Results for a tuple or multiple positional integers.
-    """
-
-    def calculate(n):
-        if isinstance(n, bool) or not isinstance(n, int):
-            raise TypeError("Input must be an integer.")
-
-        if n < 0:
-            raise ValueError("Number must be non-negative.")
-
-        count = 0
-
-        while n > 0:
-            n //= 5
-            count += n
-
-        return count
-
-    # Interactive input
-    if not args:
-        n = int(input("Enter a non-negative integer: "))
-        return calculate(n)
-
-    # Multiple positional arguments
-    if len(args) > 1:
-        return tuple(calculate(n) for n in args)
-
-    value = args[0]
-
-    # Single integer
-    if isinstance(value, int) and not isinstance(value, bool):
-        return calculate(value)
-
-    # Reject strings and bytes
-    if isinstance(value, (str, bytes, bytearray)):
-        raise TypeError(
-            "Input must be an integer or an iterable of integers."
-        )
-
-    # Collection or iterable
-    if isinstance(value, Iterable):
-        numbers = list(value)
-        results = [calculate(n) for n in numbers]
-
-        if isinstance(value, tuple):
-            return tuple(results)
-
-        return results
-
-    raise TypeError(
-        "Input must be an integer or an iterable of integers."
-    )