orionis 0.455.0__tar.gz → 0.456.0__tar.gz

{orionis-0.455.0/orionis.egg-info → orionis-0.456.0}/PKG-INFO

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

orionis-0.456.0/orionis/foundation/providers/testing_provider.py

@@ -0,0 +1,77 @@
+from orionis.container.providers.service_provider import ServiceProvider
+from orionis.test.contracts.unit_test import IUnitTest
+from orionis.test.core.unit_test import UnitTest
+
+class TestingProvider(ServiceProvider):
+    """
+    Provides comprehensive unit testing environment services for the Orionis framework.
+
+    This service provider integrates a native unit testing framework into the Orionis
+    application ecosystem, enabling advanced testing capabilities with configurable
+    execution modes, parallel processing, and persistent result storage. The provider
+    registers the testing service as a singleton within the application's dependency
+    injection container, making it available throughout the application lifecycle.
+
+    The TestingProvider handles the complete lifecycle of testing services, from
+    initial configuration and test discovery to storage preparation and service
+    registration. It supports various testing patterns, execution strategies, and
+    reporting mechanisms to accommodate different testing scenarios and requirements.
+
+    Attributes
+    ----------
+    app : Application
+        The Orionis application container instance that manages service registration,
+        configuration access, and dependency injection throughout the framework.
+
+    Notes
+    -----
+    This provider follows the Orionis service provider pattern, implementing both
+    register() and boot() methods to ensure proper service initialization and
+    post-registration setup. The testing service is registered with the interface
+    binding IUnitTest and can be resolved using the alias "x-orionis.test.core.unit_test".
+
+    The provider requires a valid testing configuration section in the application
+    configuration, which should include settings for verbosity, execution mode,
+    worker configuration, and storage paths.
+    """
+
+    def register(self) -> None:
+        """
+        Register and configure the unit testing service in the application container.
+
+        This method loads the testing configuration from the application, instantiates
+        and configures a UnitTest service, and registers it as a singleton in the
+        dependency injection container. The service is bound to the IUnitTest interface
+        and is accessible via the alias "x-orionis.test.core.unit_test".
+
+        The registration process includes:
+            - Retrieving testing configuration from the application settings.
+            - Instantiating the UnitTest service with the appropriate configuration.
+            - Registering the UnitTest service as a singleton in the container.
+            - Binding the service to the IUnitTest interface and alias.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It performs side effects by
+            registering and binding the testing service in the application container.
+        """
+
+        # Register the UnitTest service as a singleton in the application container.
+        # The service is bound to the IUnitTest interface and can be resolved using the alias.
+        self.app.singleton(IUnitTest, UnitTest, alias="x-orionis.test.core.unit_test")
+
+    def boot(self) -> None:
+        """
+        Finalize initialization for the testing provider after service registration.
+
+        This method is called after the registration phase to allow for any additional
+        setup required for the testing environment. In this implementation, no further
+        actions are performed during the boot phase.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        pass

{orionis-0.455.0 → orionis-0.456.0}/orionis/metadata/framework.py

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

{orionis-0.455.0 → orionis-0.456.0}/orionis/test/contracts/unit_test.py

@@ -52,6 +52,60 @@ class IUnitTest(ABC):
         """
         pass
 
+    @abstractmethod
+    def discoverTests(
+        self,
+        base_path: str | Path,
+        folder_path: str | List[str],
+        pattern: str,
+        test_name_pattern: Optional[str] = None,
+        tags: Optional[List[str]] = None
+    ) -> 'IUnitTest':
+        """
+        Discover test cases from specified folders using flexible path discovery.
+
+        This method provides a convenient way to discover and load test cases from multiple folders
+        based on various path specifications. It supports wildcard discovery, single folder loading,
+        and multiple folder loading. The method automatically resolves paths relative to the base
+        directory and discovers all folders containing files matching the specified pattern.
+
+        Parameters
+        ----------
+        base_path : str or Path
+            Base directory path for resolving relative folder paths. This serves as the root
+            directory from which all folder searches are conducted.
+        folder_path : str or list of str
+            Specification of folders to search for test cases. Can be:
+            - '*' : Discover all folders containing matching files within base_path
+            - str : Single folder path relative to base_path
+            - list of str : Multiple folder paths relative to base_path
+        pattern : str
+            File name pattern to match test files, supporting wildcards (* and ?).
+            Examples: 'test_*.py', '*_test.py', 'test*.py'
+        test_name_pattern : str, optional
+            Regular expression pattern to filter test method names. Only tests whose
+            names match this pattern will be included. Default is None (no filtering).
+        tags : list of str, optional
+            List of tags to filter tests. Only tests decorated with matching tags
+            will be included. Default is None (no tag filtering).
+
+        Returns
+        -------
+        UnitTest
+            The current UnitTest instance with discovered tests added to the suite,
+            enabling method chaining.
+
+        Notes
+        -----
+        - All paths are resolved as absolute paths relative to the base_path
+        - When folder_path is '*', the method searches recursively through all subdirectories
+        - The method uses the existing discoverTestsInFolder method for actual test discovery
+        - Duplicate folders are automatically eliminated using a set data structure
+        - The method does not validate the existence of specified folders; validation
+          occurs during the actual test discovery process
+        """
+        pass
+
     @abstractmethod
     def discoverTestsInFolder(
         self,

{orionis-0.455.0 → orionis-0.456.0}/orionis/test/kernel.py

@@ -2,6 +2,7 @@ from orionis.console.output.contracts.console import IConsole
 from orionis.foundation.contracts.application import IApplication
 from orionis.test.contracts.kernel import ITestKernel
 from orionis.test.contracts.unit_test import IUnitTest
+from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.test.exceptions import OrionisTestConfigException, OrionisTestFailureException
 
 class TestKernel(ITestKernel):
@@ -38,8 +39,33 @@ class TestKernel(ITestKernel):
                 f"Failed to initialize TestKernel: expected IApplication, got {type(app).__module__}.{type(app).__name__}."
             )
 
+        # Load testing configuration from application config and create Testing instance
+        config = Testing(**app.config('testing'))
+
         # Resolve the unit test service from the application container
-        self.__unit_test: IUnitTest = app.make('x-orionis.test.core.unit_test')
+        self.__unit_test: IUnitTest = app.make('x-orionis.test.core.unit_test', app)
+
+        # Apply configuration settings to the UnitTest instance
+        self.__unit_test.configure(
+            verbosity=config.verbosity,                 # Set output verbosity level
+            execution_mode=config.execution_mode,       # Configure test execution mode
+            max_workers=config.max_workers,             # Set maximum worker threads for parallel execution
+            fail_fast=config.fail_fast,                 # Enable/disable fail-fast behavior
+            print_result=config.print_result,           # Control result output printing
+            throw_exception=config.throw_exception,     # Configure exception throwing behavior
+            persistent=config.persistent,               # Enable/disable persistent test results
+            persistent_driver=config.persistent_driver, # Set persistent storage driver
+            web_report=config.web_report                # Enable/disable web-based reporting
+        )
+
+        # Discover and load test files based on configuration criteria
+        self.__unit_test.discoverTests(
+            base_path=config.base_path,                 # Root directory for test discovery
+            folder_path=config.folder_path,             # Specific folder path within base_path
+            pattern=config.pattern,                     # File name pattern for test files
+            test_name_pattern=config.test_name_pattern, # Pattern for test method names
+            tags=config.tags                            # Tags to filter tests during discovery
+        )
 
         # Resolve the console service from the application container
         self.__console: IConsole = app.make('x-orionis.console.output.console')

{orionis-0.455.0 → orionis-0.456.0/orionis.egg-info}/PKG-INFO

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

orionis-0.455.0/orionis/foundation/providers/testing_provider.py

@@ -1,125 +0,0 @@
-from orionis.container.providers.service_provider import ServiceProvider
-from orionis.test.contracts.unit_test import IUnitTest
-from orionis.test.core.unit_test import UnitTest
-from orionis.foundation.config.testing.entities.testing import Testing
-import os
-
-class TestingProvider(ServiceProvider):
-    """
-    Provides comprehensive unit testing environment services for the Orionis framework.
-
-    This service provider integrates a native unit testing framework into the Orionis
-    application ecosystem, enabling advanced testing capabilities with configurable
-    execution modes, parallel processing, and persistent result storage. The provider
-    registers the testing service as a singleton within the application's dependency
-    injection container, making it available throughout the application lifecycle.
-
-    The TestingProvider handles the complete lifecycle of testing services, from
-    initial configuration and test discovery to storage preparation and service
-    registration. It supports various testing patterns, execution strategies, and
-    reporting mechanisms to accommodate different testing scenarios and requirements.
-
-    Attributes
-    ----------
-    app : Application
-        The Orionis application container instance that manages service registration,
-        configuration access, and dependency injection throughout the framework.
-
-    Notes
-    -----
-    This provider follows the Orionis service provider pattern, implementing both
-    register() and boot() methods to ensure proper service initialization and
-    post-registration setup. The testing service is registered with the interface
-    binding IUnitTest and can be resolved using the alias "x-orionis.test.core.unit_test".
-
-    The provider requires a valid testing configuration section in the application
-    configuration, which should include settings for verbosity, execution mode,
-    worker configuration, and storage paths.
-    """
-
-    def register(self) -> None:
-        """
-        Register the unit testing service in the application container.
-
-        This method creates and configures a UnitTest instance using the application's
-        testing configuration, discovers test files based on specified patterns and paths,
-        and registers the configured testing service as a singleton in the dependency
-        injection container with the IUnitTest interface binding.
-
-        The registration process includes:
-        - Loading testing configuration from the application config
-        - Creating and configuring a UnitTest instance with various settings
-        - Discovering test files based on configuration parameters
-        - Binding the service to the container with alias "x-orionis.test.core.unit_test"
-
-        Returns
-        -------
-        None
-            This method does not return any value. It performs side effects by
-            registering the testing service in the application container.
-        """
-
-        # Load testing configuration from application config and create Testing instance
-        config = Testing(**self.app.config('testing'))
-
-        # Instantiate the UnitTest implementation with application reference
-        unit_test = UnitTest(
-            app=self.app
-        )
-
-        # Apply configuration settings to the UnitTest instance
-        unit_test.configure(
-            verbosity=config.verbosity,                 # Set output verbosity level
-            execution_mode=config.execution_mode,       # Configure test execution mode
-            max_workers=config.max_workers,             # Set maximum worker threads for parallel execution
-            fail_fast=config.fail_fast,                 # Enable/disable fail-fast behavior
-            print_result=config.print_result,           # Control result output printing
-            throw_exception=config.throw_exception,     # Configure exception throwing behavior
-            persistent=config.persistent,               # Enable/disable persistent test results
-            persistent_driver=config.persistent_driver, # Set persistent storage driver
-            web_report=config.web_report                # Enable/disable web-based reporting
-        )
-
-        # Discover and load test files based on configuration criteria
-        unit_test.discoverTests(
-            base_path=config.base_path,                 # Root directory for test discovery
-            folder_path=config.folder_path,             # Specific folder path within base_path
-            pattern=config.pattern,                     # File name pattern for test files
-            test_name_pattern=config.test_name_pattern, # Pattern for test method names
-            tags=config.tags                            # Tags to filter tests during discovery
-        )
-
-        # Register the configured UnitTest instance in the DI container
-        # Binds IUnitTest interface to the UnitTest implementation as a singleton
-        self.app.instance(IUnitTest, unit_test, alias="x-orionis.test.core.unit_test")
-
-    def boot(self) -> None:
-        """
-        Perform post-registration initialization for the testing provider.
-
-        This method is called after the service registration phase to handle any
-        additional setup required for the testing environment. It ensures that
-        the necessary storage directories for testing operations are created
-        and available before test execution begins.
-
-        The boot process includes:
-        - Creating the testing storage directory if it doesn't exist
-        - Setting appropriate permissions for the storage path
-        - Preparing the filesystem structure for test artifacts
-
-        Returns
-        -------
-        None
-            This method does not return any value. It performs initialization
-            side effects by creating required directories in the filesystem.
-        """
-
-        # Retrieve the configured storage path for testing artifacts and temporary files
-        storage_path = self.app.path('storage_testing')
-
-        # Check if the testing storage directory exists in the filesystem
-        if not os.path.exists(storage_path):
-
-            # Create the directory structure recursively, including parent directories
-            # exist_ok=True prevents errors if directory is created by another process
-            os.makedirs(storage_path, exist_ok=True)