orionis 0.432.0__py3-none-any.whl → 0.435.0__py3-none-any.whl

tests/testing/test_testing_unit.py

@@ -9,22 +9,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testDefaultConfiguration(self) -> None:
         """
-        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.
+        Test that the `UnitTest` class initializes with the correct default configuration values and internal attributes.
 
         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
@@ -34,23 +23,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testConfigureMethod(self) -> None:
         """
-        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.
+        Test that the `configure` method of `UnitTest` updates internal configuration attributes as expected.
 
         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
@@ -79,23 +56,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testFlattenTestSuite(self) -> None:
         """
-        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.
+        Test that the `_flattenTestSuite` method of `UnitTest` flattens nested `TestSuite` instances into a list of test cases.
 
         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
@@ -117,24 +82,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testMergeTestResults(self) -> None:
         """
-        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.
+        Test that the `_mergeTestResults` method of `UnitTest` correctly aggregates results from an individual `TestResult` into a combined `TestResult`.
 
         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
@@ -156,23 +108,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testClearTests(self) -> None:
         """
-        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.
+        Test that the `clearTests` method of `UnitTest` resets the test suite, removing all test cases.
 
         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
@@ -185,24 +125,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testGetTestNames(self) -> None:
         """
-        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.
+        Test that the `getTestNames` method of `UnitTest` returns a list of identifiers for all test cases in the suite.
 
         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
@@ -217,24 +144,11 @@ class TestTestingUnit(AsyncTestCase):
 
     async def testGetTestCount(self) -> None:
         """
-        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.
+        Test that the `getTestCount` method of `UnitTest` returns the correct number of test cases in the suite.
 
         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
@@ -246,4 +160,4 @@ class TestTestingUnit(AsyncTestCase):
         # Retrieve the count of test cases using the method under test
         count = unit_test.getTestCount()
         # Assert that the returned count matches the number of test cases added
-        self.assertEqual(count, 2)
+        self.assertEqual(count, 2)

tests/testing/validators/test_testing_validators.py

@@ -7,16 +7,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidWorkers(self) -> None:
         """
-        Tests the ValidWorkers validator for correct validation of worker counts.
+        Test the ValidWorkers validator for correct worker count validation.
 
-        This method verifies that ValidWorkers accepts valid worker counts within the allowed range,
-        and raises OrionisTestValueError for invalid values such as zero, negative numbers, values
-        exceeding the maximum allowed, and non-integer types.
+        Validates that the ValidWorkers function accepts integer values within the allowed range
+        and raises OrionisTestValueError for invalid values such as zero, negative numbers,
+        values exceeding the maximum, or non-integer types.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         # Get the maximum allowed number of workers from the Workers facade
         max_allowed = Workers.calculate()
@@ -37,20 +36,14 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidBasePath(self) -> None:
         """
-        Tests the ValidBasePath validator for correct validation of base path inputs.
+        Test the ValidBasePath validator for correct base path validation.
 
-        This method checks that ValidBasePath accepts valid path strings and Path objects,
-        returning a pathlib.Path instance. It also verifies that invalid inputs such as empty strings,
-        None, and non-path types raise OrionisTestValueError.
-
-        Parameters
-        ----------
-        None
+        Checks that ValidBasePath accepts valid path strings and Path objects, returning a pathlib.Path instance.
+        Ensures that invalid inputs such as empty strings, None, and non-path types raise OrionisTestValueError.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidBasePath
         from pathlib import Path
@@ -69,20 +62,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidExecutionMode(self) -> None:
         """
-        Tests the ValidExecutionMode validator for correct validation of execution mode inputs.
+        Test the ValidExecutionMode validator for execution mode validation.
 
-        This method verifies that ValidExecutionMode accepts valid execution mode strings and enum values,
-        returning the corresponding string value. It also checks that invalid inputs such as unknown strings
+        Validates that ValidExecutionMode accepts valid execution mode strings and enum values,
+        returning the corresponding string value. Ensures that invalid inputs such as unknown strings
         and non-enum types raise OrionisTestValueError.
 
-        Parameters
-        ----------
-        None
-
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidExecutionMode
         from orionis.foundation.config.testing.enums.mode import ExecutionMode
@@ -99,20 +87,14 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidFailFast(self) -> None:
         """
-        Tests the ValidFailFast validator for correct validation of fail-fast configuration.
+        Test the ValidFailFast validator for fail-fast configuration validation.
 
-        This method verifies that ValidFailFast accepts valid boolean inputs, returning the corresponding
-        boolean value. It also checks that invalid inputs, such as non-boolean types or None, raise
-        OrionisTestValueError.
-
-        Parameters
-        ----------
-        None
+        Ensures that ValidFailFast accepts valid boolean inputs and returns the corresponding
+        boolean value. Raises OrionisTestValueError for non-boolean types or None.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidFailFast
 
@@ -128,16 +110,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidFolderPath(self) -> None:
         """
-        Tests the ValidFolderPath validator for correct validation of folder path inputs.
+        Test the ValidFolderPath validator for folder path validation.
 
-        This method checks that ValidFolderPath accepts valid folder path strings, including those
-        with leading or trailing whitespace, and returns the normalized string path. It also verifies
-        that invalid inputs such as empty strings, None, or non-string types raise OrionisTestValueError.
+        Checks that ValidFolderPath accepts valid folder path strings, including those with whitespace,
+        and returns the normalized string path. Ensures that empty strings, None, or non-string types
+        raise OrionisTestValueError.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidFolderPath
 
@@ -155,20 +136,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidModuleName(self) -> None:
         """
-        Tests the ValidModuleName validator for correct validation of module name inputs.
-
-        This method verifies that ValidModuleName accepts valid non-empty string module names,
-        returning the normalized string value. It also checks that invalid inputs such as empty strings,
-        None, or non-string types raise OrionisTestValueError.
+        Test the ValidModuleName validator for module name validation.
 
-        Parameters
-        ----------
-        None
+        Validates that ValidModuleName accepts valid non-empty string module names and returns
+        the normalized string value. Ensures that empty strings, None, or non-string types
+        raise OrionisTestValueError.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidModuleName
 
@@ -185,20 +161,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidNamePattern(self) -> None:
         """
-        Tests the ValidNamePattern validator for correct validation of name pattern inputs.
-
-        This method verifies that ValidNamePattern accepts valid non-empty string patterns and None,
-        returning the normalized string pattern or None. It also checks that invalid inputs such as
-        empty strings or non-string types raise OrionisTestValueError.
+        Test the ValidNamePattern validator for name pattern validation.
 
-        Parameters
-        ----------
-        None
+        Ensures that ValidNamePattern accepts valid non-empty string patterns and None,
+        returning the normalized string pattern or None. Raises OrionisTestValueError for
+        empty strings or non-string types.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidNamePattern
 
@@ -216,16 +187,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidPattern(self) -> None:
         """
-        Tests the ValidPattern validator for correct validation of pattern string inputs.
+        Test the ValidPattern validator for pattern string validation.
 
-        This method verifies that ValidPattern accepts valid non-empty string patterns,
-        returning the normalized string value. It also checks that invalid inputs such as
-        empty strings, None, or non-string types raise OrionisTestValueError.
+        Validates that ValidPattern accepts valid non-empty string patterns and returns
+        the normalized string value. Ensures that empty strings, None, or non-string types
+        raise OrionisTestValueError.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidPattern
 
@@ -242,20 +212,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidPersistentDriver(self) -> None:
         """
-        Tests the ValidPersistentDriver validator for correct validation of persistent driver inputs.
-
-        This method verifies that ValidPersistentDriver accepts valid persistent driver names as strings
-        and enum values, returning the corresponding normalized string value. It also checks that invalid
-        inputs, such as unknown driver names or non-enum types, raise OrionisTestValueError.
+        Test the ValidPersistentDriver validator for persistent driver validation.
 
-        Parameters
-        ----------
-        None
+        Checks that ValidPersistentDriver accepts valid persistent driver names as strings
+        and enum values, returning the normalized string value. Ensures that unknown driver
+        names or non-enum types raise OrionisTestValueError.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidPersistentDriver
         from orionis.foundation.config.testing.enums.drivers import PersistentDrivers
@@ -272,20 +237,14 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidPersistent(self) -> None:
         """
-        Tests the ValidPersistent validator for correct validation of persistent configuration values.
+        Test the ValidPersistent validator for persistent configuration validation.
 
-        This method verifies that ValidPersistent accepts valid boolean inputs, returning the corresponding
-        boolean value. It also checks that invalid inputs, such as non-boolean types or None, raise
-        OrionisTestValueError.
-
-        Parameters
-        ----------
-        None
+        Validates that ValidPersistent accepts valid boolean inputs and returns the corresponding
+        boolean value. Raises OrionisTestValueError for non-boolean types or None.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidPersistent
 
@@ -301,20 +260,14 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidPrintResult(self) -> None:
         """
-        Tests the ValidPrintResult validator for correct validation of print result configuration.
+        Test the ValidPrintResult validator for print result configuration validation.
 
-        This method verifies that ValidPrintResult accepts valid boolean inputs, returning the corresponding
-        boolean value. It also checks that invalid inputs, such as non-boolean types or None, raise
-        OrionisTestValueError.
-
-        Parameters
-        ----------
-        None
+        Ensures that ValidPrintResult accepts valid boolean inputs and returns the corresponding
+        boolean value. Raises OrionisTestValueError for non-boolean types or None.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidPrintResult
 
@@ -330,17 +283,16 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidTags(self) -> None:
         """
-        Tests the ValidTags validator for correct validation of tag list inputs.
+        Test the ValidTags validator for tag list validation.
 
-        This method verifies that ValidTags accepts a list of non-empty string tags, normalizes whitespace,
-        and returns a list of cleaned tag strings. It also checks that None is accepted and returns None.
-        Invalid cases, such as empty lists, lists containing empty strings or non-string types, and non-list
-        inputs, should raise OrionisTestValueError.
+        Validates that ValidTags accepts a list of non-empty string tags, normalizes whitespace,
+        and returns a list of cleaned tag strings. Accepts None and returns None. Raises
+        OrionisTestValueError for empty lists, lists with empty strings or non-string types,
+        and non-list inputs.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidTags
 
@@ -368,20 +320,14 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidThrowException(self) -> None:
         """
-        Tests the ValidThrowException validator for correct validation of throw exception configuration.
+        Test the ValidThrowException validator for throw exception configuration validation.
 
-        This method verifies that ValidThrowException accepts valid boolean inputs, returning the corresponding
-        boolean value. It also checks that invalid inputs, such as non-boolean types or None, raise
-        OrionisTestValueError.
-
-        Parameters
-        ----------
-        None
+        Ensures that ValidThrowException accepts valid boolean inputs and returns the corresponding
+        boolean value. Raises OrionisTestValueError for non-boolean types or None.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidThrowException
 
@@ -397,16 +343,15 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidVerbosity(self) -> None:
         """
-        Tests the ValidVerbosity validator for correct validation of verbosity mode inputs.
+        Test the ValidVerbosity validator for verbosity mode validation.
 
-        This method verifies that ValidVerbosity accepts valid verbosity mode enum values and their corresponding
-        integer values, returning the normalized integer value. It also checks that invalid inputs such as
-        negative values, unknown integers, or non-integer types raise OrionisTestValueError.
+        Validates that ValidVerbosity accepts valid verbosity mode enum values and their corresponding
+        integer values, returning the normalized integer value. Ensures that negative values, unknown
+        integers, or non-integer types raise OrionisTestValueError.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidVerbosity
         from orionis.foundation.config.testing.enums.verbosity import VerbosityMode
@@ -425,16 +370,14 @@ class TestTestingDumper(AsyncTestCase):
 
     async def testValidWebReport(self) -> None:
         """
-        Tests the ValidWebReport validator for correct validation of web report configuration.
+        Test the ValidWebReport validator for web report configuration validation.
 
-        This method verifies that ValidWebReport accepts valid boolean inputs, returning the corresponding
-        boolean value. It also checks that invalid inputs, such as non-boolean types or None, raise
-        OrionisTestValueError.
+        Ensures that ValidWebReport accepts valid boolean inputs and returns the corresponding
+        boolean value. Raises OrionisTestValueError for non-boolean types or None.
 
         Returns
         -------
         None
-            This method does not return any value. It asserts expected behavior using test assertions.
         """
         from orionis.test.validators import ValidWebReport
 
@@ -446,4 +389,4 @@ class TestTestingDumper(AsyncTestCase):
         with self.assertRaises(OrionisTestValueError):
             ValidWebReport("not_bool")
         with self.assertRaises(OrionisTestValueError):
-            ValidWebReport(None)
+            ValidWebReport(None)

tests/testing/view/test_render.py

@@ -5,16 +5,15 @@ class TestTestingRender(AsyncTestCase):
 
     async def testMethodsExist(self):
         """
-        Checks if the required methods exist in the TestingResultRender class.
+        Test that required methods exist in the TestingResultRender class.
 
-        This test verifies the presence of specific methods in the TestingResultRender class
-        and asserts that each required method exists. It is important for ensuring that the
-        class interface meets expectations.
+        This asynchronous test checks whether the specified methods are present
+        in the TestingResultRender class by asserting their existence using hasattr.
 
         Returns
         -------
         None
-            This method does not return any value. It performs assertions to validate method existence.
+            This method does not return any value.
         """
         # List of method names that must exist in TestingResultRender
         required_methods = [