orionis 0.228.0__py3-none-any.whl → 0.230.0__py3-none-any.whl

orionis/framework.py

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

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/luminate/test/contracts/test_suite.py

@@ -1,37 +1,42 @@
-class ITests:
+from abc import ABC, abstractmethod
+
+class ITestSuite(ABC):
     """
     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):
+    @abstractmethod
+    def load(
+        base_path: str = 'tests',
+        folder_path: list | str = '*',
+        pattern: str = 'test_*.py'
+    ):
         """
-        Configure and run unit tests from a list of folder definitions.
+        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
         ----------
-        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.
+        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
-            The initialized and executed test suite.
+            An initialized test suite containing the discovered test files.
 
         Raises
         ------
         TypeError
-            If `folders` is not a list of dictionaries.
-        KeyError
-            If any dictionary lacks required keys: 'folder_path', 'base_path', or 'pattern'.
+            If `base_path` is not a string, `folder_path` is not a string or list, or
+            `pattern` is not a string.
         """
         pass

orionis/luminate/test/test_case.py

@@ -23,9 +23,9 @@ class TestCase(unittest.IsolatedAsyncioTestCase, TestStdOut):
         await super().asyncTearDown()
 
 # Another asynchronous test case class
-class TestAsyncCase(unittest.IsolatedAsyncioTestCase, TestStdOut):
+class AsyncTestCase(unittest.IsolatedAsyncioTestCase, TestStdOut):
     """
-    TestAsyncCase is a test case class designed for asynchronous unit testing.
+    AsyncTestCase is a test case class designed for asynchronous unit testing.
     It inherits from `unittest.IsolatedAsyncioTestCase` to provide support for
     async test methods and `TestStdOut` for additional functionality.
     Methods
@@ -53,9 +53,9 @@ class TestAsyncCase(unittest.IsolatedAsyncioTestCase, TestStdOut):
         """
         await super().asyncTearDown()
 
-class TestSyncCase(unittest.TestCase, TestStdOut):
+class SyncTestCase(unittest.TestCase, TestStdOut):
     """
-    TestSyncCase is a test case class designed for synchronous unit testing.
+    SyncTestCase is a test case class designed for synchronous unit testing.
     It inherits from `unittest.TestCase` to provide support for standard test methods
     and `TestStdOut` for additional functionality.
     """

orionis/luminate/test/test_suite.py

@@ -1,68 +1,85 @@
-from orionis.luminate.test.contracts.test_suite import ITests
+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 Tests(ITests):
+class TestSuite(ITestSuite):
     """
     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):
+    def load(
+        base_path: str = 'tests',
+        folder_path: list | str = '*',
+        pattern: str = 'test_*.py'
+    ) -> UnitTestClass:
         """
-        Validate folder configurations and initialize test suite.
+        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
         ----------
-        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
+        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
-            Initialized test suite with added folders
+            An initialized test suite containing the discovered test files.
 
         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 `base_path` is not a string, `folder_path` is not a string or list, or
+            `pattern` is not a string.
         """
-        if not isinstance(folders, list):
-            raise TypeError("folders must be a list")
+        # 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")
 
-        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")
+        # 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()
-        for folder in folders:
+
+        # Add discovered folders to the test suite
+        for folder in discovered_folders:
             tests.addFolder(
-                base_path=folder['base_path'],
-                folder_path=folder['folder_path'],
-                pattern=folder['pattern']
+                base_path=base_path,
+                folder_path=folder,
+                pattern=pattern
             )
-        return tests.run(print_result, throw_exception)
+
+        # Return the initialized test suite
+        return tests

{orionis-0.228.0.dist-info → orionis-0.230.0.dist-info}/METADATA

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

{orionis-0.228.0.dist-info → orionis-0.230.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console.py,sha256=4gYWxf0fWYgJ4RKwARvnTPh06FL3GJ6SAZ7R2NzOICw,1342
-orionis/framework.py,sha256=yvd4Qh0vImy8fXZUPVQya7sgXqCfXJMdu9FsRwpsthQ,1458
+orionis/framework.py,sha256=bi6Li6kcFmefOar93w0po4ec5BGmPG60Ll_AaFeT00c,1458
 orionis/installer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/installer/manager.py,sha256=Li4TVziRXWfum02xNG4JHwbnLk-u8xzHjdqKz-D894k,2755
 orionis/installer/output.py,sha256=7O9qa2xtXMB_4ZvVi-Klneom9YazwygAd_4uYAoxhbU,8548
@@ -39,7 +39,7 @@ orionis/luminate/console/exceptions/cli_exception.py,sha256=HsZ_vSeNiJWQ0gznVFNc
 orionis/luminate/console/exceptions/cli_runtime_error.py,sha256=DaCDGu6mXBk1LIzc7cwRROw1mePAigPNASjNZHhUSBE,1154
 orionis/luminate/console/exceptions/cli_schedule_exception.py,sha256=IBbXb_5zi02pyo1laHdjGn6FYZK7WWRp4j2fkZOCT6I,1161
 orionis/luminate/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/output/console.py,sha256=FuNlI2sjmv14iYM80YQ3jMeUcVaNv0VqBhnfVdFEChA,18209
+orionis/luminate/console/output/console.py,sha256=aVvcGkzetJ66RLet2H5RZ-xidRH_MfJjKX7vSGkjkSg,18926
 orionis/luminate/console/output/executor.py,sha256=-efhCbWOS4ZqmRsO0s3j5NEbw4I9hVROF8Q3Atx77zs,3369
 orionis/luminate/console/output/progress_bar.py,sha256=ZiPGcUaN3EINeLRKgLGtS1GAb1XWlCDx7wFQ7Ff0hqY,3096
 orionis/luminate/console/output/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
@@ -195,16 +195,16 @@ orionis/luminate/support/standard/std.py,sha256=t6dkZxOmSsu3yaIwlvRwdTcV-6KS8lZE
 orionis/luminate/support/standard/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/standard/contracts/std.py,sha256=x9sVir2yg4hve56cCklIdVSr8utruIO_sUdlTNfZ1Ds,3109
 orionis/luminate/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/test/test_case.py,sha256=y3-u3oJtCHLP-DoVW3jan2i96Y78VVdIM1pL7iV0uqU,2508
+orionis/luminate/test/test_case.py,sha256=ghVpBHHnE79kswWjpNNy62XkvKwxrnY-C6DdKZp-0lk,2508
 orionis/luminate/test/test_exception.py,sha256=21PILTXnMuL5-wT3HGKjIklt8VeIYDcQDN346i-BbJw,1336
 orionis/luminate/test/test_result.py,sha256=Px2_M70r_y7BntRITk_h0IPTbSTW5XhDyklMKHm3JJI,999
 orionis/luminate/test/test_status.py,sha256=vNKRmp1lud_ZGTayf3A8wO_0vEYdFABy_oMw-RcEc1c,673
 orionis/luminate/test/test_std_out.py,sha256=rPwXCf3qvMzkZHRCu03KvLCfD4K7cPOB02BZNpXtaiU,2851
-orionis/luminate/test/test_suite.py,sha256=85OvJRZBzpFGxGw-28n0rXWYjbhACs0nZn5t3FHtzcg,2289
+orionis/luminate/test/test_suite.py,sha256=752VbEJHCSe0ztDrBmJlU8FpUg96W4MHnQbHPKpOGqc,3270
 orionis/luminate/test/test_unit.py,sha256=ZTsGlFJ-vwc77sfb7kLDs_sAwJL4L1YP8R9nFUWlgZY,12146
 orionis/luminate/test/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/test/contracts/test_std_out.py,sha256=ryvMotj-rpVKOsyGqW0B0IEHuF8DdQj1Rn0K8xiyBOE,489
-orionis/luminate/test/contracts/test_suite.py,sha256=ieyhZLfC09VfMraskMdWUTUFAD03aaG_8FURWI_d_YQ,1214
+orionis/luminate/test/contracts/test_suite.py,sha256=TOIys-Z1HllUJe-qMY9mOfZGiZPXlKRuAZtJ-B2iDz8,1375
 orionis/luminate/test/contracts/test_unit.py,sha256=3euExuq7QgkJljnENxDyZW-okrw9S0apLnhf93o0Vqg,2612
 orionis/static/ascii/icon.ascii,sha256=IgrlVjcYxcCrr0cJuJkOnEz0aEdAQBTyLzO5ainKsWc,398
 orionis/static/ascii/info.ascii,sha256=HF_o2eXaiw5iqcOhHfnPByn5GJ_O2eBwSK3IpTfYOwY,457
@@ -249,9 +249,9 @@ tests/support/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 tests/support/patterns/test_singleton.py,sha256=U5uwpgGcP7-fIazsnFLwg30mmc24S62udhVIHuL-scY,634
 tests/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/standard/test_std.py,sha256=bJ5LV_OKEEZa_Bk3PTk9Kapk6qECLzcKf0hfR_x2QqM,2042
-orionis-0.228.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.228.0.dist-info/METADATA,sha256=_wFvSjxKzyhc20WErhCgMTt0Hv9o9WpU8Qcsus_2PXk,3003
-orionis-0.228.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.228.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.228.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.228.0.dist-info/RECORD,,
+orionis-0.230.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.230.0.dist-info/METADATA,sha256=jQC8g9qbVXlE1cvFGv96tT8o_55xjFZz12DNC2nXcSI,3003
+orionis-0.230.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.230.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.230.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.230.0.dist-info/RECORD,,