Challenge/1 even odd range rouaa

solutions/even_odd_range.py

@@ -0,0 +1,79 @@
+"""
+This module contains a function that takes a range of numbers and returns
+two lists: one for even numbers and one for odd numbers within the specified range.
+
+Function:
+    even_odd_range(start: int, end: int) -> tuple[list[int], list[int]]
+
+Arguments:
+    start (int): The starting number of the range (inclusive).
+    end (int): The ending number of the range (inclusive).
+
+Returns:
+    tuple[list[int], list[int]]: A tuple containing two lists:
+        - A list of even numbers in the range.
+        - A list of odd numbers in the range.
+
+Raises:
+    ValueError: If start or end are not integers.
+    ValueError: If start is greater than end.
+
+Examples:
+    >>> even_odd_range(1, 5)
+    ([2, 4], [1, 3, 5])
+    >>> even_odd_range(0, 0)
+    ([0], [])
+    >>> even_odd_range(-3, 3)
+    ([0, -2, 2], [-3, -1, 1, 3])
+    >>> even_odd_range(5, 3)
+    Traceback (most recent call last):
+        ...
+    ValueError: The start value must not be greater than the end value.
+"""
+
+from typing import List, Tuple
+
+
+def even_odd_range(start: int, end: int) -> Tuple[List[int], List[int]]:
+    """
+    Returns two lists: one with the even numbers and one with the odd numbers
+    within the specified range.
+
+    Arguments:
+    start -- The starting number (inclusive)
+    end -- The ending number (inclusive)
+
+    Returns:
+    A tuple of two lists: the first list contains even numbers, the second contains odd numbers.
+
+    Examples:
+    >>> even_odd_range(-2, 2)
+    ([0, -2, 2], [-1, 1])
+    """
+from typing import List, Tuple
+
+def even_odd_range(start: int, end: int) -> Tuple[List[int], List[int]]:
+    """
+    Returns two lists: one with the even numbers and one with the odd numbers
+    within the specified range.
+
+    Arguments:
+    start -- The starting number (inclusive)
+    end -- The ending number (inclusive)
+
+    Returns:
+    A tuple of two lists: the first list contains even numbers, the second contains odd numbers.
+
+    Examples:
+    >>> even_odd_range(-2, 2)
+    ([0, -2, 2], [-1, 1])
+    """
+    if not isinstance(start, int) or not isinstance(end, int):
+        raise ValueError("Both start and end must be integers.")
+    if start > end:
+        raise ValueError("The start value must not be greater than the end value.")
+
+    even_numbers = [num for num in range(start, end + 1) if num % 2 == 0]
+    odd_numbers = [num for num in range(start, end + 1) if num % 2 != 0]
+
+    return even_numbers, odd_numbers

solutions/tests/test_even_odd_range.py

@@ -0,0 +1,61 @@
+import unittest
+import sys
+from pathlib import Path
+sys.path.append(str(Path(file).parent.parent))
+from even_odd_range import even_odd_range
+
+
+class TestEvenOddRange(unittest.TestCase):
+    """
+    Test case for the even_odd_range function.
+    """
+
+    def test_even_odd_range_valid(self):
+        """Tests valid ranges with both even and odd numbers."""
+        result = even_odd_range(1, 5)
+        self.assertEqual(result, ([2, 4], [1, 3, 5]))
+
+    def test_even_odd_range_single(self):
+        """Tests single number in the range (even)."""
+        result = even_odd_range(4, 4)
+        self.assertEqual(result, ([4], []))
+
+    def test_even_odd_range_negative_numbers(self):
+        """Tests ranges that include negative numbers."""
+        result = even_odd_range(-5, 0)
+        self.assertEqual(result, ([-4, -2, 0], [-5, -3, -1]))
+
+    def test_even_odd_range_large_range_even(self):
+        """Tests large range for even numbers."""
+        result = even_odd_range(1, 100)
+        self.assertEqual(result[0], list(range(2, 101, 2)))
+
+    def test_even_odd_range_large_range_odd(self):
+        """Tests large range for odd numbers."""
+        result = even_odd_range(1, 100)
+        self.assertEqual(result[1], list(range(1, 101, 2)))
+
+    def test_even_odd_range_invalid_type(self):
+        """Tests ValueError for non-integer inputs."""
+        with self.assertRaises(ValueError) as context:
+            even_odd_range(1, "5")
+        self.assertEqual(str(context.exception), "Both start and end must be integers.")
+
+    def test_even_odd_range_invalid_order(self):
+        """Tests ValueError when start > end."""
+        with self.assertRaises(ValueError) as context:
+            even_odd_range(5, 3)
+        self.assertEqual(str(context.exception), "The start value must not be greater than the end value.")
+
+    def test_even_odd_range_empty_range(self):
+        """Tests empty range with the same start and end."""
+        result = even_odd_range(5, 5)
+        self.assertEqual(result, ([], [5]))
+
+    def test_even_odd_range_all_negative(self):
+        """Tests range with only negative numbers."""
+        result = even_odd_range(-10, -1)
+        self.assertEqual(result, ([-10, -8, -6, -4, -2], [-9, -7, -5, -3, -1]))
+
+if _name_ == "_main_":
+    unittest.main()