orionis 0.362.0__py3-none-any.whl → 0.363.0__py3-none-any.whl

orionis/console/output/console.py

@@ -4,7 +4,7 @@ import os
 import sys
 from orionis.console.output.styles import ANSIColors
 from orionis._contracts.console.output.console import IConsole
-from orionis.services.parsers.serializer import Parser
+from orionis.services.formatter.serializer import Parser
 
 class Console(IConsole):
     """

orionis/container/container.py

@@ -15,8 +15,8 @@ from orionis.container.validators.is_not_subclass import IsNotSubclass
 from orionis.container.validators.is_subclass import IsSubclass
 from orionis.container.validators.is_valid_alias import IsValidAlias
 from orionis.container.validators.lifetime import LifetimeValidator
-from orionis.services.introspection.abstract.reflection_abstract import ReflectionAbstract
-from orionis.services.introspection.callables.reflection_callable import ReflectionCallable
+from orionis.services.introspection.abstract.reflection import ReflectionAbstract
+from orionis.services.introspection.callables.reflection import ReflectionCallable
 
 class Container(IContainer):
 

orionis/container/resolver/resolver.py

@@ -4,8 +4,8 @@ from orionis.container.contracts.container import IContainer
 from orionis.container.entities.binding import Binding
 from orionis.container.enums.lifetimes import Lifetime
 from orionis.container.exceptions import OrionisContainerException
-from orionis.services.introspection.callables.reflection_callable import ReflectionCallable
-from orionis.services.introspection.concretes.reflection_concrete import ReflectionConcrete
+from orionis.services.introspection.callables.reflection import ReflectionCallable
+from orionis.services.introspection.concretes.reflection import ReflectionConcrete
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
 
 class Resolver:

orionis/container/validators/implements.py

@@ -1,5 +1,5 @@
 from typing import Callable, Any
-from orionis.services.introspection.inspection import Inspection
+from orionis.services.introspection.objects.types import Type
 from orionis.container.exceptions import OrionisContainerException
 
 class __ImplementsAbstractMethods:
@@ -50,7 +50,7 @@ class __ImplementsAbstractMethods:
             raise OrionisContainerException("Either concrete class or instance must be provided for implementation check.")
 
         # Validate that the target is a class or instance
-        target_class = target if Inspection(target).isClass() else target.__class__
+        target_class = target if Type(target).isClass() else target.__class__
         target_name = target_class.__name__
         abstract_name = abstract.__name__
 

orionis/container/validators/is_abstract_class.py

@@ -1,5 +1,5 @@
 from typing import Callable, Any
-from orionis.services.introspection.abstract.reflection_abstract import ReflectionAbstract
+from orionis.services.introspection.abstract.reflection import ReflectionAbstract
 from orionis.container.exceptions import OrionisContainerTypeError
 
 class __IsAbstractClass:

orionis/container/validators/is_concrete_class.py

@@ -1,5 +1,5 @@
 from typing import Callable, Any
-from orionis.services.introspection.concretes.reflection_concrete import ReflectionConcrete
+from orionis.services.introspection.concretes.reflection import ReflectionConcrete
 from orionis.container.exceptions import OrionisContainerTypeError
 
 class __IsConcreteClass:

orionis/container/validators/is_instance.py

@@ -1,5 +1,5 @@
 from typing import Any
-from orionis.services.introspection.instances.reflection_instance import ReflectionInstance
+from orionis.services.introspection.instances.reflection import ReflectionInstance
 from orionis.container.exceptions import OrionisContainerTypeError
 
 class __IsInstance:

orionis/foundation/config/testing/entities/testing.py

@@ -2,7 +2,7 @@ from dataclasses import asdict, dataclass, field, fields
 from typing import List
 from orionis.foundation.exceptions import OrionisIntegrityException
 from orionis.services.system.workers import Workers
-from orionis.test.enums.test_mode import ExecutionMode
+from orionis.test.enums.execution_mode import ExecutionMode
 
 @dataclass(unsafe_hash=True, kw_only=True)
 class Testing:

orionis/metadata/framework.py

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

orionis/services/asynchrony/coroutines.py

@@ -2,7 +2,7 @@ import asyncio
 from typing import Any, Coroutine as TypingCoroutine, TypeVar, Union
 from orionis.services.asynchrony.contracts.coroutines import ICoroutine
 from orionis.services.asynchrony.exceptions import OrionisCoroutineException
-from orionis.services.introspection.inspection import Inspection
+from orionis.services.introspection.objects.types import Type
 
 T = TypeVar("T")
 
@@ -36,7 +36,7 @@ class Coroutine(ICoroutine):
         OrionisCoroutineException
             If the provided object is not a coroutine.
         """
-        if not Inspection(func).isCoroutine():
+        if not Type(func).isCoroutine():
             raise OrionisCoroutineException(
                 f"Expected a coroutine object, but got {type(func).__name__}."
             )

orionis/services/environment/{dot_env.py → core/dot_env.py}

@@ -6,9 +6,8 @@ from pathlib import Path
 from typing import Any, Optional, Union
 from dotenv import dotenv_values, load_dotenv, set_key, unset_key
 from orionis.patterns.singleton.meta import Singleton
-from orionis.services.environment.exceptions.environment_value_exception import OrionisEnvironmentValueException
-from orionis.services.environment.exceptions.environment_value_error import OrionisEnvironmentValueError
-from orionis.services.environment.types import EnvTypes
+from orionis.services.environment.exceptions import OrionisEnvironmentValueException, OrionisEnvironmentValueError
+from orionis.services.environment.dynamic.types import EnvTypes
 
 class DotEnv(metaclass=Singleton):
 

orionis/services/environment/{types.py → dynamic/types.py}

@@ -1,6 +1,5 @@
 from orionis.services.environment.contracts.types import IEnvTypes
-from orionis.services.environment.exceptions.environment_value_error import OrionisEnvironmentValueError
-from orionis.services.environment.exceptions.environment_value_exception import OrionisEnvironmentValueException
+from orionis.services.environment.exceptions import OrionisEnvironmentValueError, OrionisEnvironmentValueException
 
 class EnvTypes(IEnvTypes):
 

orionis/services/environment/env.py

@@ -1,26 +1,7 @@
 from orionis.services.environment.contracts.env import IEnv
-from orionis.services.environment.dot_env import DotEnv
+from orionis.services.environment.core.dot_env import DotEnv
 from typing import Any, Dict
 
-def env(key: str, default: Any = None) -> Any:
-    """
-    Retrieve the value of an environment variable.
-
-    Parameters
-    ----------
-    key : str
-        The name of the environment variable to retrieve.
-    default : Any, optional
-        The value to return if the environment variable is not found. Default is None.
-
-    Returns
-    -------
-    Any
-        The value of the environment variable if it exists, otherwise the default value.
-    """
-    dotenv = DotEnv()
-    return dotenv.get(key, default)
-
 class Env(IEnv):
 
     @staticmethod

orionis/services/environment/exceptions/__init__.py

@@ -0,0 +1,7 @@
+from .exception import OrionisEnvironmentValueException
+from .value import OrionisEnvironmentValueError
+
+__all__ = [
+    "OrionisEnvironmentValueException",
+    "OrionisEnvironmentValueError"
+]

orionis/services/environment/helpers/functions.py

@@ -0,0 +1,21 @@
+from typing import Any
+from orionis.services.environment.core.dot_env import DotEnv
+
+def env(key: str, default: Any = None) -> Any:
+    """
+    Retrieve the value of an environment variable.
+
+    Parameters
+    ----------
+    key : str
+        The name of the environment variable to retrieve.
+    default : Any, optional
+        The value to return if the environment variable is not found. Default is None.
+
+    Returns
+    -------
+    Any
+        The value of the environment variable if it exists, otherwise the default value.
+    """
+    dotenv = DotEnv()
+    return dotenv.get(key, default)

orionis/services/{parsers/exceptions/exception_parser.py → formatter/exceptions/parser.py}

@@ -1,6 +1,6 @@
 import traceback
 from typing import Any, Dict, List, Optional, Union
-from orionis.services.parsers.contracts.exception_parser import IExceptionParser
+from orionis.services.formatter.exceptions.contracts.parser import IExceptionParser
 
 class ExceptionParser(IExceptionParser):
     """

orionis/services/{parsers → formatter}/serializer.py

@@ -1,4 +1,4 @@
-from orionis.services.parsers.exceptions.exception_parser import ExceptionParser
+from orionis.services.formatter.exceptions.parser import ExceptionParser
 
 class Parser:
 

orionis/services/introspection/abstract/{reflection_abstract.py → reflection.py}

@@ -2,13 +2,15 @@ import inspect
 import keyword
 from abc import ABC
 from typing import List, Type
-from orionis.services.introspection.contracts.reflection_abstract import IReflectionAbstract
+from orionis.services.introspection.abstract.contracts.reflection import IReflectionAbstract
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
-from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
-from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
-from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
+from orionis.services.introspection.dependencies.reflection import ReflectDependencies
+from orionis.services.introspection.exceptions import (
+    ReflectionAttributeError,
+    ReflectionTypeError,
+    ReflectionValueError
+)
 
 class ReflectionAbstract(IReflectionAbstract):
 

orionis/services/introspection/callables/contracts/reflection.py

@@ -0,0 +1,141 @@
+from abc import ABC, abstractmethod
+
+class IReflectionCallable(ABC):
+
+    @abstractmethod
+    def getCallable(self) -> callable:
+        """
+        Retrieve the callable function associated with this instance.
+        Returns
+        -------
+        callable
+            The function object encapsulated by this instance.
+        """
+        pass
+
+    @abstractmethod
+    def getName(self) -> str:
+        """
+        Returns
+        -------
+        str
+            The name of the function.
+        """
+        pass
+
+    @abstractmethod
+    def getModuleName(self) -> str:
+        """
+        Get the name of the module where the underlying function is defined.
+        Returns
+        -------
+        str
+            The name of the module in which the function was originally declared.
+        """
+        pass
+
+    @abstractmethod
+    def getModuleWithCallableName(self) -> str:
+        """
+        Get the fully qualified name of the callable, including its module.
+        Returns
+        -------
+        str
+            A string consisting of the module name and the callable name, separated by a dot.
+        """
+        pass
+
+    @abstractmethod
+    def getDocstring(self) -> str:
+        """
+        Retrieve the docstring of the callable function.
+        Returns
+        -------
+        str
+            The docstring associated with the function. Returns an empty string if no docstring is present.
+        """
+        pass
+
+    @abstractmethod
+    def getSourceCode(self) -> str:
+        """
+        Retrieve the source code of the wrapped callable.
+        Returns
+        -------
+        str
+            The source code of the callable function as a string. If the source code
+            cannot be retrieved, a ReflectionAttributeError is raised.
+        Raises
+        ------
+        ReflectionAttributeError
+            If the source code cannot be obtained due to an OSError.
+        """
+        pass
+
+    @abstractmethod
+    def getFile(self) -> str:
+        """
+        Retrieve the filename where the underlying callable function is defined.
+        Returns
+        -------
+        str
+            The absolute path to the source file containing the callable.
+        Raises
+        ------
+        TypeError
+            If the underlying object is a built-in function or method, or if its source file cannot be determined.
+        """
+        pass
+
+    @abstractmethod
+    def call(self, *args, **kwargs):
+        """
+        Call the wrapped function with the provided arguments.
+        If the wrapped function is asynchronous, it will be executed using `asyncio.run`.
+        Parameters
+        ----------
+        *args : tuple
+            Positional arguments to pass to the function.
+        **kwargs : dict
+            Keyword arguments to pass to the function.
+        Returns
+        -------
+        Any
+            The result returned by the function call.
+        Raises
+        ------
+        Exception
+            Propagates any exception raised by the called function.
+        """
+        pass
+
+    @abstractmethod
+    def getSignature(self):
+        """
+        Retrieve the signature of the callable function.
+        Returns
+        -------
+        inspect.Signature
+            An `inspect.Signature` object representing the callable's signature.
+        Notes
+        -----
+        This method provides detailed information about the parameters of the callable,
+        including their names, default values, and annotations.
+        """
+        pass
+
+    @abstractmethod
+    def getDependencies(self):
+        """
+        Analyzes the callable associated with this instance and retrieves its dependencies.
+        CallableDependency
+            An object containing information about the callable's dependencies, including:
+            - resolved: dict
+                A dictionary mapping parameter names to their resolved values (e.g., default values or injected dependencies).
+            - unresolved: list of str
+                A list of parameter names that could not be resolved (i.e., parameters without default values or missing annotations).
+        Notes
+        -----
+        This method leverages the `ReflectDependencies` utility to inspect the callable and determine which dependencies are satisfied and which remain unresolved.
+        """
+        pass

orionis/services/introspection/callables/{reflection_callable.py → reflection.py}

@@ -1,11 +1,14 @@
 import inspect
 from orionis.services.asynchrony.coroutines import Coroutine
+from orionis.services.introspection.callables.contracts.reflection import IReflectionCallable
 from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
-from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
-from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
+from orionis.services.introspection.dependencies.reflection import ReflectDependencies
+from orionis.services.introspection.exceptions import (
+    ReflectionAttributeError,
+    ReflectionTypeError
+)
 
-class ReflectionCallable:
+class ReflectionCallable(IReflectionCallable):
 
     def __init__(self, fn: callable) -> None:
         """

orionis/services/introspection/{contracts/reflection_concrete.py → concretes/contracts/concrete.py}

@@ -3,7 +3,7 @@ import inspect
 from typing import Any, Callable, List, Type
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
-from orionis.services.introspection.instances.reflection_instance import ReflectionInstance
+from orionis.services.introspection.instances.reflection import ReflectionInstance
 
 class IReflectionConcrete(ABC):
 

orionis/services/introspection/concretes/{reflection_concrete.py → reflection.py}

@@ -3,14 +3,16 @@ import inspect
 import keyword
 from typing import Any, Callable, List, Type
 from orionis.services.asynchrony.coroutines import Coroutine
-from orionis.services.introspection.contracts.reflection_concrete import IReflectionConcrete
+from orionis.services.introspection.concretes.contracts.concrete import IReflectionConcrete
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
-from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
-from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
-from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
-from orionis.services.introspection.instances.reflection_instance import ReflectionInstance
+from orionis.services.introspection.dependencies.reflection import ReflectDependencies
+from orionis.services.introspection.exceptions import (
+    ReflectionAttributeError,
+    ReflectionTypeError,
+    ReflectionValueError
+)
+from orionis.services.introspection.instances.reflection import ReflectionInstance
 
 class ReflectionConcrete(IReflectionConcrete):
 

orionis/services/introspection/dependencies/entities/callable_dependencies.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
+from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
 class CallableDependency:

orionis/services/introspection/dependencies/entities/class_dependencies.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
+from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
 class ClassDependency:

orionis/services/introspection/dependencies/entities/method_dependencies.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
+from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
 class MethodDependency:

orionis/services/introspection/dependencies/entities/resolved_dependencies.py

@@ -1,7 +1,6 @@
 from dataclasses import dataclass
 from typing import Type, Any
-
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
+from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
 class ResolvedDependency:

orionis/services/introspection/dependencies/{reflect_dependencies.py → reflection.py}

@@ -1,11 +1,11 @@
 import inspect
 from typing import Any, Dict, List
-from orionis.services.introspection.contracts.reflect_dependencies import IReflectDependencies
+from orionis.services.introspection.dependencies.contracts.reflection import IReflectDependencies
 from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
-from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
+from orionis.services.introspection.exceptions import ReflectionValueError
 
 class ReflectDependencies(IReflectDependencies):
     """

orionis/services/introspection/exceptions/__init__.py

@@ -0,0 +1,9 @@
+from .value import ReflectionValueError
+from .attribute import ReflectionAttributeError
+from .type import ReflectionTypeError
+
+__all__ = [
+    "ReflectionValueError",
+    "ReflectionAttributeError",
+    "ReflectionTypeError"
+]

orionis/services/introspection/instances/{reflection_instance.py → reflection.py}

@@ -4,11 +4,13 @@ from typing import Any, Callable, Dict, List, Optional, Tuple, Type
 from orionis.services.asynchrony.coroutines import Coroutine
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
-from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
-from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
-from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
-from orionis.services.introspection.contracts.reflection_instance import IReflectionInstance
+from orionis.services.introspection.dependencies.reflection import ReflectDependencies
+from orionis.services.introspection.exceptions import (
+    ReflectionAttributeError,
+    ReflectionTypeError,
+    ReflectionValueError
+)
+from orionis.services.introspection.instances.contracts.reflection import IReflectionInstance
 
 class ReflectionInstance(IReflectionInstance):
 

orionis/services/introspection/modules/{reflection_module.py → reflection.py}

@@ -1,9 +1,11 @@
 import importlib
 import inspect
 import keyword
-from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
-from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
-from orionis.services.introspection.contracts.reflection_module import IReflectionModule
+from orionis.services.introspection.exceptions import (
+    ReflectionTypeError,
+    ReflectionValueError
+)
+from orionis.services.introspection.modules.contracts.reflection import IReflectionModule
 
 class ReflectionModule(IReflectionModule):
 

orionis/services/introspection/{inspection.py → objects/types.py}

@@ -1,7 +1,7 @@
 import inspect
 from typing import Any
 
-class Inspection:
+class Type:
 
     def __init__(self, target: Any):
         """