orionis 0.416.0__py3-none-any.whl → 0.417.0__py3-none-any.whl

orionis/metadata/framework.py

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

{orionis-0.416.0.dist-info → orionis-0.417.0.dist-info}/METADATA

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

{orionis-0.416.0.dist-info → orionis-0.417.0.dist-info}/RECORD

@@ -313,7 +313,7 @@ orionis/foundation/providers/progress_bar_provider.py,sha256=WW3grNgH-yV2meSSTeO
 orionis/foundation/providers/testing_provider.py,sha256=iJSN2RIChbYIL-1ue6vmPmDMCSrvERDkti4Er9MPiLA,1102
 orionis/foundation/providers/workers_provider.py,sha256=kiQjQRyUEyiBX2zcbF_KmqRgvc7Bvxsvg5oMtIvYniM,1075
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=UK4GTjXKviZ1FEBPKSAIcGyD7a5qsQ44cEuJFT07ulg,4960
+orionis/metadata/framework.py,sha256=mgSuf0lS1a_bBnjhqeXaV2Y7ZfnUu4h2gWcRaoYMTmI,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -483,7 +483,7 @@ orionis/test/validators/web_report.py,sha256=-h3Fe9jY93_kzUhd2NBIqEfCcBpu-8Ei9x3
 orionis/test/validators/workers.py,sha256=LGffDKtK6SKixFKzIYPQpI5aFeQPAGXpv_LUtmEu6g4,1102
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=3ICz68l-WF3BtnYqH5m-ktN9UD00MELMbmMnyJDV74A,4768
-orionis-0.416.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.417.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/test_container.py,sha256=asv8TkkupVoex6SWod74NBl4dSs7wb9mLmu_glNdNy8,14815
@@ -558,7 +558,7 @@ tests/support/standard/test_services_std.py,sha256=U0hNF50YE4aLE3Z9yWB2awl9owFQR
 tests/support/wrapper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/wrapper/test_services_wrapper_docdict.py,sha256=Q_qyqZodLiTQ6Pv9zILfIoZj6l-WPzNWuIoRf1GTGY0,7535
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/testing/test_testing_unit.py,sha256=ZZM6RKxxg4TjANG3_Dy7aQpV60atQbCcSTlOdJZiDIs,4704
+tests/testing/test_testing_unit.py,sha256=Y7CBIs8n7GO_Grd9XLNz0BDT5ULSEbKK1zOUWkp3Vio,10207
 tests/testing/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/cases/test_testing_asynchronous.py,sha256=gBcUyx1gmhulC-51BLtJOCwQOK6EMBaUws8eG8nxYOs,2218
 tests/testing/cases/test_testing_synchronous.py,sha256=n7btUA-2cXPx-HLRfyI7YtVuJvcSuYVC-z843SktPCk,2427
@@ -573,8 +573,8 @@ tests/testing/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 tests/testing/records/test_testing_records.py,sha256=1MY5bCzY9yapjlOPB8t2SJz63V2_iGczqTmtnyHpnlE,6446
 tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/validators/test_testing_validators.py,sha256=QdcF0Vhnnl_kD-PzceHJbUYOqwPTB1Td7YaTv8LTr30,19612
-orionis-0.416.0.dist-info/METADATA,sha256=Kth-ref5_qVq92ry-jE9veJzuSPOiTcYhp3oalo9Hhw,4772
-orionis-0.416.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.416.0.dist-info/top_level.txt,sha256=nkPWzvqkAzAmwPMPo3_iiUgzWMFOGfz6hVwdASslEGE,37
-orionis-0.416.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.416.0.dist-info/RECORD,,
+orionis-0.417.0.dist-info/METADATA,sha256=XLg_D-73TO_1-kXgtzAsdiwUPMvcOcRLbdK8rl3a1BA,4772
+orionis-0.417.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.417.0.dist-info/top_level.txt,sha256=nkPWzvqkAzAmwPMPo3_iiUgzWMFOGfz6hVwdASslEGE,37
+orionis-0.417.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.417.0.dist-info/RECORD,,

tests/testing/test_testing_unit.py

@@ -9,17 +9,51 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testDefaultConfiguration(self) -> None:
         """
-        Test that the `UnitTest` class initializes with correct default configuration values.
+        Tests the initialization of the `UnitTest` class to ensure it sets up
+        the default configuration values and internal attributes correctly.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Verifies that the loader and suite attributes are instances of their expected classes.
         """
         unit_test = UnitTest()
+        # Assert that the loader is correctly initialized as a TestLoader
         self.assertIsInstance(unit_test._UnitTest__loader, unittest.TestLoader)
+        # Assert that the suite is correctly initialized as a TestSuite
         self.assertIsInstance(unit_test._UnitTest__suite, unittest.TestSuite)
 
     async def testConfigureMethod(self) -> None:
         """
-        Tests the `configure` method of the `UnitTest` class for correct configuration updates.
+        Tests the `configure` method of the `UnitTest` class to ensure it correctly updates
+        the internal configuration attributes based on the provided arguments.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        - Verifies that each configuration parameter is set to the expected value.
+        - Ensures the `configure` method returns the same `UnitTest` instance for chaining.
         """
         unit_test = UnitTest()
+        # Configure the UnitTest instance with custom parameters
         configured = unit_test.configure(
             verbosity=1,
             execution_mode=ExecutionMode.PARALLEL,
@@ -31,6 +65,7 @@ class TestTestingUnit(AsyncTestCase):
             persistent_driver=PersistentDrivers.JSON,
             web_report=False
         )
+        # Assert that each internal attribute matches the configured value
         self.assertEqual(unit_test._UnitTest__verbosity, 1)
         self.assertEqual(unit_test._UnitTest__execution_mode, ExecutionMode.PARALLEL.value)
         self.assertEqual(unit_test._UnitTest__max_workers, 8)
@@ -39,31 +74,72 @@ class TestTestingUnit(AsyncTestCase):
         self.assertFalse(unit_test._UnitTest__persistent)
         self.assertEqual(unit_test._UnitTest__persistent_driver, PersistentDrivers.JSON.value)
         self.assertFalse(unit_test._UnitTest__web_report)
+        # Ensure the configure method returns the same instance for chaining
         self.assertIs(configured, unit_test)
 
     async def testFlattenTestSuite(self) -> None:
         """
-        Tests the `_flattenTestSuite` method of the `UnitTest` class for correct flattening of nested test suites.
+        Tests the `_flattenTestSuite` method of the `UnitTest` class to ensure it correctly flattens
+        nested `TestSuite` instances into a single list of test cases.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        - Verifies that all test cases within nested suites are extracted and returned in a flat list.
+        - Ensures that the flattened list contains all individual test cases from the nested structure.
         """
         unit_test = UnitTest()
+        # Create mock test cases
         test_case1 = MagicMock()
         test_case2 = MagicMock()
+        # Create a nested TestSuite containing the mock test cases
         nested_suite = unittest.TestSuite()
         nested_suite.addTest(test_case1)
         nested_suite.addTest(test_case2)
+        # Create the main TestSuite and add the nested suite to it
         main_suite = unittest.TestSuite()
         main_suite.addTest(nested_suite)
+        # Flatten the main suite using the method under test
         flattened = unit_test._UnitTest__flattenTestSuite(main_suite)
+        # Assert that the flattened list contains both test cases
         self.assertEqual(len(flattened), 2)
         self.assertIn(test_case1, flattened)
         self.assertIn(test_case2, flattened)
 
     async def testMergeTestResults(self) -> None:
         """
-        Tests the `_mergeTestResults` method of the `UnitTest` class for correct aggregation of test results.
+        Tests the `_mergeTestResults` method of the `UnitTest` class to ensure it correctly aggregates
+        the results from an individual `TestResult` into a combined `TestResult`.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        - Verifies that the number of tests run, failures, and errors are correctly merged.
+        - Ensures that skipped, expected failures, and unexpected successes are also handled.
+        - The method under test does not return a value; it modifies the `combined` result in place.
         """
         unit_test = UnitTest()
+        # Create a combined TestResult to aggregate results into
         combined = unittest.TestResult()
+        # Create an individual TestResult with sample data
         individual = unittest.TestResult()
         individual.testsRun = 2
         individual.failures = [('test1', 'failure')]
@@ -71,40 +147,103 @@ class TestTestingUnit(AsyncTestCase):
         individual.skipped = []
         individual.expectedFailures = []
         individual.unexpectedSuccesses = []
+        # Merge the individual results into the combined result
         unit_test._UnitTest__mergeTestResults(combined, individual)
+        # Assert that the combined result reflects the merged data
         self.assertEqual(combined.testsRun, 2)
         self.assertEqual(len(combined.failures), 1)
         self.assertEqual(len(combined.errors), 1)
 
     async def testClearTests(self) -> None:
         """
-        Tests the `clearTests` method of the `UnitTest` class to ensure it properly resets the test suite.
+        Tests the `clearTests` method of the `UnitTest` class to verify that it correctly resets the test suite,
+        removing all previously added test cases and leaving the suite empty.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        - Ensures that after calling `clearTests`, the internal test suite contains no test cases.
+        - Validates that the suite is properly cleared regardless of its previous state.
         """
         unit_test = UnitTest()
+        # Add a mock test case to the suite
         mock_test = MagicMock()
         unit_test._UnitTest__suite.addTest(mock_test)
+        # Clear all tests from the suite
         unit_test.clearTests()
+        # Assert that the suite is now empty
         self.assertEqual(len(unit_test._UnitTest__suite._tests), 0)
 
     async def testGetTestNames(self) -> None:
         """
-        Tests the `getTestNames` method of the `UnitTest` class for correct extraction of test identifiers.
+        Tests the `getTestNames` method of the `UnitTest` class to ensure it accurately retrieves
+        the identifiers of all test cases present in the internal test suite.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        - Verifies that the method returns a list of test identifiers corresponding to each test case in the suite.
+        - Ensures that the returned list contains the expected test IDs as provided by the test case's `id()` method.
+        - The expected return value of `getTestNames` is a list of strings, where each string is the identifier of a test case.
         """
         unit_test = UnitTest()
+        # Create a mock test case and set its id() method to return a specific identifier
         mock_test = MagicMock()
         mock_test.id.return_value = 'test_id'
+        # Add the mock test case to the UnitTest's internal suite
         unit_test._UnitTest__suite.addTest(mock_test)
+        # Retrieve the list of test names using the method under test
         names = unit_test.getTestNames()
+        # Assert that the returned list contains the expected test identifier
         self.assertEqual(names, ['test_id'])
 
     async def testGetTestCount(self) -> None:
         """
-        Tests the `getTestCount` method of the `UnitTest` class for accurate test counting.
+        Tests the `getTestCount` method of the `UnitTest` class to ensure it accurately returns
+        the total number of test cases present in the internal test suite.
+
+        Parameters
+        ----------
+        self : TestTestingUnit
+            The test case instance.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        - Verifies that the method returns the correct count of test cases added to the suite.
+        - Ensures that the count matches the number of test cases present in the suite at the time of invocation.
+        - The expected return value of `getTestCount` is an integer representing the number of test cases in the suite.
         """
         unit_test = UnitTest()
+        # Create two mock test cases
         mock_test1 = MagicMock()
         mock_test2 = MagicMock()
+        # Add the mock test cases to the UnitTest's internal suite
         unit_test._UnitTest__suite.addTest(mock_test1)
         unit_test._UnitTest__suite.addTest(mock_test2)
+        # Retrieve the count of test cases using the method under test
         count = unit_test.getTestCount()
-        self.assertEqual(count, 2)
+        # Assert that the returned count matches the number of test cases added
+        self.assertEqual(count, 2)