orionis 0.229.0__tar.gz → 0.231.0__tar.gz

{orionis-0.229.0/orionis.egg-info → orionis-0.231.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: orionis
-Version: 0.229.0
+Version: 0.231.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro

{orionis-0.229.0 → orionis-0.231.0}/orionis/framework.py

@@ -5,7 +5,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.229.0"
+VERSION = "0.231.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

{orionis-0.229.0 → orionis-0.231.0}/orionis/luminate/console/output/console.py

@@ -556,4 +556,32 @@ class Console(IConsole):
             print(f"  {ANSIColors.DIM.value}{ANSIColors.ITALIC.value}{ANSIColors.TEXT_WARNING.value}{name}{ANSIColors.TEXT_RESET.value} : {ANSIColors.CYAN.value}{line}{ANSIColors.TEXT_RESET.value}")
             count_error -= 1
 
-        print("▬" * len(f" [{error_type}] : {error_message}"))
+        print("▬" * len(f" [{error_type}] : {error_message}"))
+
+    @staticmethod
+    def exitSuccess(message: str = None) -> None:
+        """
+        Exits the program with a success message.
+
+        Parameters
+        ----------
+        message : str, optional
+            The success message to print before exiting.
+        """
+        if message:
+            Console.success(message)
+        sys.exit(0)
+
+    @staticmethod
+    def exitError(message: str = None) -> None:
+        """
+        Exits the program with an error message.
+
+        Parameters
+        ----------
+        message : str, optional
+            The error message to print before exiting.
+        """
+        if message:
+            Console.error(message)
+        sys.exit(1)

orionis-0.231.0/orionis/luminate/test/contracts/test_suite.py

@@ -0,0 +1,42 @@
+from abc import ABC, abstractmethod
+
+class ITestSuite(ABC):
+    """
+    Provides utility methods to configure and execute unit tests from specified folders.
+    """
+
+    @staticmethod
+    @abstractmethod
+    def load(
+        base_path: str = 'tests',
+        folder_path: list | str = '*',
+        pattern: str = 'test_*.py'
+    ):
+        """
+        Discover and initialize a test suite from the specified folder(s).
+
+        This method scans the provided folder(s) for test files matching the given pattern
+        and initializes a test suite with the discovered files.
+
+        Parameters
+        ----------
+        base_path : str, optional
+            The base path for the tests. Defaults to 'tests'.
+        folder_path : str or list of str, optional
+            Path(s) to the folder(s) containing test files. Use '*' to scan all folders
+            under the base path. Defaults to '*'.
+        pattern : str, optional
+            File pattern to match test files. Defaults to 'test_*.py'.
+
+        Returns
+        -------
+        UnitTestClass
+            An initialized test suite containing the discovered test files.
+
+        Raises
+        ------
+        TypeError
+            If `base_path` is not a string, `folder_path` is not a string or list, or
+            `pattern` is not a string.
+        """
+        pass

{orionis-0.229.0 → orionis-0.231.0}/orionis/luminate/test/contracts/test_unit.py

@@ -17,7 +17,7 @@ class IUnitTest:
         Timestamp when the test execution started.
     """
 
-    def addFolder(
+    def discoverTestsInFolder(
         self,
         folder_path: str,
         base_path: str = "tests",

orionis-0.231.0/orionis/luminate/test/test_suite.py

@@ -0,0 +1,85 @@
+import re
+from os import walk
+from orionis.luminate.test.contracts.test_suite import ITestSuite
+from orionis.luminate.test.test_unit import UnitTest as UnitTestClass
+
+class TestSuite(ITestSuite):
+    """
+    A class containing test utility methods.
+    """
+
+    @staticmethod
+    def load(
+        base_path: str = 'tests',
+        folder_path: list | str = '*',
+        pattern: str = 'test_*.py'
+    ) -> UnitTestClass:
+        """
+        Discover and initialize a test suite from the specified folder(s).
+
+        This method scans the provided folder(s) for test files matching the given pattern
+        and initializes a test suite with the discovered files.
+
+        Parameters
+        ----------
+        base_path : str, optional
+            The base path for the tests. Defaults to 'tests'.
+        folder_path : str or list of str, optional
+            Path(s) to the folder(s) containing test files. Use '*' to scan all folders
+            under the base path. Defaults to '*'.
+        pattern : str, optional
+            File pattern to match test files. Defaults to 'test_*.py'.
+
+        Returns
+        -------
+        UnitTestClass
+            An initialized test suite containing the discovered test files.
+
+        Raises
+        ------
+        TypeError
+            If `base_path` is not a string, `folder_path` is not a string or list, or
+            `pattern` is not a string.
+        """
+        # Validate parameters
+        if not isinstance(base_path, str):
+            raise TypeError("base_path must be a string")
+        if not isinstance(folder_path, (str, list)):
+            raise TypeError("folder_path must be a string or a list")
+        if not isinstance(pattern, str):
+            raise TypeError("pattern must be a string")
+
+        # Helper function to list folders matching the pattern
+        def list_matching_folders(custom_path: str, pattern: str):
+            matched_folders = []
+            for root, _, files in walk(custom_path):
+                for file in files:
+                    if re.fullmatch(pattern.replace('*', '.*').replace('?', '.'), file):
+                        relative_path = root.replace(base_path, '').replace('\\', '/').lstrip('/')
+                        if relative_path not in matched_folders:
+                            matched_folders.append(relative_path)
+            return matched_folders
+
+        # Discover folders
+        discovered_folders = []
+        if folder_path == '*':
+            discovered_folders.extend(list_matching_folders(base_path, pattern))
+        elif isinstance(folder_path, list):
+            for custom_path in folder_path:
+                discovered_folders.extend(list_matching_folders(custom_path, pattern))
+        else:
+            discovered_folders.extend(list_matching_folders(folder_path, pattern))
+
+        # Initialize the test suite
+        tests = UnitTestClass()
+
+        # Add discovered folders to the test suite
+        for folder in discovered_folders:
+            tests.discoverTestsInFolder(
+                base_path=base_path,
+                folder_path=folder,
+                pattern=pattern
+            )
+
+        # Return the initialized test suite
+        return tests

{orionis-0.229.0 → orionis-0.231.0}/orionis/luminate/test/test_unit.py

@@ -42,7 +42,7 @@ class UnitTest(IUnitTest):
         self.test_results: List[TestResult] = []
         self.start_time: float = 0.0
 
-    def addFolder(
+    def discoverTestsInFolder(
             self,
             folder_path: str,
             base_path: str = "tests",

{orionis-0.229.0 → orionis-0.231.0/orionis.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: orionis
-Version: 0.229.0
+Version: 0.231.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro

orionis-0.229.0/orionis/luminate/test/contracts/test_suite.py

@@ -1,37 +0,0 @@
-class ITests:
-    """
-    Provides utility methods to configure and execute unit tests from specified folders.
-    """
-
-    @staticmethod
-    def execute(folders: list, print_result:bool = True, throw_exception:bool = False):
-        """
-        Configure and run unit tests from a list of folder definitions.
-
-        Parameters
-        ----------
-        folders : list of dict
-            Each dict must include:
-            - 'folder_path' (str): Path to the folder with test files.
-            - 'base_path' (str): Base path for resolving test imports.
-            - 'pattern' (str): Glob pattern for test file names.
-
-        print_result : bool, default=True
-            Whether to print test results to the console.
-
-        throw_exception : bool, default=False
-            Whether to raise exceptions on test failures.
-
-        Returns
-        -------
-        UnitTestClass
-            The initialized and executed test suite.
-
-        Raises
-        ------
-        TypeError
-            If `folders` is not a list of dictionaries.
-        KeyError
-            If any dictionary lacks required keys: 'folder_path', 'base_path', or 'pattern'.
-        """
-        pass

orionis-0.229.0/orionis/luminate/test/test_suite.py

@@ -1,68 +0,0 @@
-from orionis.luminate.test.contracts.test_suite import ITests
-from orionis.luminate.test.test_unit import UnitTest as UnitTestClass
-
-class Tests(ITests):
-    """
-    A class containing test utility methods.
-
-    Methods
-    -------
-    folders(folders: list) -> UnitTestClass
-        Validates folder configurations and initializes test suite.
-    """
-
-    @staticmethod
-    def execute(folders: list, print_result:bool = True, throw_exception:bool = False):
-        """
-        Validate folder configurations and initialize test suite.
-
-        Parameters
-        ----------
-        folders : list
-            List of folder configuration dictionaries. Each dictionary must contain:
-            - folder_path : str
-                Path to the folder containing test files
-            - base_path : str
-                Base path for the tests
-            - pattern : str
-                File pattern to match test files
-
-        Returns
-        -------
-        UnitTestClass
-            Initialized test suite with added folders
-
-        Raises
-        ------
-        TypeError
-            If folders is not a list or contains non-dictionary items
-        KeyError
-            If any folder dictionary is missing required keys
-
-        Examples
-        --------
-        >>> Tests.folders([
-        ...     {
-        ...         'folder_path': 'example',
-        ...         'base_path': 'tests',
-        ...         'pattern': 'test_*.py'
-        ...     }
-        ... ])
-        """
-        if not isinstance(folders, list):
-            raise TypeError("folders must be a list")
-
-        for folder in folders:
-            if not isinstance(folder, dict):
-                raise TypeError("each folder must be a dictionary")
-            if not all(key in folder for key in ['folder_path', 'base_path', 'pattern']):
-                raise KeyError("each folder must contain 'folder_path', 'base_path' and 'pattern' keys")
-
-        tests = UnitTestClass()
-        for folder in folders:
-            tests.addFolder(
-                base_path=folder['base_path'],
-                folder_path=folder['folder_path'],
-                pattern=folder['pattern']
-            )
-        return tests.run(print_result, throw_exception)