orionis 0.517.0__tar.gz → 0.519.0__tar.gz

{orionis-0.517.0/orionis.egg-info → orionis-0.519.0}/PKG-INFO

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

orionis-0.519.0/orionis/console/base/scheduler.py

@@ -0,0 +1,195 @@
+from datetime import datetime
+from orionis.console.contracts.scheduler import IBaseScheduler
+from orionis.console.contracts.schedule import ISchedule
+from orionis.console.entities.job_error import JobError
+from orionis.console.entities.scheduler_paused import SchedulerPaused
+from orionis.console.entities.scheduler_resumed import SchedulerResumed
+from orionis.console.entities.scheduler_shutdown import SchedulerShutdown
+from orionis.console.entities.scheduler_started import SchedulerStarted
+
+class BaseScheduler(IBaseScheduler):
+
+    # Pause Global Scheduler at a specific time
+    PAUSE_AT: datetime = None
+
+    # Resume Global Scheduler at a specific time
+    RESUME_AT: datetime = None
+
+    # Finalize Global Scheduler at a specific time
+    FINALIZE_AT: datetime = None
+
+    async def tasks(self, schedule: ISchedule):
+        """
+        Defines and registers scheduled tasks for the application.
+
+        This method is responsible for setting up the tasks that the scheduler will execute.
+        It uses the provided `schedule` object to define the properties and behavior of each task.
+
+        Parameters
+        ----------
+        schedule : ISchedule
+            The schedule object used to define and register scheduled commands.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used solely for task registration.
+
+        Notes
+        -----
+        Subclasses must override this method to implement their specific task scheduling logic.
+        The method should define the tasks, their execution intervals, and any additional
+        properties or constraints required for the tasks.
+        """
+
+        # Raise an error to enforce implementation in subclasses
+        raise NotImplementedError("Subclasses must implement the tasks method.")
+
+    async def onStarted(self, event: SchedulerStarted, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler has started successfully.
+
+        This method is invoked when the scheduler begins its operation. It processes
+        the `SchedulerStarted` event and performs any necessary initialization or logging
+        tasks associated with the start of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerStarted
+            The event object containing details about the scheduler start event.
+        schedule : ISchedule
+            The schedule instance associated with the started scheduler.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the
+            scheduler start event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onStarted` method to ensure that
+        any base functionality is executed.
+        """
+        pass
+
+    async def onPaused(self, event: SchedulerPaused, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler is paused.
+
+        This method is invoked when the scheduler pauses its operation. It processes
+        the `SchedulerPaused` event and performs any necessary actions or logging
+        tasks associated with the pause of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerPaused
+            The event object containing details about the scheduler pause event.
+        schedule : ISchedule
+            The schedule instance associated with the paused scheduler.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the
+            scheduler pause event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onPaused` method to ensure that
+        any base functionality is executed.
+        """
+        pass
+
+    async def onResumed(self, event: SchedulerResumed, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler is resumed.
+
+        This method is invoked when the scheduler resumes its operation after being paused.
+        It processes the `SchedulerResumed` event and performs any necessary actions or logging
+        tasks associated with the resumption of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerResumed
+            The event object containing details about the scheduler resumption, such as the
+            timestamp of the resumption and any relevant metadata.
+        schedule : ISchedule
+            The schedule instance associated with the resumed scheduler, which can be used
+            to interact with or modify the scheduler's tasks.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the scheduler
+            resumption event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onResumed` method to ensure that any base
+        functionality is executed. This allows the scheduler to maintain its default behavior
+        while enabling additional custom actions during the resumption process.
+        """
+        pass
+
+    async def onFinalized(self, event: SchedulerShutdown, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler has been finalized.
+
+        This method is invoked after the scheduler has completed its shutdown process.
+        It processes the `SchedulerShutdown` event and performs any necessary cleanup
+        or logging tasks associated with the finalization of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerShutdown
+            The event object containing details about the scheduler shutdown, such as
+            the timestamp of the shutdown and any relevant metadata.
+        schedule : ISchedule
+            The schedule instance associated with the finalized scheduler, which can be
+            used to interact with or inspect the scheduler's tasks.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the scheduler
+            shutdown event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onFinalized` method to ensure that any base
+        functionality is executed. This allows the scheduler to maintain its default behavior
+        while enabling additional custom actions during the finalization process.
+        """
+        pass
+
+    async def onError(self, event: JobError, schedule: ISchedule):
+        """
+        Handles the event triggered when a job encounters an error during execution.
+
+        This method is invoked when a job fails due to an exception. It processes the `JobError`
+        event and performs any necessary actions, such as logging the error details or notifying
+        relevant systems about the failure.
+
+        Parameters
+        ----------
+        event : JobError
+            The event object containing details about the job error, including the job ID,
+            the exception that occurred, and any relevant metadata.
+        schedule : ISchedule
+            The schedule instance associated with the job, which can be used to interact with
+            or modify the scheduler's tasks.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the job error event
+            and performing related actions, such as logging or cleanup.
+
+        Notes
+        -----
+        This method calls the parent class's `onError` method to ensure that any base functionality
+        is executed. This allows the scheduler to maintain its default behavior while enabling
+        additional custom actions during error handling.
+        """
+        pass

orionis-0.519.0/orionis/console/contracts/scheduler.py

@@ -0,0 +1,189 @@
+from abc import ABC, abstractmethod
+from orionis.console.contracts.schedule import ISchedule
+from orionis.console.entities.job_error import JobError
+from orionis.console.entities.scheduler_paused import SchedulerPaused
+from orionis.console.entities.scheduler_resumed import SchedulerResumed
+from orionis.console.entities.scheduler_shutdown import SchedulerShutdown
+from orionis.console.entities.scheduler_started import SchedulerStarted
+
+class IBaseScheduler(ABC):
+
+    @abstractmethod
+    async def tasks(self, schedule: ISchedule):
+        """
+        Defines and registers scheduled tasks for the application.
+
+        This method is responsible for setting up the tasks that the scheduler will execute.
+        It uses the provided `schedule` object to define the properties and behavior of each task.
+
+        Parameters
+        ----------
+        schedule : ISchedule
+            The schedule object used to define and register scheduled commands.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used solely for task registration.
+
+        Notes
+        -----
+        Subclasses must override this method to implement their specific task scheduling logic.
+        The method should define the tasks, their execution intervals, and any additional
+        properties or constraints required for the tasks.
+        """
+        pass
+
+    @abstractmethod
+    async def onStarted(self, event: SchedulerStarted, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler has started successfully.
+
+        This method is invoked when the scheduler begins its operation. It processes
+        the `SchedulerStarted` event and performs any necessary initialization or logging
+        tasks associated with the start of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerStarted
+            The event object containing details about the scheduler start event.
+        schedule : ISchedule
+            The schedule instance associated with the started scheduler.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the
+            scheduler start event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onStarted` method to ensure that
+        any base functionality is executed.
+        """
+        pass
+
+    @abstractmethod
+    async def onPaused(self, event: SchedulerPaused, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler is paused.
+
+        This method is invoked when the scheduler pauses its operation. It processes
+        the `SchedulerPaused` event and performs any necessary actions or logging
+        tasks associated with the pause of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerPaused
+            The event object containing details about the scheduler pause event.
+        schedule : ISchedule
+            The schedule instance associated with the paused scheduler.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the
+            scheduler pause event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onPaused` method to ensure that
+        any base functionality is executed.
+        """
+        pass
+
+    @abstractmethod
+    async def onResumed(self, event: SchedulerResumed, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler is resumed.
+
+        This method is invoked when the scheduler resumes its operation after being paused.
+        It processes the `SchedulerResumed` event and performs any necessary actions or logging
+        tasks associated with the resumption of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerResumed
+            The event object containing details about the scheduler resumption, such as the
+            timestamp of the resumption and any relevant metadata.
+        schedule : ISchedule
+            The schedule instance associated with the resumed scheduler, which can be used
+            to interact with or modify the scheduler's tasks.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the scheduler
+            resumption event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onResumed` method to ensure that any base
+        functionality is executed. This allows the scheduler to maintain its default behavior
+        while enabling additional custom actions during the resumption process.
+        """
+        pass
+
+    @abstractmethod
+    async def onFinalized(self, event: SchedulerShutdown, schedule: ISchedule):
+        """
+        Handles the event triggered when the scheduler has been finalized.
+
+        This method is invoked after the scheduler has completed its shutdown process.
+        It processes the `SchedulerShutdown` event and performs any necessary cleanup
+        or logging tasks associated with the finalization of the scheduler.
+
+        Parameters
+        ----------
+        event : SchedulerShutdown
+            The event object containing details about the scheduler shutdown, such as
+            the timestamp of the shutdown and any relevant metadata.
+        schedule : ISchedule
+            The schedule instance associated with the finalized scheduler, which can be
+            used to interact with or inspect the scheduler's tasks.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the scheduler
+            shutdown event and performing related actions.
+
+        Notes
+        -----
+        This method calls the parent class's `onFinalized` method to ensure that any base
+        functionality is executed. This allows the scheduler to maintain its default behavior
+        while enabling additional custom actions during the finalization process.
+        """
+        pass
+
+    @abstractmethod
+    async def onError(self, event: JobError, schedule: ISchedule):
+        """
+        Handles the event triggered when a job encounters an error during execution.
+
+        This method is invoked when a job fails due to an exception. It processes the `JobError`
+        event and performs any necessary actions, such as logging the error details or notifying
+        relevant systems about the failure.
+
+        Parameters
+        ----------
+        event : JobError
+            The event object containing details about the job error, including the job ID,
+            the exception that occurred, and any relevant metadata.
+        schedule : ISchedule
+            The schedule instance associated with the job, which can be used to interact with
+            or modify the scheduler's tasks.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is used for handling the job error event
+            and performing related actions, such as logging or cleanup.
+
+        Notes
+        -----
+        This method calls the parent class's `onError` method to ensure that any base functionality
+        is executed. This allows the scheduler to maintain its default behavior while enabling
+        additional custom actions during error handling.
+        """
+        pass

{orionis-0.517.0 → orionis-0.519.0}/orionis/console/tasks/schedule.py

@@ -3,6 +3,7 @@ from datetime import datetime
 import logging
 from typing import Dict, List, Optional, Union
 import pytz
+from apscheduler.triggers.date import DateTrigger
 from apscheduler.events import (
     EVENT_SCHEDULER_STARTED,
     EVENT_SCHEDULER_PAUSED,
@@ -288,7 +289,7 @@ class Scheduler(ISchedule):
         # Return the Event instance for further scheduling configuration
         return self.__events[signature]
 
-    def __suscribeListeners(
+    def __subscribeListeners(
         self
     ) -> None:
         """
@@ -366,12 +367,16 @@ class Scheduler(ISchedule):
 
             # Ensure the listener is callable before invoking it
             if callable(listener):
-                # If the listener is a coroutine, schedule it as an asyncio task
-                if asyncio.iscoroutinefunction(listener):
-                    asyncio.create_task(listener(event_data, self))
-                # Otherwise, invoke the listener directly as a regular function
-                else:
-                    listener(event_data, self)
+                try:
+                    # If the listener is a coroutine, schedule it as an asyncio task
+                    if asyncio.iscoroutinefunction(listener):
+                        asyncio.create_task(listener(event_data, self))
+                    # Otherwise, invoke the listener directly as a regular function
+                    else:
+                        listener(event_data, self)
+                except Exception as e:
+                    # Log any exceptions that occur during listener invocation
+                    self.__logger.error(f"Error invoking global listener for event '{scheduler_event}': {str(e)}")
 
     def __taskCallableListener(
         self,
@@ -411,6 +416,10 @@ class Scheduler(ISchedule):
         if not isinstance(listening_vent, ListeningEvent):
             raise CLIOrionisValueError("The event must be an instance of ListeningEvent.")
 
+        # Validate that event_data is not None and has a job_id attribute
+        if event_data is None or not hasattr(event_data, 'job_id'):
+            return
+
         # Retrieve the global identifier for the event from the ListeningEvent enum
         scheduler_event = listening_vent.value
 
@@ -427,13 +436,17 @@ class Scheduler(ISchedule):
                 if hasattr(listener, scheduler_event) and callable(getattr(listener, scheduler_event)):
                     listener_method = getattr(listener, scheduler_event)
 
-                    # Invoke the listener method, handling both coroutine and regular functions
-                    if asyncio.iscoroutinefunction(listener_method):
-                        # Schedule the coroutine listener method as an asyncio task
-                        asyncio.create_task(listener_method(event_data, self))
-                    else:
-                        # Call the regular listener method directly
-                        listener_method(event_data, self)
+                    try:
+                        # Invoke the listener method, handling both coroutine and regular functions
+                        if asyncio.iscoroutinefunction(listener_method):
+                            # Schedule the coroutine listener method as an asyncio task
+                            asyncio.create_task(listener_method(event_data, self))
+                        else:
+                            # Call the regular listener method directly
+                            listener_method(event_data, self)
+                    except Exception as e:
+                        # Log any exceptions that occur during listener invocation
+                        self.__logger.error(f"Error invoking listener method '{scheduler_event}' for job '{event_data.job_id}': {str(e)}")
 
     def __startedListener(
         self,
@@ -524,7 +537,7 @@ class Scheduler(ISchedule):
         # Log an informational message indicating that the scheduler has been paused
         self.__logger.info(message)
 
-        # Check if a listener is registered for the scheduler started event
+        # Check if a listener is registered for the scheduler paused event
         self.__globalCallableListener(event, ListeningEvent.SCHEDULER_PAUSED)
 
     def __resumedListener(
@@ -561,7 +574,7 @@ class Scheduler(ISchedule):
         # Log an informational message indicating that the scheduler has resumed
         self.__logger.info(message)
 
-        # Check if a listener is registered for the scheduler started event
+        # Check if a listener is registered for the scheduler resumed event
         self.__globalCallableListener(event, ListeningEvent.SCHEDULER_RESUMED)
 
     def __shutdownListener(
@@ -598,7 +611,7 @@ class Scheduler(ISchedule):
         # Log an informational message indicating that the scheduler has shut down
         self.__logger.info(message)
 
-        # Check if a listener is registered for the scheduler started event
+        # Check if a listener is registered for the scheduler shutdown event
         self.__globalCallableListener(event, ListeningEvent.SCHEDULER_SHUTDOWN)
 
     def __errorListener(
@@ -878,11 +891,11 @@ class Scheduler(ISchedule):
                 self.__jobs.append(entity)
 
                 # Create a unique key for the job based on its signature
+                def create_job_func(cmd, args_list):
+                    return lambda: self.__reactor.call(cmd, args_list)
+
                 self.__scheduler.add_job(
-                    func= lambda command=signature, args=list(entity.args): self.__reactor.call(
-                        command,
-                        args
-                    ),
+                    func=create_job_func(signature, list(entity.args)),
                     trigger=entity.trigger,
                     id=signature,
                     name=signature,
@@ -979,8 +992,7 @@ class Scheduler(ISchedule):
         # Add a job to the scheduler to pause it at the specified datetime
         self.__scheduler.add_job(
             func=self.__scheduler.pause,                    # Function to pause the scheduler
-            trigger='date',                                 # Trigger type is 'date' for one-time execution
-            run_date=at,                                    # The datetime at which the job will run
+            trigger=DateTrigger(run_date=at),               # Trigger type is 'date' for one-time execution
             id=f"pause_scheduler_at_{at.isoformat()}",      # Unique job ID based on the datetime
             name=f"Pause Scheduler at {at.isoformat()}",    # Descriptive name for the job
             replace_existing=True                           # Replace any existing job with the same ID
@@ -1022,8 +1034,7 @@ class Scheduler(ISchedule):
         # Add a job to the scheduler to resume it at the specified datetime
         self.__scheduler.add_job(
             func=self.__scheduler.resume,                   # Function to resume the scheduler
-            trigger='date',                                 # Trigger type is 'date' for one-time execution
-            run_date=at,                                    # The datetime at which the job will run
+            trigger=DateTrigger(run_date=at),               # Trigger type is 'date' for one-time execution
             id=f"resume_scheduler_at_{at.isoformat()}",     # Unique job ID based on the datetime
             name=f"Resume Scheduler at {at.isoformat()}",   # Descriptive name for the job
             replace_existing=True                           # Replace any existing job with the same ID
@@ -1065,8 +1076,7 @@ class Scheduler(ISchedule):
         # Add a job to the scheduler to shut it down at the specified datetime
         self.__scheduler.add_job(
             func=self.__scheduler.shutdown,                 # Function to shut down the scheduler
-            trigger='date',                                 # Trigger type is 'date' for one-time execution
-            run_date=at,                                    # The datetime at which the job will run
+            trigger=DateTrigger(run_date=at),               # Trigger type is 'date' for one-time execution
             id=f"shutdown_scheduler_at_{at.isoformat()}",   # Unique job ID based on the datetime
             name=f"Shutdown Scheduler at {at.isoformat()}", # Descriptive name for the job
             replace_existing=True                           # Replace any existing job with the same ID
@@ -1093,7 +1103,7 @@ class Scheduler(ISchedule):
             self.__loadEvents()
 
             # Subscribe to scheduler events for monitoring and handling
-            self.__suscribeListeners()
+            self.__subscribeListeners()
 
             # Ensure we're in an asyncio context
             asyncio.get_running_loop()

{orionis-0.517.0 → orionis-0.519.0}/orionis/metadata/framework.py

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

{orionis-0.517.0 → orionis-0.519.0/orionis.egg-info}/PKG-INFO

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

orionis-0.517.0/orionis/console/base/scheduler.py

@@ -1,120 +0,0 @@
-from datetime import datetime
-from orionis.console.contracts.scheduler import IBaseScheduler
-from orionis.console.contracts.schedule import ISchedule
-
-class BaseScheduler(IBaseScheduler):
-
-    # Pause Global Scheduler at a specific time
-    PAUSE_AT: datetime = None
-
-    # Resume Global Scheduler at a specific time
-    RESUME_AT: datetime = None
-
-    # Finalize Global Scheduler at a specific time
-    FINALIZE_AT: datetime = None
-
-    async def tasks(self, schedule: ISchedule):
-        """
-        Defines and registers scheduled tasks for the application.
-
-        Parameters
-        ----------
-        schedule : ISchedule
-            The schedule object used to define and register scheduled commands.
-
-        Returns
-        -------
-        None
-            This method does not return any value. It is intended to be overridden
-            by subclasses to specify scheduled tasks.
-        """
-        # Placeholder for task registration logic
-        pass
-
-    async def onStarted(self):
-        """
-        Called when the scheduler is started.
-
-        Returns
-        -------
-        None
-            This method does not return any value.
-
-        Notes
-        -----
-        Intended to be overridden by subclasses to implement custom behavior that should
-        occur when the scheduler starts running.
-        """
-        # Placeholder for logic to execute when the scheduler starts
-        pass
-
-    async def onPaused(self):
-        """
-        Called when the scheduler is paused.
-
-        Returns
-        -------
-        None
-            This method does not return any value.
-
-        Notes
-        -----
-        Should be overridden to define custom behavior that occurs when the scheduler
-        enters a paused state.
-        """
-        # Placeholder for logic to execute when the scheduler is paused
-        pass
-
-    async def onResumed(self):
-        """
-        Called when the scheduler is resumed from a paused state.
-
-        Returns
-        -------
-        None
-            This method does not return any value.
-
-        Notes
-        -----
-        Should be overridden to implement any actions that need to occur when the
-        scheduler resumes operation.
-        """
-        # Placeholder for logic to execute when the scheduler is resumed
-        pass
-
-    async def onFinalized(self):
-        """
-        Called when the scheduler has completed its execution and is being finalized.
-
-        Returns
-        -------
-        None
-            This method does not return any value.
-
-        Notes
-        -----
-        Can be overridden to perform any necessary cleanup or finalization tasks.
-        """
-        # Placeholder for logic to execute when the scheduler is finalized
-        pass
-
-    async def onError(self, error: Exception):
-        """
-        Handles errors that occur within the scheduler.
-
-        Parameters
-        ----------
-        error : Exception
-            The exception instance representing the error that occurred.
-
-        Returns
-        -------
-        None
-            This method does not return any value.
-
-        Notes
-        -----
-        Can be overridden to implement custom error handling logic for the scheduler.
-        """
-        # Placeholder for logic to handle errors in the scheduler
-        pass