Challenge/1 even odd range rouaa

solutions/even_odd.py

@@ -0,0 +1,53 @@
+"""
+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.
+"""
+
+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.
+    """
+
+    # Defensive assertions
+    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 = []
+    odd_numbers = []
+
+    for num in range(start, end + 1):
+        if num % 2 == 0:
+            even_numbers.append(num)
+        else:
+            odd_numbers.append(num)
+
+    return even_numbers, odd_numbers

solutions/tests/test_even_odd_range.py

@@ -0,0 +1,44 @@
+import unittest
+
+from ..even_odd import even_odd_range
+
+
+class TestEvenOddRange(unittest.TestCase):
+    """
+    Test case for the even_odd_range function.
+    """
+
+    def test_even_odd_range_valid(self):
+        """
+        Tests that the function correctly splits a range into even and odd numbers.
+        """
+        result = even_odd_range(1, 5)
+        self.assertEqual(result, ([2, 4], [1, 3, 5]))
+
+    def test_even_odd_range_empty(self):
+        """
+        Tests that the function raises an error for an empty range where start > end.
+        """
+        with self.assertRaises(ValueError):
+            even_odd_range(5, 4)
+
+    def test_even_odd_range_single(self):
+        """
+        Tests that a single number in the range is classified correctly.
+        """
+        result = even_odd_range(4, 4)
+        self.assertEqual(result, ([4], []))
+
+    def test_even_odd_range_invalid_type(self):
+        """
+        Tests that ValueError is raised if start or end are not integers.
+        """
+        with self.assertRaises(ValueError):
+            even_odd_range(1, "5")
+
+    def test_even_odd_range_invalid_order(self):
+        """
+        Tests that ValueError is raised if start is greater than end.
+        """
+        with self.assertRaises(ValueError):
+            even_odd_range(5, 3)