orionis 0.536.0__py3-none-any.whl → 0.538.0__py3-none-any.whl

orionis/console/contracts/event.py

@@ -5,24 +5,32 @@ from orionis.console.enums.event import Event as EventEntity
 
 class IEvent(ABC):
 
-    @abstractmethod
-    def toEntity(
-        self
-    ) -> EventEntity:
+    def misfireGraceTime(
+        self,
+        seconds: int = 60
+    ) -> 'IEvent':
         """
-        Retrieve the event details as an EventEntity instance.
+        Set the misfire grace time for the event.
 
-        This method gathers all relevant attributes of the current Event object,
-        such as its signature, arguments, purpose, random delay, start and end dates,
-        and trigger, and returns them encapsulated in an EventEntity object.
+        This method allows you to specify a grace period (in seconds) during which
+        a missed execution of the event can still be executed. If the event is not
+        executed within this time frame after its scheduled time, it will be skipped.
+
+        Parameters
+        ----------
+        seconds : int
+            The number of seconds to allow for a misfire grace period. Must be a positive integer.
 
         Returns
         -------
-        EventEntity
-            An EventEntity instance containing the event's signature, arguments,
-            purpose, random delay, start date, end date, and trigger.
+        Event
+            Returns the current instance of the Event to allow method chaining.
+
+        Raises
+        ------
+        CLIOrionisValueError
+            If the provided seconds is not a positive integer.
         """
-        pass
 
     @abstractmethod
     def purpose(

orionis/console/contracts/schedule.py

@@ -218,7 +218,7 @@ class ISchedule(ABC):
         pass
 
     @abstractmethod
-    def pause(self, signature: str) -> bool:
+    def pauseTask(self, signature: str) -> bool:
         """
         Pause a scheduled job in the AsyncIO scheduler.
 
@@ -246,7 +246,7 @@ class ISchedule(ABC):
         pass
 
     @abstractmethod
-    def resume(self, signature: str) -> bool:
+    def resumeTask(self, signature: str) -> bool:
         """
         Resume a paused job in the AsyncIO scheduler.
 
@@ -274,7 +274,7 @@ class ISchedule(ABC):
         pass
 
     @abstractmethod
-    def remove(self, signature: str) -> bool:
+    def removeTask(self, signature: str) -> bool:
         """
         Remove a scheduled job from the AsyncIO scheduler.
 
@@ -324,4 +324,107 @@ class ISchedule(ABC):
                 - 'end_date': str or None, the formatted end date and time of the job, or None if not set.
                 - 'details': any, additional details about the job.
         """
+        pass
+
+    @abstractmethod
+    def cancelScheduledPause(self) -> bool:
+        """
+        Cancel a previously scheduled pause operation.
+
+        This method attempts to remove a job from the scheduler that was set to pause
+        the scheduler at a specific time. If the job exists, it is removed, and a log entry
+        is created to indicate the cancellation. If no such job exists, the method returns False.
+
+        Returns
+        -------
+        bool
+            True if the scheduled pause job was successfully cancelled.
+            False if no pause job was found or an error occurred during the cancellation process.
+        """
+        pass
+
+    @abstractmethod
+    def cancelScheduledResume(self) -> bool:
+        """
+        Cancel a previously scheduled resume operation.
+
+        This method attempts to remove a job from the scheduler that was set to resume
+        the scheduler at a specific time. If the job exists, it is removed, and a log entry
+        is created to indicate the cancellation. If no such job exists, the method returns False.
+
+        Returns
+        -------
+        bool
+            True if the scheduled resume job was successfully cancelled.
+            False if no resume job was found or an error occurred during the cancellation process.
+        """
+        pass
+
+    @abstractmethod
+    def cancelScheduledShutdown(self) -> bool:
+        """
+        Cancel a previously scheduled shutdown operation.
+
+        This method attempts to remove a job from the scheduler that was set to shut down
+        the scheduler at a specific time. If the job exists, it is removed, and a log entry
+        is created to indicate the cancellation. If no such job exists, the method returns False.
+
+        Returns
+        -------
+        bool
+            True if the scheduled shutdown job was successfully cancelled.
+            False if no shutdown job was found or an error occurred during the cancellation process.
+        """
+        pass
+
+    @abstractmethod
+    def isRunning(self) -> bool:
+        """
+        Determine if the scheduler is currently active and running.
+
+        This method checks the internal state of the AsyncIOScheduler instance to determine
+        whether it is currently running. The scheduler is considered running if it has been
+        started and has not been paused or shut down.
+
+        Returns
+        -------
+        bool
+            True if the scheduler is running, False otherwise.
+        """
+        pass
+
+    @abstractmethod
+    def forceStop(self) -> None:
+        """
+        Forcefully stop the scheduler immediately without waiting for jobs to complete.
+
+        This method shuts down the AsyncIOScheduler instance without waiting for currently
+        running jobs to finish. It is intended for emergency situations where an immediate
+        stop is required. The method also signals the internal stop event to ensure that
+        the scheduler's main loop is interrupted and the application can proceed with
+        shutdown procedures.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It forcefully stops the scheduler and
+            signals the stop event.
+        """
+        pass
+
+    @abstractmethod
+    def stop(self) -> None:
+        """
+        Stop the scheduler synchronously by setting the stop event.
+
+        This method signals the scheduler to stop by setting the internal stop event.
+        It can be called from non-async contexts to initiate a shutdown. If the asyncio
+        event loop is running, the stop event is set in a thread-safe manner. Otherwise,
+        the stop event is set directly.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It signals the scheduler to stop.
+        """
         pass

orionis/console/enums/event.py

@@ -60,4 +60,10 @@ class Event:
     details: Optional[str] = None
 
     # Optional listener that implements IScheduleEventListener
-    listener: Optional[IScheduleEventListener] = None
+    listener: Optional[IScheduleEventListener] = None
+
+    # Maximum number of concurrent instances allowed for the event
+    max_instances: int = 1
+
+    # Grace time in seconds for misfired events
+    misfire_grace_time : Optional[int] = None

orionis/console/tasks/event.py

@@ -77,6 +77,9 @@ class Event(IEvent):
         # Initialize the maximum instances attribute as None
         self.__max_instances: Optional[int] = None
 
+        # Initialize the misfire grace time attribute as None
+        self.__misfire_grace_time: Optional[int] = None
+
     def toEntity(
         self
     ) -> EventEntity:
@@ -128,6 +131,14 @@ class Event(IEvent):
         if self.__listener is not None and not issubclass(self.__listener, IScheduleEventListener):
             raise CLIOrionisValueError("Listener must implement IScheduleEventListener interface or be None.")
 
+        # Validate that max_instances is a positive integer if it is set
+        if self.__max_instances is not None and (not isinstance(self.__max_instances, int) or self.__max_instances <= 0):
+            raise CLIOrionisValueError("Max instances must be a positive integer or None.")
+
+        # Validate that misfire_grace_time is a positive integer if it is set
+        if self.__misfire_grace_time is not None and (not isinstance(self.__misfire_grace_time, int) or self.__misfire_grace_time <= 0):
+            raise CLIOrionisValueError("Misfire grace time must be a positive integer or None.")
+
         # Construct and return an EventEntity with the current event's attributes
         return EventEntity(
             signature=self.__signature,
@@ -138,9 +149,48 @@ class Event(IEvent):
             end_date=self.__end_date,
             trigger=self.__trigger,
             details=self.__details,
-            listener=self.__listener
+            listener=self.__listener,
+            max_instances=self.__max_instances,
+            misfire_grace_time=self.__misfire_grace_time
         )
 
+    def misfireGraceTime(
+        self,
+        seconds: int = 60
+    ) -> 'Event':
+        """
+        Set the misfire grace time for the event.
+
+        This method allows you to specify a grace period (in seconds) during which
+        a missed execution of the event can still be executed. If the event is not
+        executed within this time frame after its scheduled time, it will be skipped.
+
+        Parameters
+        ----------
+        seconds : int
+            The number of seconds to allow for a misfire grace period. Must be a positive integer.
+
+        Returns
+        -------
+        Event
+            Returns the current instance of the Event to allow method chaining.
+
+        Raises
+        ------
+        CLIOrionisValueError
+            If the provided seconds is not a positive integer.
+        """
+
+        # Validate that the seconds parameter is a positive integer
+        if not isinstance(seconds, int) or seconds <= 0:
+            raise CLIOrionisValueError("Misfire grace time must be a positive integer.")
+
+        # Set the internal misfire grace time attribute
+        self.__misfire_grace_time = seconds
+
+        # Return self to support method chaining
+        return self
+
     def purpose(
         self,
         purpose: str

orionis/console/tasks/schedule.py

@@ -37,7 +37,6 @@ from orionis.console.exceptions import CLIOrionisRuntimeError
 from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
 from orionis.failure.contracts.catch import ICatch
 from orionis.foundation.contracts.application import IApplication
-from orionis.services.asynchrony.coroutines import Coroutine
 from orionis.services.log.contracts.log_service import ILogger
 
 class Schedule(ISchedule):
@@ -167,7 +166,7 @@ class Schedule(ISchedule):
             # Store each job's signature and description in the commands dictionary
             commands[job['signature']] = {
                 'signature': job['signature'],
-                'description': job.get('description', '')
+                'description': job.get('description', 'No description available.')
             }
 
         # Return the commands dictionary
@@ -268,7 +267,7 @@ class Schedule(ISchedule):
 
         # Prevent adding new commands while the scheduler is running
         if self.isRunning():
-            raise CLIOrionisRuntimeError("Cannot add new commands while the scheduler is running.")
+            self.__raiseException(CLIOrionisValueError("Cannot add new commands while the scheduler is running."))
 
         # Validate that the command signature is a non-empty string
         if not isinstance(signature, str) or not signature.strip():
@@ -465,7 +464,7 @@ class Schedule(ISchedule):
 
         # Validate that the provided event is an instance of ListeningEvent
         if not isinstance(listening_vent, ListeningEvent):
-            raise CLIOrionisValueError("The event must be an instance of ListeningEvent.")
+            self.__raiseException(CLIOrionisValueError("The event must be an instance of ListeningEvent."))
 
         # Retrieve the global identifier for the event from the ListeningEvent enum
         scheduler_event = listening_vent.value
@@ -481,16 +480,9 @@ class Schedule(ISchedule):
 
                 # Invoke the listener, handling both coroutine and regular functions
                 try:
-
-                    # Use Coroutine to handle both sync and async listeners
-                    Coroutine(listener).invoke(event_data, self)
-
+                    self.__app.invoke(listener, event_data, self)
                 except BaseException as e:
-
-                    # Construct and log error message
-                    error_msg = f"An error occurred while invoking the listener for event '{scheduler_event}': {str(e)}"
-                    self.__logger.error(error_msg)
-                    raise CLIOrionisRuntimeError(error_msg) from e
+                    self.__raiseException(e)
 
     def __taskCallableListener(
         self,
@@ -528,9 +520,7 @@ class Schedule(ISchedule):
 
         # Validate that the provided event is an instance of ListeningEvent
         if not isinstance(listening_vent, ListeningEvent):
-            error_msg = "The event must be an instance of ListeningEvent."
-            self.__logger.error(error_msg)
-            raise CLIOrionisValueError(error_msg)
+            self.__raiseException(CLIOrionisValueError("The event must be an instance of ListeningEvent."))
 
         # Validate that event_data is not None and has a id attribute
         if not isinstance(event_data, EventJob) or not hasattr(event_data, 'id') or not event_data.id:
@@ -548,38 +538,25 @@ class Schedule(ISchedule):
             # Check if the listener is an instance of IScheduleEventListener
             if issubclass(listener, IScheduleEventListener):
 
-                # Initialize the listener if it's a class
-                if isinstance(listener, type):
-                    listener = listener()
-
-                # Check if the listener has a method corresponding to the event type
-                if hasattr(listener, scheduler_event) and callable(getattr(listener, scheduler_event)):
-
-                    # Retrieve the method from the listener
-                    listener_method = getattr(listener, scheduler_event)
-
-                    # Invoke the listener method, handling both coroutine and regular functions
-                    try:
-
-                        # Use Coroutine to handle both sync and async listener methods
-                        Coroutine(listener_method).invoke(event_data, self)
+                try:
 
-                    except Exception as e:
+                    # Initialize the listener if it's a class
+                    if isinstance(listener, type):
+                        listener = self.__app.make(listener)
 
-                        # Construct and log error message
-                        error_msg = f"An error occurred while invoking the listener_method for event '{scheduler_event}': {str(e)}"
-                        self.__logger.error(error_msg)
-                        raise CLIOrionisRuntimeError(error_msg) from e
+                    # Check if the listener has a method corresponding to the event type
+                    if hasattr(listener, scheduler_event) and callable(getattr(listener, scheduler_event)):
+                        self.__app.call(listener, scheduler_event, event_data, self)
 
-                else:
+                except BaseException as e:
 
-                    # Log a warning if the listener does not have the required method
-                    self.__logger.warning(f"The listener for job ID '{event_data.id}' does not have a method for event '{scheduler_event}'.")
+                    # If an error occurs while invoking the listener, raise an exception
+                    self.__raiseException(e)
 
             else:
 
-                # Log a warning if the listener is not an instance of IScheduleEventListener
-                self.__logger.warning(f"The listener for job ID '{event_data.id}' is not an instance of IScheduleEventListener.")
+                # If the listener is not a subclass of IScheduleEventListener, raise an exception
+                self.__raiseException(CLIOrionisValueError(f"The listener for job ID '{event_data.id}' must be a subclass of IScheduleEventListener."))
 
     def __startedListener(
         self,
@@ -727,10 +704,7 @@ class Schedule(ISchedule):
         self.__globalCallableListener(event_data, ListeningEvent.SCHEDULER_ERROR)
 
         # Catch any exceptions that occur during command handling
-        self.__catch.exception(self, CLIRequest(
-            command=job_event_data.id,
-            args=list(job_event_data.args) or []
-        ), event.exception)
+        self.__raiseException(event.exception)
 
     def __submittedListener(
         self,
@@ -929,7 +903,7 @@ class Schedule(ISchedule):
 
                 try:
                     # Convert the event to its entity representation
-                    entity = event.toEntity()
+                    entity: EventEntity = event.toEntity()
 
                     # Add the job to the internal jobs list
                     self.__jobs.append(entity)
@@ -944,7 +918,9 @@ class Schedule(ISchedule):
                         trigger=entity.trigger,
                         id=signature,
                         name=signature,
-                        replace_existing=True
+                        replace_existing=True,
+                        max_instances=entity.max_instances,
+                        misfire_grace_time=entity.misfire_grace_time
                     )
 
                     # If a listener is associated with the event, register it
@@ -965,6 +941,48 @@ class Schedule(ISchedule):
                     # Raise a runtime error if loading the scheduled event fails
                     raise CLIOrionisRuntimeError(error_msg)
 
+    def __raiseException(
+        self,
+        exception: BaseException
+    ) -> None:
+        """
+        Handle and propagate exceptions through the application's error handling system.
+
+        This private method serves as a centralized exception handler for the scheduler,
+        delegating exception processing to the application's error catching mechanism.
+        It ensures that all exceptions occurring within the scheduler context are
+        properly handled according to the application's error handling policies.
+
+        The method acts as a bridge between the scheduler's internal operations and
+        the application's global exception handling system, providing consistent
+        error handling behavior across the entire application.
+
+        Parameters
+        ----------
+        exception : BaseException
+            The exception instance that was raised during command execution. This can be
+            any type of exception that inherits from BaseException, including system
+            exceptions, custom application exceptions, and runtime errors.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It delegates exception handling
+            to the application's error catching mechanism and may re-raise the
+            exception depending on the configured error handling behavior.
+
+        Notes
+        -----
+        This method is intended for internal use within the scheduler and should not
+        be called directly by external code. The error catching mechanism may perform
+        various actions such as logging, reporting, or re-raising the exception based
+        on the application's configuration.
+        """
+
+        # Delegate exception handling to the application's error catching mechanism
+        # This ensures consistent error handling across the entire application
+        self.__catch.exception(self, CLIRequest(command="schedule:work", args=[]), exception)
+
     def setListener(
         self,
         event: Union[str, ListeningEvent],
@@ -995,7 +1013,7 @@ class Schedule(ISchedule):
 
         Raises
         ------
-        ValueError
+        CLIOrionisValueError
             If the event name is not a non-empty string or if the listener is not callable
             or an instance of IScheduleEventListener.
         """
@@ -1006,11 +1024,11 @@ class Schedule(ISchedule):
 
         # Validate that the event name is a non-empty string
         if not isinstance(event, str) or not event.strip():
-            raise ValueError("Event name must be a non-empty string.")
+            raise CLIOrionisValueError("Event name must be a non-empty string.")
 
         # Validate that the listener is either callable or an instance of IScheduleEventListener
         if not callable(listener) and not isinstance(listener, IScheduleEventListener):
-            raise ValueError("Listener must be a callable function or an instance of IScheduleEventListener.")
+            raise CLIOrionisValueError("Listener must be a callable function or an instance of IScheduleEventListener.")
 
         # Register the listener for the specified event in the internal listeners dictionary
         self.__listeners[event] = listener
@@ -1101,19 +1119,13 @@ class Schedule(ISchedule):
             error reporting and debugging information.
             """
 
+            # Execute the asynchronous function using the container's invoke method
             try:
-                # Execute the asynchronous function using the Coroutine utility class
-                # The Coroutine class handles the event loop management and async execution
-                return Coroutine(func).invoke(*args, **kwargs)
+                self.__app.invoke(func, *args, **kwargs)
 
+            # If an error occurs during execution, raise a custom exception
             except Exception as e:
-
-                # Log the error with detailed information for debugging purposes
-                self.__logger.error(f"Error executing async function: {str(e)}")
-
-                # Re-raise the exception wrapped in a custom exception type
-                # This provides better error context and maintains the original stack trace
-                raise CLIOrionisRuntimeError(f"Failed to execute async function: {str(e)}") from e
+                self.__raiseException(e)
 
         # Return the synchronous wrapper function
         return sync_wrapper
@@ -1151,7 +1163,7 @@ class Schedule(ISchedule):
 
         # Validate that the 'at' parameter is a datetime object
         if not isinstance(at, datetime):
-            raise ValueError("The 'at' parameter must be a datetime object.")
+            CLIOrionisValueError("The 'at' parameter must be a datetime object.")
 
         # Define an async function to pause the scheduler
         async def schedule_pause():
@@ -1198,8 +1210,8 @@ class Schedule(ISchedule):
 
                         except Exception as e:
 
-                            # Log a warning if pausing a job fails, but continue with others
-                            self.__logger.warning(f"Failed to pause job '{job.id}': {str(e)}")
+                            # If an error occurs while pausing the job, raise an exception
+                            self.__raiseException(e)
 
                 # Execute the global callable listener after all jobs are paused
                 self.__globalCallableListener(SchedulerPaused(
@@ -1270,7 +1282,7 @@ class Schedule(ISchedule):
 
         # Validate that the 'at' parameter is a datetime object
         if not isinstance(at, datetime):
-            raise ValueError("The 'at' parameter must be a datetime object.")
+            raise CLIOrionisValueError("The 'at' parameter must be a datetime object.")
 
         # Define an async function to resume the scheduler
         async def schedule_resume():
@@ -1300,8 +1312,8 @@ class Schedule(ISchedule):
 
                         except Exception as e:
 
-                            # Log a warning if resuming a job fails, but continue with others
-                            self.__logger.warning(f"Failed to resume job '{job_id}': {str(e)}")
+                            # If an error occurs while resuming the job, raise an exception
+                            self.__raiseException(e)
 
                     # Clear the set after resuming all jobs
                     self.__pausedByPauseEverything.clear()
@@ -1407,8 +1419,7 @@ class Schedule(ISchedule):
                 except Exception as e:
 
                     # Log any errors that occur during shutdown
-                    error_msg = f"Error during scheduled shutdown: {str(e)}"
-                    self.__logger.error(error_msg)
+                    self.__logger.error(f"Error during scheduled shutdown: {str(e)}")
 
                     # Force stop if graceful shutdown fails
                     self.forceStop()
@@ -1542,7 +1553,7 @@ class Schedule(ISchedule):
 
         # Validate the wait parameter
         if not isinstance(wait, bool):
-            raise ValueError("The 'wait' parameter must be a boolean value.")
+            self.__raiseException(CLIOrionisValueError("The 'wait' parameter must be a boolean value."))
 
         # If the scheduler is not running, there's nothing to shut down
         if not self.isRunning():
@@ -1570,9 +1581,9 @@ class Schedule(ISchedule):
         except Exception as e:
 
             # Handle exceptions that may occur during shutdown
-            raise CLIOrionisRuntimeError(f"Failed to shut down the scheduler: {str(e)}") from e
+            self.__raiseException(CLIOrionisRuntimeError(f"Failed to shut down the scheduler: {str(e)}"))
 
-    def pause(self, signature: str) -> bool:
+    def pauseTask(self, signature: str) -> bool:
         """
         Pause a scheduled job in the AsyncIO scheduler.
 
@@ -1600,7 +1611,7 @@ class Schedule(ISchedule):
 
         # Validate that the signature is a non-empty string
         if not isinstance(signature, str) or not signature.strip():
-            raise CLIOrionisValueError("Signature must be a non-empty string.")
+            self.__raiseException(CLIOrionisValueError("Signature must be a non-empty string."))
 
         try:
 
@@ -1618,7 +1629,7 @@ class Schedule(ISchedule):
             # Return False if the job could not be paused (e.g., it does not exist)
             return False
 
-    def resume(self, signature: str) -> bool:
+    def resumeTask(self, signature: str) -> bool:
         """
         Resume a paused job in the AsyncIO scheduler.
 
@@ -1646,7 +1657,7 @@ class Schedule(ISchedule):
 
         # Validate that the signature is a non-empty string
         if not isinstance(signature, str) or not signature.strip():
-            raise CLIOrionisValueError("Signature must be a non-empty string.")
+            self.__raiseException(CLIOrionisValueError("Signature must be a non-empty string."))
 
         try:
             # Attempt to resume the job with the given signature
@@ -1663,7 +1674,7 @@ class Schedule(ISchedule):
             # Return False if the job could not be resumed (e.g., it does not exist)
             return False
 
-    def remove(self, signature: str) -> bool:
+    def removeTask(self, signature: str) -> bool:
         """
         Remove a scheduled job from the AsyncIO scheduler.
 
@@ -1692,7 +1703,7 @@ class Schedule(ISchedule):
 
         # Validate that the signature is a non-empty string
         if not isinstance(signature, str) or not signature.strip():
-            raise CLIOrionisValueError("Signature must be a non-empty string.")
+            self.__raiseException(CLIOrionisValueError("Signature must be a non-empty string."))
 
         try:
 

orionis/container/container.py

@@ -17,6 +17,8 @@ from orionis.services.introspection.callables.reflection import ReflectionCallab
 from orionis.services.introspection.concretes.reflection import ReflectionConcrete
 from orionis.services.introspection.dependencies.entities.argument import Argument
 from orionis.services.introspection.dependencies.entities.resolve_argument import ResolveArguments
+from orionis.services.introspection.dependencies.reflection import ReflectDependencies
+from orionis.services.introspection.instances.reflection import ReflectionInstance
 
 class Container(IContainer):
 
@@ -206,9 +208,72 @@ class Container(IContainer):
 
         try:
 
-            # Check if the callable is a coroutine function
-            result = fn(*args, **kwargs)
-            return self.__handleSyncAsyncResult(result)
+            # Count the total number of provided arguments
+            total_provided_args = len(args) + len(kwargs)
+
+            # Inspect the callable to determine its signature and parameters
+            dependencies = ReflectDependencies(fn).getCallableDependencies()
+            total_dependencies = len(dependencies.resolved) + len(dependencies.unresolved)
+
+            # If the callable does not require any dependencies, invoke directly
+            if total_dependencies == 0:
+                result = fn(*args, **kwargs)
+                return self.__handleSyncAsyncResult(result)
+
+            # If enough arguments are provided, invoke directly
+            if total_provided_args >= total_dependencies:
+                result = fn(*args, **kwargs)
+                return self.__handleSyncAsyncResult(result)
+
+            # If not enough arguments are provided, attempt to resolve missing dependencies
+            if total_provided_args < total_dependencies:
+
+                # New lists to hold the final arguments to pass to the callable
+                n_args = []
+                n_kwargs = {}
+
+                # Iterate through the function's required arguments in order
+                args_index = 0
+
+                # Iterate over all dependencies in the order they were defined
+                for name, dep in dependencies.ordered.items():
+
+                    # Check if the argument was provided positionally and hasn't been used yet
+                    if args_index < len(args) and name not in kwargs:
+
+                        # Add the positional argument to the new list
+                        n_args.append(args[args_index])
+
+                        # Move to the next positional argument
+                        args_index += 1
+
+                    # Check if the argument was provided as a keyword argument
+                    elif name in kwargs:
+
+                        # Add the keyword argument to the new dictionary
+                        n_kwargs[name] = kwargs[name]
+
+                        # Remove the argument from the original kwargs to avoid duplication
+                        del kwargs[name]
+
+                    # If not provided, attempt to resolve it from the container
+                    else:
+
+                        n_kwargs[name] = self.__resolveSingleDependency(
+                            getattr(fn, '__name__', str(fn)),
+                            name,
+                            dep
+                        )
+
+                # Add any remaining positional arguments that weren't mapped to specific parameters
+                n_args.extend(args[args_index:])
+
+                # Add any remaining keyword arguments that weren't processed
+                n_kwargs.update(kwargs)
+
+                # Invoke the function with the resolved arguments
+                result = fn(*n_args, **n_kwargs)
+                return self.__handleSyncAsyncResult(result)
 
         except TypeError as e:
 
@@ -219,8 +284,9 @@ class Container(IContainer):
 
             # Raise a more informative exception with the function name and signature
             raise OrionisContainerException(
-                f"Failed to invoke function [{function_name}] with the provided arguments: {e}\n"
-                f"Expected function signature: [{signature}]"
+                f"Failed to invoke function [{function_name}] with the provided arguments: {e}. "
+                f"Note that this may include a reference to the same 'self' object.\n"
+                f"Expected function signature: {function_name}{signature}"
             ) from e
 
     def transient(
@@ -2360,6 +2426,79 @@ class Container(IContainer):
                 f"Method '{method_name}' not found or not callable on instance '{type(instance).__name__}'."
             )
 
+    def invoke(
+        self,
+        fn: Callable,
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Invokes a callable with automatic dependency injection and sync/async handling.
+
+        Parameters
+        ----------
+        fn : Callable
+            The callable to invoke.
+        *args : tuple
+            Positional arguments to pass to the callable.
+        **kwargs : dict
+            Keyword arguments to pass to the callable.
+
+        Returns
+        -------
+        Any
+            The result of the callable invocation.
+        """
+
+        # Validate that fn is indeed callable
+        if not callable(fn):
+            raise OrionisContainerException(
+                f"Provided fn '{getattr(fn, '__name__', str(fn))}' is not callable."
+            )
+
+        # Execute the callable with appropriate handling
+        return self.__executeMethod(fn, *args, **kwargs)
+
+    async def invokeAsync(
+        self,
+        fn: Callable,
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Async version of invoke for when you're in an async context and need to await the result.
+
+        Parameters
+        ----------
+        fn : Callable
+            The callable to invoke.
+        *args : tuple
+            Positional arguments to pass to the callable.
+        **kwargs : dict
+            Keyword arguments to pass to the callable.
+
+        Returns
+        -------
+        Any
+            The result of the callable invocation, properly awaited if async.
+        """
+
+        # Validate that fn is indeed callable
+        if not callable(fn):
+            raise OrionisContainerException(
+                f"Provided fn '{getattr(fn, '__name__', str(fn))}' is not callable."
+            )
+
+        # Execute the callable with appropriate handling
+        result = self.__executeMethod(fn, *args, **kwargs)
+
+        # If the result is a coroutine, await it
+        if asyncio.iscoroutine(result):
+            return await result
+
+        # Otherwise, return the result directly
+        return result
+
     def __executeMethod(
         self,
         method: Callable,

orionis/container/contracts/container.py

@@ -449,3 +449,55 @@ class IContainer(ABC):
             The result of the method call, properly awaited if async.
         """
         pass
+
+    @abstractmethod
+    def invoke(
+        self,
+        fn: Callable,
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Invokes a callable with automatic dependency injection and sync/async handling.
+
+        Parameters
+        ----------
+        fn : Callable
+            The callable to invoke.
+        *args : tuple
+            Positional arguments to pass to the callable.
+        **kwargs : dict
+            Keyword arguments to pass to the callable.
+
+        Returns
+        -------
+        Any
+            The result of the callable invocation.
+        """
+        pass
+
+    @abstractmethod
+    async def invokeAsync(
+        self,
+        fn: Callable,
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Async version of invoke for when you're in an async context and need to await the result.
+
+        Parameters
+        ----------
+        fn : Callable
+            The callable to invoke.
+        *args : tuple
+            Positional arguments to pass to the callable.
+        **kwargs : dict
+            Keyword arguments to pass to the callable.
+
+        Returns
+        -------
+        Any
+            The result of the callable invocation, properly awaited if async.
+        """
+        pass

orionis/failure/base/handler.py

@@ -13,7 +13,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Example: OrionisContainerException
     ]
 
-    async def destructureException(self, e: BaseException) -> Throwable:
+    async def destructureException(self, exception: BaseException) -> Throwable:
         """
         Converts an exception into a structured `Throwable` object containing detailed information.
 
@@ -35,13 +35,13 @@ class BaseExceptionHandler(IBaseExceptionHandler):
 
         # Create and return a Throwable object with detailed exception information
         return Throwable(
-            classtype=type(e),                              # The class/type of the exception
-            message=str(e),                                 # The exception message as a string
-            args=e.args,                                    # The arguments passed to the exception
-            traceback=getattr(e, '__traceback__', None)     # The traceback object, if available
+            classtype=type(exception),                              # The class/type of the exception
+            message=str(exception),                                 # The exception message as a string
+            args=exception.args,                                    # The arguments passed to the exception
+            traceback=getattr(exception, '__traceback__', None)     # The traceback object, if available
         )
 
-    async def shouldIgnoreException(self, e: BaseException) -> bool:
+    async def shouldIgnoreException(self, exception: BaseException) -> bool:
         """
         Determines if the exception should be ignored (not handled) by the handler.
 
@@ -57,11 +57,11 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         """
 
         # Ensure the provided object is an exception
-        if not isinstance(e, BaseException):
-            raise TypeError(f"Expected BaseException, got {type(e).__name__}")
+        if not isinstance(exception, BaseException):
+            raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
 
         # Convert the exception into a structured Throwable object
-        throwable = await self.destructureException(e)
+        throwable = await self.destructureException(exception)
 
         # Check if the exception type is in the list of exceptions to ignore
         return hasattr(self, 'dont_catch') and throwable.classtype in self.dont_catch

orionis/failure/catch.py

@@ -1,17 +1,12 @@
 from typing import Any
 from orionis.console.kernel import KernelCLI
-from orionis.console.output.contracts.console import IConsole
 from orionis.console.tasks.schedule import Schedule
 from orionis.failure.contracts.catch import ICatch
 from orionis.failure.contracts.handler import IBaseExceptionHandler
 from orionis.foundation.contracts.application import IApplication
-from orionis.services.asynchrony.coroutines import Coroutine
-from orionis.services.log.contracts.log_service import ILogger
-import asyncio
 
 class Catch(ICatch):
 
-
     def __init__(self, app: IApplication) -> None:
         """
         Initializes the Catch handler with application services for console output and logging.
@@ -40,11 +35,8 @@ class Catch(ICatch):
         error reporting and output.
         """
 
-        # Retrieve the console output service from the application container
-        self.__console: IConsole = app.make('x-orionis.console.output.console')
-
-        # Retrieve the logger service from the application container
-        self.__logger: ILogger = app.make('x-orionis.services.log.log_service')
+        # Store the application instance
+        self.__app: IApplication = app
 
         # Retrieve the console output service from the application container
         self.__exception_handler: IBaseExceptionHandler = app.getExceptionHandler()
@@ -76,89 +68,15 @@ class Catch(ICatch):
         If a valid kernel is provided, the exception details are rendered to the CLI.
         """
 
-        async def handle():
-            """
-            Handles exceptions asynchronously using the provided exception handler.
-
-            This method performs the following steps:
-            1. Determines if the exception should be ignored by invoking the `shouldIgnoreException` method
-               of the exception handler. This method supports both coroutine and regular functions.
-            2. Reports the exception using the `report` method of the exception handler. This method
-               also supports both coroutine and regular functions.
-            3. If the kernel is of type `KernelCLI` or `Any`, it attempts to render the exception
-               for the CLI using the `renderCLI` method of the exception handler. This method supports
-               both coroutine and regular functions.
-
-            Parameters
-            ----------
-            None
-
-            Returns
-            -------
-            Any or None
-            The result of the `renderCLI` method if applicable, otherwise `None`.
-
-            Notes
-            -----
-            - The `self.__exception_handler` is expected to have the methods `shouldIgnoreException`,
-              `report`, and `renderCLI`.
-            - The `self.__logger` is passed to the `report` and `renderCLI` methods for logging purposes.
-            - The `self.__console` is passed to the `renderCLI` method for CLI rendering.
-            """
-
-            # Check if the `shouldIgnoreException` method is a coroutine function
-            if asyncio.iscoroutinefunction(self.__exception_handler.shouldIgnoreException):
-
-                # If it is, await its result to determine if the exception should be ignored
-                if await self.__exception_handler.shouldIgnoreException(e):
-                    return
-
-            else:
-
-                # If it is not a coroutine, call it directly
-                if self.__exception_handler.shouldIgnoreException(e):
-                    return
-
-            # Check if the `report` method is a coroutine function
-            if asyncio.iscoroutinefunction(self.__exception_handler.report):
-
-                # If it is, await its execution to report the exception
-                await self.__exception_handler.report(
-                    exception=e,
-                    log=self.__logger
-                )
-
-            else:
-
-                # If it is not a coroutine, call it directly
-                self.__exception_handler.report(
-                    exception=e,
-                    log=self.__logger
-                )
-
-            # Check if the kernel is of type `KernelCLI` or `Any`
-            if isinstance(kernel, KernelCLI) or isinstance(kernel, Schedule):
-
-                # Check if the `renderCLI` method is a coroutine function
-                if asyncio.iscoroutinefunction(self.__exception_handler.renderCLI):
-
-                    # If it is, await its execution to render the exception for the CLI
-                    return await self.__exception_handler.renderCLI(
-                        request=request,
-                        exception=e,
-                        log=self.__logger,
-                        console=self.__console
-                    )
-
-                else:
-
-                    # If it is not a coroutine, call it directly
-                    return self.__exception_handler.renderCLI(
-                        request=request,
-                        exception=e,
-                        log=self.__logger,
-                        console=self.__console
-                    )
-
-        # Execute the exception handling logic using the Coroutine wrapper
-        Coroutine(handle()).run()
+        # If there is no exception handler, return early
+        if self.__app.call(self.__exception_handler, 'shouldIgnoreException', exception=e):
+            return
+
+        # Report the exception using the exception handler and logger
+        self.__app.call(self.__exception_handler, 'report', exception=e)
+
+        # Check if the kernel is of type `KernelCLI` or `Any`
+        if isinstance(kernel, KernelCLI) or isinstance(kernel, Schedule):
+
+            # Render the exception details to the CLI using the exception handler
+            self.__app.call(self.__exception_handler, 'renderCLI', request=request, exception=e)

orionis/failure/entities/throwable.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 
-@dataclass(kw_only=True)
+@dataclass(kw_only=True, frozen=True)
 class Throwable:
     """
     Represents a throwable entity (such as an exception or error) within the framework.

orionis/foundation/application.py

@@ -469,10 +469,10 @@ class Application(Container, IApplication):
         if self.__exception_handler is None:
 
             # Return the default exception handler instance
-            return BaseExceptionHandler()
+            return self.make(BaseExceptionHandler)
 
         # Instantiate and return the registered exception handler
-        return self.__exception_handler()
+        return self.make(self.__exception_handler)
 
     def setScheduler(
         self,

orionis/metadata/framework.py

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

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

@@ -43,6 +43,9 @@ class ResolveArguments(BaseEntity):
     # Unresolved dependencies as a dictionary of names to Argument instances
     unresolved: Dict[str, Argument]
 
+    # All dependencies in the order they were defined
+    ordered: Dict[str, Argument]
+
     def __post_init__(self):
         """
         Validates the types and contents of the resolved and unresolved attributes.
@@ -79,4 +82,11 @@ class ResolveArguments(BaseEntity):
         if not isinstance(self.unresolved, dict):
             raise ReflectionTypeError(
                 f"'unresolved' must be a dict, got {type(self.unresolved).__name__}"
+            )
+
+        # Validate that the 'ordered' attribute is a dictionary type
+        # This ensures that all dependencies maintain the same structure as resolved ones
+        if not isinstance(self.ordered, dict):
+            raise ReflectionTypeError(
+                f"'ordered' must be a dict, got {type(self.ordered).__name__}"
             )

orionis/services/introspection/dependencies/reflection.py

@@ -121,6 +121,7 @@ class ReflectDependencies(IReflectDependencies):
         # Initialize dictionaries to store categorized dependencies
         resolved_dependencies: Dict[str, Argument] = {}
         unresolved_dependencies: Dict[str, Argument] = {}
+        ordered_dependencies: Dict[str, Argument] = {}
 
         # Iterate through all parameters in the signature
         for param_name, param in signature.parameters.items():
@@ -140,6 +141,7 @@ class ReflectDependencies(IReflectDependencies):
                     type=Any,
                     full_class_path=None,
                 )
+                ordered_dependencies[param_name] = unresolved_dependencies[param_name]
                 continue
 
             # Case 2: Parameters with default values
@@ -153,6 +155,7 @@ class ReflectDependencies(IReflectDependencies):
                     full_class_path=f"{type(param.default).__module__}.{type(param.default).__name__}",
                     default=param.default
                 )
+                ordered_dependencies[param_name] = resolved_dependencies[param_name]
                 continue
 
             # Case 3: Parameters with type annotations
@@ -168,6 +171,7 @@ class ReflectDependencies(IReflectDependencies):
                         type=param.annotation,
                         full_class_path=f"{param.annotation.__module__}.{param.annotation.__name__}"
                     )
+                    ordered_dependencies[param_name] = unresolved_dependencies[param_name]
                 else:
                     # Non-builtin types with annotations are considered resolved
                     # as they can be instantiated by the dependency injection system
@@ -178,12 +182,14 @@ class ReflectDependencies(IReflectDependencies):
                         type=param.annotation,
                         full_class_path=f"{param.annotation.__module__}.{param.annotation.__name__}"
                     )
+                    ordered_dependencies[param_name] = resolved_dependencies[param_name]
                 continue
 
         # Return the categorized dependencies
         return ResolveArguments(
             resolved=resolved_dependencies,
-            unresolved=unresolved_dependencies
+            unresolved=unresolved_dependencies,
+            ordered=ordered_dependencies
         )
 
     def getConstructorDependencies(self) -> ResolveArguments:

{orionis-0.536.0.dist-info → orionis-0.538.0.dist-info}/METADATA

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

{orionis-0.536.0.dist-info → orionis-0.538.0.dist-info}/RECORD

@@ -22,10 +22,10 @@ orionis/console/commands/version.py,sha256=SUuNDJ40f2uq69OQUmPQXJKaa9Bm_iVRDPmBd
 orionis/console/commands/workflow.py,sha256=NYOmjTSvm2o6AE4h9LSTZMFSYPQreNmEJtronyOxaYk,2451
 orionis/console/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/contracts/command.py,sha256=vmAJD0yMQ5-AD_s9_xCFEAl64sKk65z7U2E196dALQM,5760
-orionis/console/contracts/event.py,sha256=zaOkbRNKpU6U_cIEFic84C3WIcD8kCIyX9hc50jN8N0,119797
+orionis/console/contracts/event.py,sha256=GEgpmsyVGKJYi0LwvEklTm7aAHqsqUprtC2p6qq0eZU,120005
 orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
 orionis/console/contracts/reactor.py,sha256=Xeq7Zrw6WE5MV_XOQfiQEchAFbb6-0TjLpjWOxYW--g,4554
-orionis/console/contracts/schedule.py,sha256=17cfPYtLo-jqF8FxYOhh4epJZnxw5mMPuLGaWoUwxL4,12171
+orionis/console/contracts/schedule.py,sha256=N-AYUa1CJY7a4CV9L1EX_EUDtGlDJMg4y0aV9EDby1Q,16090
 orionis/console/contracts/schedule_event_listener.py,sha256=7fQdPh6X_npfGpQW_2x81D7-5Pe40jIog9uDeEU0kro,4390
 orionis/console/contracts/scheduler.py,sha256=OW-a_YDDNPrenYT9z8Tv71VjyZ1aSzqzqhTBhTCZhGM,7698
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -65,7 +65,7 @@ orionis/console/entities/scheduler_shutdown.py,sha256=vRFXUt3hxKueaT6M4335HFL3NO
 orionis/console/entities/scheduler_started.py,sha256=U0pduaFhWrEUJQws81jTjDmTp4Kxfy6ontq8rQN4Y6I,910
 orionis/console/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/enums/command.py,sha256=lCfVp2vnDojJN2gjdVxE_XU3mRjZZgOIxPfBVQYo9w4,1278
-orionis/console/enums/event.py,sha256=G_6QEagrjtQ81dgkVhTTc2M2YuhnnKRkRSjd2i8m3OQ,2808
+orionis/console/enums/event.py,sha256=xyJfJQmXnZ_c-zPZx3_pzKm54R-kKyJkQzIercv556w,3004
 orionis/console/enums/listener.py,sha256=bDHDOkKQFEfEmZyiisZj37ozr8Hs7_lKvm_3uYjvEpw,2988
 orionis/console/exceptions/__init__.py,sha256=0qlHNuHMVZO87M-rP8lThUUyljRM1jSFNikaxSCjSbw,366
 orionis/console/exceptions/cli_exception.py,sha256=HsZ_vSeNiJWQ0gznVFNcIdhM0Bj_vkSRVBJs0wMjEKY,1141
@@ -82,16 +82,16 @@ orionis/console/output/enums/__init__.py,sha256=LAaAxg-DpArCjf_jqZ0_9s3p8899gntD
 orionis/console/output/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
 orionis/console/request/cli_request.py,sha256=7-sgYmNUCipuHLVAwWLJiHv0cJCDmsM1Lu9s2D8RIII,1498
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/event.py,sha256=l4J-HEPaj1mxB_PYQMgG9dRHUe01wUag8fKLLnR2N2M,164395
+orionis/console/tasks/event.py,sha256=yE64gWAWaaz-mlWk5LIKDh4HYO14iwRfdYfwFh7Wktk,166479
 orionis/console/tasks/listener.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/schedule.py,sha256=0DxGovmetj5bmeMzvL5fCFePy6p8Gl_5uwsLgi-E1xY,82854
+orionis/console/tasks/schedule.py,sha256=EQs1wmowaYxN8KBy-csj27ZXnza5xHctSbk3qr0-88I,83378
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/container.py,sha256=aF_b6lTUpG4YCo9yFJEzsntTdIzgMMXFW5LyWqAJVBQ,87987
+orionis/container/container.py,sha256=262gahG9L_72QovlHP7cF5QhFX4HTolwcYrVo86HcVg,93196
 orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/context/manager.py,sha256=I08K_jKXSKmrq18Pv33qYyMKIlAovVOwIgmfiVm-J7c,2971
 orionis/container/context/scope.py,sha256=p_oCzR7dDz-5ZAd16ab4vfLc3gBf34CaN0f4iR9D0bQ,1155
 orionis/container/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/contracts/container.py,sha256=l-wVi6KMLL4I55JSHnNqykiaZSZO9ea6BDSzCKsysak,14217
+orionis/container/contracts/container.py,sha256=r-HpuMUbkI19lNTisgxB2lbvvt0YFA4xsEDVLCPDrys,15507
 orionis/container/contracts/service_provider.py,sha256=TJtwFoPYvw3hvBSfIEO3-httq8iszaRQh1IjCKfDyVM,1016
 orionis/container/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/entities/binding.py,sha256=sY0ioHbRcjp9TSQjfrFHxkO3vRn_VOrbHK62_QEGe1U,3717
@@ -117,16 +117,16 @@ orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYq
 orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
 orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/failure/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/catch.py,sha256=kmw2mbkGrFNw9s8jrr2NdJeGlbJVvXQQSlnjltwC4oM,6819
+orionis/failure/catch.py,sha256=XpPISy-83grGYP1PSScrF7jyogpvOjDjbz-11iop2FQ,3286
 orionis/failure/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/base/handler.py,sha256=a7fQJMWVjALwFiITRsMYg3s7WSO6zcbmq171iQRWy48,4867
+orionis/failure/base/handler.py,sha256=6QU2XHpJgH2hhGBANvioJBz16Aoi9Xy6QEF1PJBGLDQ,4939
 orionis/failure/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/contracts/catch.py,sha256=e2wM1p6VxbvAjgWm-MwoM9p2ystSsyBu8Qnt6Ehr6Vc,1179
 orionis/failure/contracts/handler.py,sha256=drNE8iu8RUHi3TgKn-lUEIfVsZeGsMTUecTZOfay19E,2240
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/entities/throwable.py,sha256=ogys062uhim5QMYU62ezlnumRAnYQlUf_vZvQY47S3U,1227
+orionis/failure/entities/throwable.py,sha256=1zD-awcuAyEtlR-L7V7ZIfPSF4GpXkf-neL5sXul7dc,1240
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=RwMRjRp9kkKRbDsz_lAN4NYadCuaDbmDnccWKl8aKng,86488
+orionis/foundation/application.py,sha256=_I8EAPcsRmGdmG9ajdSHovwny_tsELXWwvej6WZQj0A,86506
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=vbzduprRCNyYeR2nnMaqc1uKXw6PTzAY2jVfXNQKN8I,9691
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -242,7 +242,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=1do4B09bU_6xbFHHVYYTGM
 orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
 orionis/foundation/providers/workers_provider.py,sha256=oa_2NIDH6UxZrtuGkkoo_zEoNIMGgJ46vg5CCgAm7wI,3926
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=WTvqT0Hj7mUOGLnlkmB7AYj6OZPyvYlfAwd0Cy0U1eI,4109
+orionis/metadata/framework.py,sha256=iH8hUXm6LKEb4khPzo0501jhpYsPSCLa_DlR-u7Ct6k,4109
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -298,12 +298,12 @@ orionis/services/introspection/concretes/contracts/reflection.py,sha256=LwEAgdN_
 orionis/services/introspection/dataclass/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/dataclass/attributes.py,sha256=VGBUxH40PxUE8J4TBBYdSqwTO0xwYYmIS6BITgff-cE,1695
 orionis/services/introspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/dependencies/reflection.py,sha256=VEe3cY6LTpOW3dm0IFECTHh7F_9_X-siTAeQc2XRQeM,13451
+orionis/services/introspection/dependencies/reflection.py,sha256=3aQl541JkohRcoZFxQGiGPz3CnBMK8gmcRwO9XiLSY0,13906
 orionis/services/introspection/dependencies/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/dependencies/contracts/reflection.py,sha256=DhkAmsl8fxNr3L1kCSpVmTZx9YBejq2kYcfUrCWG8o0,5364
 orionis/services/introspection/dependencies/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/dependencies/entities/argument.py,sha256=o30iMSghV8CFBWmnM__8_IOnOGrCLZfRUIQGD2GVl_g,4188
-orionis/services/introspection/dependencies/entities/resolve_argument.py,sha256=GxlW-JwoJwYO1TWH4aqJ982Y4mTiU69GEU3GlevDWtM,3373
+orionis/services/introspection/dependencies/entities/resolve_argument.py,sha256=einKDEIp9NjBUfc9_ulmkwzAv7sRuxS3lM_FE3zFN-s,3810
 orionis/services/introspection/exceptions/__init__.py,sha256=oe7uzaGwjeMgz62ZTeNn6ersCApOVv3PXFlUw0vYLQM,234
 orionis/services/introspection/exceptions/attribute.py,sha256=_JerTjfhikYwC2FKJV8XbVZqiZdLcBt7WGtw8r6vkqo,473
 orionis/services/introspection/exceptions/type.py,sha256=73DB8JoTbxd7LNMnZKXf4jJ8OzLyC0HPXgDo5pffkYY,466
@@ -420,7 +420,7 @@ orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNu
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
-orionis-0.536.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.538.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/test_manager.py,sha256=wOwXpl9rHNfTTexa9GBKYMwK0_-KSQPbI-AEyGNkmAE,1356
@@ -566,8 +566,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=WPo5GxTP6xE-Dw3X1vZoqOMpb6HhokjNSbgDsDRDvy4,16588
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=tnnMBwS0iKUIbogLvu-7Rii50G6Koddp3XT4wgdFEYM,1050
-orionis-0.536.0.dist-info/METADATA,sha256=Ea7HN9aJxUuIxswX2rZ6rdLcFdaExCsUaaHC8VCX8Wo,4801
-orionis-0.536.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.536.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.536.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.536.0.dist-info/RECORD,,
+orionis-0.538.0.dist-info/METADATA,sha256=4fH1vZ-4R_AT8VmMWs3HzV8vZFOmPCB7f-gr2fDH54Y,4801
+orionis-0.538.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.538.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.538.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.538.0.dist-info/RECORD,,