jugaadcode 0.1.17__tar.gz → 0.1.18__tar.gz

{jugaadcode-0.1.17 → jugaadcode-0.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jugaadcode
-Version: 0.1.17
+Version: 0.1.18
 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.17 → jugaadcode-0.1.18}/pyproject.toml

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

jugaadcode-0.1.18/src/jugaadcode/armstrong.py

@@ -0,0 +1,127 @@
+from collections.abc import Iterable
+
+
+def is_armstrong(*args):
+    """
+    Check whether one or more integers are Armstrong numbers.
+
+    Supports:
+        is_armstrong(153)
+        is_armstrong(153, 370, 123)
+        is_armstrong([153, 370, 123])
+        is_armstrong((153, 370, 123))
+        is_armstrong({153, 370, 123})
+        is_armstrong(range(100, 200))
+        is_armstrong(n for n in [153, 370, 123])
+        is_armstrong()
+        
+    Returns
+    -------
+    bool
+        For a single integer.
+
+    list[bool]
+        For lists, sets, ranges, generators, and other iterables.
+
+    tuple[bool, ...]
+        For tuples or multiple positional arguments.
+
+    Raises
+    ------
+    TypeError
+        If an input is not an integer or supported iterable.
+
+    ValueError
+        If an input contains a negative integer or no values.
+    """
+
+    # Interactive input when no arguments are provided.
+    if not args:
+        value = input(
+            "Enter number(s) to check, separated by commas: "
+        ).strip()
+
+        if not value:
+            raise ValueError("Input cannot be empty.")
+
+        try:
+            args = tuple(
+                int(item.strip()) for item in value.split(",")
+            )
+        except ValueError as exc:
+            raise ValueError(
+                "Enter valid integers separated by commas."
+            ) from exc
+
+    # Determine the input format.
+    if len(args) > 1:
+        # Multiple positional arguments.
+        numbers = list(args)
+        input_type = "tuple"
+
+    else:
+        value = args[0]
+
+        if isinstance(value, bool):
+            numbers = [value]
+            input_type = "single"
+
+        elif isinstance(value, int):
+            numbers = [value]
+            input_type = "single"
+
+        elif isinstance(value, (str, bytes, bytearray)):
+            raise TypeError(
+                "Input must contain integers, not strings or bytes."
+            )
+
+        elif isinstance(value, Iterable):
+            numbers = list(value)
+
+            if isinstance(value, tuple):
+                input_type = "tuple"
+            else:
+                input_type = "list"
+
+        else:
+            raise TypeError(
+                "Input must be an integer or an iterable of integers."
+            )
+
+    # Reject empty collections and generators.
+    if not numbers:
+        raise ValueError("At least one number must be provided.")
+
+    def check_number(n):
+        # Booleans are not accepted as integers.
+        if isinstance(n, bool) or not isinstance(n, int):
+            raise TypeError("Every value must be an integer.")
+
+        if n < 0:
+            raise ValueError(
+                "Armstrong number checking requires "
+                "non-negative integers."
+            )
+
+        digits = str(n)
+        power = len(digits)
+
+        total = sum(
+            int(digit) ** power for digit in digits
+        )
+
+        return total == n
+
+    # Calculate results.
+    results = [
+        check_number(n) for n in numbers
+    ]
+
+    # Return the result in the appropriate format.
+    if input_type == "single":
+        return results[0]
+
+    if input_type == "tuple":
+        return tuple(results)
+
+    return results

{jugaadcode-0.1.17 → jugaadcode-0.1.18}/src/jugaadcode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jugaadcode
-Version: 0.1.17
+Version: 0.1.18
 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.17/src/jugaadcode/armstrong.py

@@ -1,93 +0,0 @@
-def is_armstrong(*args):
-    """
-    Check whether one or more integers are Armstrong numbers.
-
-    Supports:
-        is_armstrong(153)
-        is_armstrong(153, 370, 123)
-        is_armstrong([153, 370, 123])
-        is_armstrong((153, 370, 123))
-        is_armstrong({153, 370, 123})
-        is_armstrong(range(100, 200))
-        is_armstrong()
-
-    Returns
-    -------
-    bool
-        For a single integer.
-    list[bool] or tuple[bool, ...] or set[bool]
-        For multiple integers, according to the input format.
-
-    Raises
-    ------
-    TypeError
-        If an input is not an integer or supported collection.
-    ValueError
-        If an input contains a negative integer or no values.
-    """
-
-    if not args:
-        value = input(
-            "Enter number(s) to check, separated by commas: "
-        ).strip()
-
-        if not value:
-            raise ValueError("Input cannot be empty.")
-
-        try:
-            args = tuple(int(item.strip()) for item in value.split(","))
-        except ValueError as exc:
-            raise ValueError(
-                "Enter valid integers separated by commas."
-            ) from exc
-
-    # Determine whether the caller supplied a collection or
-    # multiple individual arguments.
-    if len(args) == 1:
-        value = args[0]
-
-        if isinstance(value, (list, tuple, set, range)):
-            numbers = list(value)
-            input_type = type(value)
-        else:
-            numbers = [value]
-            input_type = None
-    else:
-        numbers = list(args)
-        input_type = tuple
-
-    if not numbers:
-        raise ValueError("At least one number must be provided.")
-
-    def check_number(n):
-        if isinstance(n, bool) or not isinstance(n, int):
-            raise TypeError("Every value must be an integer.")
-
-        if n < 0:
-            raise ValueError(
-                "Armstrong number checking requires non-negative integers."
-            )
-
-        digits = str(n)
-        power = len(digits)
-
-        total = sum(int(digit) ** power for digit in digits)
-
-        return total == n
-
-    results = [check_number(n) for n in numbers]
-
-    # Preserve a single result for a single integer.
-    if input_type is None:
-        return results[0]
-
-    if input_type is list or input_type is range:
-        return results
-
-    if input_type is tuple:
-        return tuple(results)
-
-    if input_type is set:
-        return set(results)
-
-    return results