orionis 0.380.0__tar.gz → 0.382.0__tar.gz

{orionis-0.380.0/orionis.egg-info → orionis-0.382.0}/PKG-INFO

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

{orionis-0.380.0 → orionis-0.382.0}/orionis/container/contracts/resolver.py

@@ -1,7 +1,8 @@
 from abc import ABC, abstractmethod
-from typing import Any
+from typing import Any, Callable
 from orionis.container.contracts.container import IContainer
 from orionis.container.entities.binding import Binding
+from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 
 class IResolver(ABC):
     """
@@ -55,4 +56,60 @@ class IResolver(ABC):
         OrionisContainerException
             If the binding is not an instance of Binding or if resolution fails.
         """
+        pass
+
+    @abstractmethod
+    def resolveType(
+        self,
+        type_: Callable[..., Any],
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Forces resolution of a type whether it's registered in the container or not.
+
+        Parameters
+        ----------
+        type_ : Callable[..., Any]
+            The type or callable to resolve.
+        *args : tuple
+            Positional arguments to pass to the constructor/callable.
+        **kwargs : dict
+            Keyword arguments to pass to the constructor/callable.
+
+        Returns
+        -------
+        Any
+            The resolved instance.
+
+        Raises
+        ------
+        OrionisContainerException
+            If the type cannot be resolved.
+        """
+        pass
+
+    @abstractmethod
+    def resolveSignature(
+        self,
+        signature: MethodDependency
+    ) -> dict:
+        """
+        Resolves dependencies defined in a method signature.
+
+        Parameters
+        ----------
+        signature : MethodDependency
+            The method dependency information to resolve.
+
+        Returns
+        -------
+        dict
+            A dictionary of resolved parameter values.
+
+        Raises
+        ------
+        OrionisContainerException
+            If any dependencies cannot be resolved.
+        """
         pass

{orionis-0.380.0 → orionis-0.382.0}/orionis/container/resolver/resolver.py

@@ -8,6 +8,7 @@ from orionis.container.exceptions import OrionisContainerException
 from orionis.services.introspection.callables.reflection import ReflectionCallable
 from orionis.services.introspection.concretes.reflection import ReflectionConcrete
 from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
+from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 
 class Resolver(IResolver):
     """
@@ -65,6 +66,146 @@ class Resolver(IResolver):
         elif binding.lifetime == Lifetime.SCOPED:
             return self.__resolveScoped(binding, *args, **kwargs)
 
+    def resolveType(
+        self,
+        type_: Callable[..., Any],
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Forces resolution of a type whether it's registered in the container or not.
+
+        Parameters
+        ----------
+        type_ : Callable[..., Any]
+            The type or callable to resolve.
+        *args : tuple
+            Positional arguments to pass to the constructor/callable.
+        **kwargs : dict
+            Keyword arguments to pass to the constructor/callable.
+
+        Returns
+        -------
+        Any
+            The resolved instance.
+
+        Raises
+        ------
+        OrionisContainerException
+            If the type cannot be resolved.
+        """
+
+        # Try to resolve the type with the provided arguments
+        # If the type is already bound in the container, resolve it directly
+        # or if args or kwargs are provided, instantiate it directly
+        # If the type is a concrete class, instantiate it with resolved dependencies
+        try:
+
+            # Check if the type is already bound in the container
+            if self.container.bound(type_):
+                binding = self.container.getBinding(type_)
+                return self.resolve(binding, *args, **kwargs)
+
+            # If args or kwargs are provided, use them directly
+            if args or kwargs:
+
+                # For classes
+                if isinstance(type_, type):
+                    return type_(*args, **kwargs)
+
+                # For callables
+                elif callable(type_):
+                    return type_(*args, **kwargs)
+
+            # Otherwise use reflection to resolve dependencies
+            # If the type is a concrete class, instantiate it with resolved dependencies
+            elif ReflectionConcrete.isConcreteClass(type_):
+                return type_(**self.__resolveDependencies(type_, is_class=True))
+
+            # Try to call directly if it's a callable
+            elif callable(type_) and not isinstance(type_, type):
+                return type_(**self.__resolveDependencies(type_, is_class=False))
+
+            # If the type is neither a concrete class nor a callable, raise an exception
+            raise OrionisContainerException(
+                f"Cannot force resolve: {getattr(type_, '__name__', str(type_))} is neither a concrete class nor a callable."
+            )
+
+        except Exception as e:
+
+            # Get the type name safely to avoid AttributeError
+            type_name = getattr(type_, '__name__', str(type_))
+            module_name = getattr(type_, '__module__', "unknown module")
+
+            # Provide more detailed error message
+            error_msg = f"Error while force-resolving '{type_name}' from '{module_name}':\n{str(e)}"
+
+            # If it's already an OrionisContainerException, just re-raise it with the context
+            if isinstance(e, OrionisContainerException):
+                raise e from None
+
+            # Raise a new OrionisContainerException with the original exception as context
+            else:
+                raise OrionisContainerException(error_msg) from e
+
+    def resolveSignature(
+        self,
+        signature: MethodDependency
+    ) -> dict:
+        """
+        Resolves dependencies defined in a method signature.
+
+        Parameters
+        ----------
+        signature : MethodDependency
+            The method dependency information to resolve.
+
+        Returns
+        -------
+        dict
+            A dictionary of resolved parameter values.
+
+        Raises
+        ------
+        OrionisContainerException
+            If any dependencies cannot be resolved.
+        """
+        # If no dependencies to resolve, return empty dict
+        if not signature.resolved and not signature.unresolved:
+            return {}
+
+        # If there are unresolved dependencies, raise an error
+        if signature.unresolved:
+            raise OrionisContainerException(
+                f"Cannot resolve method dependencies because the following parameters are unresolved: {', '.join(signature.unresolved)}."
+            )
+
+        # Create a dict of resolved dependencies
+        params = {}
+        for param_name, dep in signature.resolved.items():
+            if isinstance(dep, KnownDependency):
+                # Try to resolve the dependency using the container
+                if self.container.bound(dep.type):
+                    params[param_name] = self.resolve(
+                        self.container.getBinding(dep.type)
+                    )
+                elif self.container.bound(dep.full_class_path):
+                    params[param_name] = self.resolve(
+                        self.container.getBinding(dep.full_class_path)
+                    )
+                # Try to resolve directly if it's a concrete type
+                elif ReflectionConcrete.isConcreteClass(dep.type):
+                    params[param_name] = self.resolveType(dep.type)
+                else:
+                    raise OrionisContainerException(
+                        f"Cannot resolve dependency '{param_name}' of type '{dep.type.__name__}'."
+                    )
+            else:
+                # Use default value
+                params[param_name] = dep
+
+        return params
+
     def __resolveTransient(self, binding: Binding, *args, **kwargs) -> Any:
         """
         Resolves a service with transient lifetime.

{orionis-0.380.0 → orionis-0.382.0}/orionis/metadata/framework.py

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

{orionis-0.380.0 → orionis-0.382.0}/orionis/services/paths/contracts/resolver.py

@@ -7,19 +7,7 @@ class IResolver(ABC):
     """
 
     @abstractmethod
-    def __init__(self, root_path: Optional[str] = None):
-        """
-        Initializes the resolver with an optional root path.
-
-        Parameters
-        ----------
-        root_path : str, optional
-            The root directory to resolve relative paths from.
-        """
-        pass
-
-    @abstractmethod
-    def relativePath(self, relative_path: str):
+    def relativePath(self, relative_path: str) -> 'IResolver':
         """
         Resolves a relative path into an absolute one and validates its existence.
 

{orionis-0.380.0 → orionis-0.382.0}/orionis/test/core/unit_test.py

@@ -12,9 +12,7 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple
 from orionis.container.resolver.resolver import Resolver
 from orionis.foundation.contracts.application import IApplication
-from orionis.services.introspection.concretes.reflection import ReflectionConcrete
 from orionis.services.introspection.instances.reflection import ReflectionInstance
-from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
 from orionis.services.system.workers import Workers
 from orionis.test.entities.result import TestResult
 from orionis.test.enums import (
@@ -667,26 +665,35 @@ class UnitTest(IUnitTest):
         # Return the result along with captured output and error streams
         return result, output_buffer, error_buffer
 
-    def __runTestsSequentially(
-        self,
-        output_buffer: io.StringIO,
-        error_buffer: io.StringIO
-    ) -> unittest.TestResult:
+    def __resolveFlattenedTestSuite(
+        self
+    ) -> unittest.TestSuite:
         """
-        Executes the test suite sequentially, capturing the output and error streams.
+        Resolves dependencies for all test cases in the suite and creates a flattened test suite with injected dependencies.
+
+        Processes each test case, identifies dependencies in test method signatures, and resolves
+        them using the application's dependency resolver. Creates wrapper methods that automatically
+        inject the resolved dependencies when tests are executed.
 
         Parameters
         ----------
-        output_buffer : io.StringIO
-            A buffer to capture the standard output during test execution.
-        error_buffer : io.StringIO
-            A buffer to capture the standard error during test execution.
+        None
 
         Returns
         -------
-        unittest.TestResult
-            The result of the test suite execution, containing information about
-            passed, failed, and skipped tests.
+        unittest.TestSuite
+            A new test suite with all tests having their dependencies resolved and injected.
+
+        Raises
+        ------
+        OrionisTestValueError
+            If any test method has dependencies that cannot be resolved.
+
+        Notes
+        -----
+        - Test methods with decorators are left as-is
+        - Test methods without dependencies are added directly
+        - Test methods with unresolved dependencies trigger an error
         """
 
         # Create a new test suite with tests that have their dependencies resolved
@@ -746,49 +753,7 @@ class UnitTest(IUnitTest):
             original_method = getattr(test_class, method_name)
 
             # Create a dict of resolved dependencies
-            params = {}
-            resolve = Resolver(self.app)
-            for key, value in signature.resolved.items():
-
-                # If the dependency is a KnownDependency, resolve it
-                if isinstance(value, KnownDependency):
-
-                    # If the dependency is a built-in type, raise an exception
-                    if value.module_name == 'builtins':
-                        raise OrionisTestValueError(
-                            f"Cannot resolve built-in type '{value.type.__name__}' for dependency '{key}' in test method '{method_name}'. "
-                            "Built-in types cannot be resolved by the container."
-                        )
-
-                    # Try to resolve from container using type (Abstract or Interface)
-                    if self.app.bound(value.type):
-                        params[key] = resolve.resolve(
-                            self.app.getBinding(value.type)
-                        )
-
-                    # Try to resolve from container using full class path
-                    elif self.app.bound(value.full_class_path):
-                        params[key] = resolve.resolve(
-                            self.app.getBinding(value.full_class_path)
-                        )
-
-                    # Try to instantiate directly if it's a concrete class
-                    elif ReflectionConcrete.isConcreteClass(value.type):
-                        params[key] = value.type(**resolve._Resolver__resolveDependencies(value.type, is_class=True))
-
-                    # Try to call directly if it's a callable
-                    elif callable(value.type) and not isinstance(value.type, type):
-                        params[key] = value.type(**self._Resolver__resolveDependencies(value.type, is_class=False))
-
-                    # If the dependency cannot be resolved, raise an exception
-                    else:
-                        raise OrionisTestValueError(
-                            f"Cannot resolve dependency '{key}' of type '{value.type.__name__}' in test method '{method_name}'. "
-                            "Ensure that the dependency is bound in the container or is a concrete class."
-                        )
-                else:
-                    # Use default value
-                    params[key] = value
+            params = Resolver(self.app).resolveSignature(signature)
 
             # Create a wrapper method that injects dependencies
             def create_test_wrapper(original_test, resolved_args:dict):
@@ -803,6 +768,31 @@ class UnitTest(IUnitTest):
             # Add the modified test case to the suite
             flattened_suite.addTest(test_case)
 
+        # Return the flattened suite with resolved dependencies
+        return flattened_suite
+
+    def __runTestsSequentially(
+        self,
+        output_buffer: io.StringIO,
+        error_buffer: io.StringIO
+    ) -> unittest.TestResult:
+        """
+        Executes the test suite sequentially, capturing the output and error streams.
+
+        Parameters
+        ----------
+        output_buffer : io.StringIO
+            A buffer to capture the standard output during test execution.
+        error_buffer : io.StringIO
+            A buffer to capture the standard error during test execution.
+
+        Returns
+        -------
+        unittest.TestResult
+            The result of the test suite execution, containing information about
+            passed, failed, and skipped tests.
+        """
+
         # Create a custom result class to capture detailed test results
         with redirect_stdout(output_buffer), redirect_stderr(error_buffer):
             runner = unittest.TextTestRunner(
@@ -811,7 +801,7 @@ class UnitTest(IUnitTest):
                 failfast=self.fail_fast,
                 resultclass=self.__customResultClass()
             )
-            result = runner.run(flattened_suite)
+            result = runner.run(self.__resolveFlattenedTestSuite())
 
         # Return the result object containing test outcomes
         return result
@@ -845,7 +835,7 @@ class UnitTest(IUnitTest):
         """
 
         # Flatten the test suite to get individual test cases
-        test_cases = list(self.__flattenTestSuite(self.suite))
+        test_cases = list(self.__resolveFlattenedTestSuite())
 
         # Create a custom result instance to collect all results
         result_class = self.__customResultClass()

{orionis-0.380.0 → orionis-0.382.0}/orionis/test/kernel.py

@@ -277,10 +277,7 @@ class TestKernel(ITestKernel):
             throw_exception = bool(args.throw_exception),
             persistent = bool(args.persistent),
             persistent_driver = str(args.persistent_driver) if args.persistent_driver else None,
-            web_report = bool(args.web_report),
-            folder_path=[
-                'example'
-            ]
+            web_report = bool(args.web_report)
         )
 
         # If requested, print the output buffer

{orionis-0.380.0 → orionis-0.382.0/orionis.egg-info}/PKG-INFO

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

orionis-0.382.0/tests/example/test_example.py

@@ -0,0 +1,33 @@
+from orionis.services.paths.contracts.resolver import IResolver
+from orionis.test.cases.synchronous import SyncTestCase
+
+class TestExample(SyncTestCase):
+
+    def testUnitExample(self, paths:IResolver) -> None:
+        """
+        Unit test example function.
+
+        This method demonstrates basic unit testing functionality using assertions.
+        It checks simple equality conditions and verifies path resolution through
+        the injected paths service.
+
+        Parameters
+        ----------
+        paths : IResolver
+            Service for resolving paths within the application.
+
+        Returns
+        -------
+        None
+            This test method doesn't return anything.
+        """
+
+        # Check if 1 equals 1
+        self.assertEqual(2, 2)
+
+        # Check if 2 equals 2
+        self.assertEqual(3, 3)
+
+        # Inyect the paths service to resolve a relative path
+        path = paths.relativePath("tests/example/test_example.py").toString()
+        self.assertTrue(path.endswith("test_example.py"))

orionis-0.380.0/tests/example/test_example.py

@@ -1,28 +0,0 @@
-from unittest.mock import patch
-from orionis.console.output.console import Console
-from orionis.console.output.contracts.console import IConsole
-from orionis.test.cases.synchronous import SyncTestCase
-
-class TestExample(SyncTestCase):
-    """
-    Unit tests for basic example functionality.
-    """
-
-    # @patch('orionis.console.output.contracts.console.IConsole', autospec=True)
-    # @patch('orionis.console.output.contracts.console.IConsole', autospec=True)
-    def testUnitExample(self, cos:Console) -> None:
-        """
-        Test that basic equality assertions work as expected.
-
-        Asserts
-        -------
-        1 == 1 : bool
-            Ensures that the integer 1 is equal to itself.
-        2 == 2 : bool
-            Ensures that the integer 2 is equal to itself.
-        """
-        # Check if 1 equals 1
-        self.assertEqual(2, 2)
-
-        # Check if 2 equals 2
-        self.assertEqual(3, 3)