orionis 0.621.0__py3-none-any.whl → 0.622.0__py3-none-any.whl

orionis/console/contracts/event.py

@@ -2768,7 +2768,7 @@ class IEvent(ABC):
     @abstractmethod
     def everyMondayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -2783,7 +2783,7 @@ class IEvent(ABC):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -2811,7 +2811,7 @@ class IEvent(ABC):
     @abstractmethod
     def everyTuesdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -2826,7 +2826,7 @@ class IEvent(ABC):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -2854,7 +2854,7 @@ class IEvent(ABC):
     @abstractmethod
     def everyWednesdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -2869,7 +2869,7 @@ class IEvent(ABC):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -2897,7 +2897,7 @@ class IEvent(ABC):
     @abstractmethod
     def everyThursdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -2912,7 +2912,7 @@ class IEvent(ABC):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -2940,7 +2940,7 @@ class IEvent(ABC):
     @abstractmethod
     def everyFridayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -2955,7 +2955,7 @@ class IEvent(ABC):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -2983,7 +2983,7 @@ class IEvent(ABC):
     @abstractmethod
     def everySaturdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -2997,8 +2997,8 @@ class IEvent(ABC):
 
         Parameters
         ----------
-        hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+        hour : int
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3026,7 +3026,7 @@ class IEvent(ABC):
     @abstractmethod
     def everySundayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3041,7 +3041,7 @@ class IEvent(ABC):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional

orionis/console/contracts/schedule.py

@@ -311,6 +311,23 @@ class ISchedule(ABC):
         """
         pass
 
+    @abstractmethod
+    def isPaused(self) -> bool:
+        """
+        Check if the scheduler is currently paused.
+
+        This method determines whether the scheduler is in a paused state by checking if there are
+        any jobs that were paused using the `pause` method. If there are jobs in the internal set
+        `__pausedByPauseEverything`, it indicates that the scheduler has been paused.
+
+        Returns
+        -------
+        bool
+            True if the scheduler is currently paused (i.e., there are jobs in the paused set);
+            False otherwise.
+        """
+        pass
+
     @abstractmethod
     def forceStop(self) -> None:
         """

orionis/console/fluent/event.py

@@ -57,7 +57,7 @@ class Event(IEvent):
         self.__purpose: Optional[str] = purpose
 
         # Initialize the random delay attribute (in seconds) as None
-        self.__random_delay: Optional[int] = None
+        self.__random_delay: Optional[int] = 0
 
         # Initialize the start date for the event as None
         self.__start_date: Optional[datetime] = None
@@ -74,8 +74,8 @@ class Event(IEvent):
         # Initialize the listener attribute as None; can be set to an IScheduleEventListener instance
         self.__listener: Optional[IScheduleEventListener] = None
 
-        # Initialize the maximum instances attribute as None
-        self.__max_instances: Optional[int] = None
+        # Initialize the maximum instances attribute as 1
+        self.__max_instances: Optional[int] = 1
 
         # Initialize the misfire grace time attribute as None
         self.__misfire_grace_time: Optional[int] = None
@@ -136,7 +136,7 @@ class Event(IEvent):
             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):
+        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
@@ -182,7 +182,7 @@ class Event(IEvent):
         """
 
         # Validate that the seconds parameter is a positive integer
-        if not isinstance(seconds, int) or seconds <= 0:
+        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
@@ -225,7 +225,7 @@ class Event(IEvent):
             raise CLIOrionisValueError("The purpose must be a non-empty string.")
 
         # Set the internal purpose attribute
-        self.__purpose = purpose
+        self.__purpose = purpose.strip()
 
         # Return self to support method chaining
         return self
@@ -315,11 +315,11 @@ class Event(IEvent):
         """
 
         # Validate that max_seconds is a positive integer
-        if not isinstance(max_seconds, int) or max_seconds <= 0 or max_seconds > 120:
-            raise CLIOrionisValueError("Max seconds must be a positive integer between 1 and 120.")
+        if not isinstance(max_seconds, int) or max_seconds < 0 or max_seconds > 120:
+            raise CLIOrionisValueError("Max seconds must be a positive integer between 0 and 120.")
 
-        # Generate a random delay between 1 and max_seconds (inclusive)
-        self.__random_delay = random.randint(1, max_seconds)
+        # Generate a random delay between 0 and max_seconds
+        self.__random_delay = random.randint(1, max_seconds) if max_seconds > 0 else 0
 
         # Return self to support method chaining
         return self
@@ -2717,17 +2717,18 @@ class Event(IEvent):
         the trigger.
         """
 
-        # Configure the trigger to execute the event every day.
-        # Apply any configured start_date, end_date, and random_delay (jitter).
-        self.__trigger = IntervalTrigger(
-            days=1,
+        # Configure the trigger to execute the event every day at 00:00:00.
+        self.__trigger = CronTrigger(
+            hour=0,
+            minute=0,
+            second=0,
             start_date=self.__start_date,  # Restrict the schedule start if set
             end_date=self.__end_date,      # Restrict the schedule end if set
             jitter=self.__random_delay     # Apply random delay if configured
         )
 
         # Store a human-readable description of the schedule.
-        self.__details = "Every day"
+        self.__details = "Every day at 00:00:00"
 
         # Indicate that the scheduling was successful.
         return True
@@ -2788,15 +2789,14 @@ class Event(IEvent):
         if not (0 <= second < 60):
             raise CLIOrionisValueError("Second must be between 0 and 59.")
 
-        # Set up the trigger to execute the event daily at the specified time.
-        # The IntervalTrigger will fire every day at the given hour, minute, and second.
-        self.__trigger = IntervalTrigger(
-            days=1,
+        # Set up the trigger to execute the event daily at the specified time using CronTrigger.
+        self.__trigger = CronTrigger(
             hour=hour,
             minute=minute,
             second=second,
             start_date=self.__start_date,
-            end_date=self.__end_date
+            end_date=self.__end_date,
+            jitter=self.__random_delay
         )
 
         # Store a human-readable description of the schedule.
@@ -2867,16 +2867,17 @@ class Event(IEvent):
         second: int = 0
     ) -> bool:
         """
-        Schedule the event to run every day at a specific hour, minute, and second.
+        Schedule the event to run every N days at a specific hour, minute, and second.
 
-        This method configures the event to execute once per day at the specified
-        hour, minute, and second. The schedule can be further restricted by previously
-        set `start_date` and `end_date` attributes. If a random delay (jitter) has been
-        configured, it will be applied to the trigger to help distribute load or avoid
-        collisions.
+        This method configures the event to execute every `days` days at the specified
+        hour, minute, and second using a CronTrigger. The schedule can be further restricted
+        by previously set `start_date` and `end_date` attributes. If a random delay (jitter)
+        has been configured, it will be applied to the trigger.
 
         Parameters
         ----------
+        days : int
+            The interval, in days, at which the event should be executed. Must be a positive integer.
         hour : int
             The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
@@ -2889,23 +2890,22 @@ class Event(IEvent):
         bool
             Returns True if the scheduling was successfully configured. If the input
             is invalid, a `CLIOrionisValueError` is raised and the trigger is not set.
-            On success, returns True.
 
         Raises
         ------
         CLIOrionisValueError
-            If `hour`, `minute`, or `second` are not integers within the valid ranges.
+            If `days`, `hour`, `minute`, or `second` are not integers within the valid ranges.
 
         Notes
         -----
-        The event will be triggered once per day at the specified time, within the optional
+        The event will be triggered every `days` days at the specified time, within the optional
         scheduling window defined by `start_date` and `end_date`. If a random delay (jitter)
         is set, it will be applied to the trigger.
         """
 
         # Validate that the days parameter is a positive integer.
         if not isinstance(days, int) or days <= 0:
-            raise CLIOrionisValueError("The interval must be a positive integer.")
+            raise CLIOrionisValueError("Days must be a positive integer.")
 
         # Validate that hour, minute, and second are integers.
         if not isinstance(hour, int) or not isinstance(minute, int) or not isinstance(second, int):
@@ -2921,19 +2921,19 @@ class Event(IEvent):
         if not (0 <= second < 60):
             raise CLIOrionisValueError("Second must be between 0 and 59.")
 
-        # Set up the trigger to execute the event daily at the specified time.
-        # The IntervalTrigger will fire every day at the given hour, minute, and second.
-        self.__trigger = IntervalTrigger(
-            days=1,
+        # Set up the trigger to execute the event every N days at the specified time using CronTrigger.
+        self.__trigger = CronTrigger(
+            day=f"*/{days}",
             hour=hour,
             minute=minute,
             second=second,
             start_date=self.__start_date,
-            end_date=self.__end_date
+            end_date=self.__end_date,
+            jitter=self.__random_delay
         )
 
         # Store a human-readable description of the schedule.
-        self.__details = f"Every day at {hour:02d}:{minute:02d}:{second:02d}"
+        self.__details = f"Every {days} days at {hour:02d}:{minute:02d}:{second:02d}"
 
         # Indicate that the scheduling was successful.
         return True
@@ -3352,7 +3352,7 @@ class Event(IEvent):
 
     def everyMondayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3367,7 +3367,7 @@ class Event(IEvent):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3406,13 +3406,13 @@ class Event(IEvent):
         # Configure the trigger to execute the event every Monday at the specified hour, minute, and second.
         # The `CronTrigger` is used to specify the day of the week and time for the event.
         self.__trigger = CronTrigger(
-            day_of_week='mon',  # Schedule the event for Mondays.
-            hour=hour,          # Set the hour of execution.
-            minute=minute,      # Set the minute of execution.
-            second=second,      # Set the second of execution.
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay (jitter) if configured.
+            day_of_week='mon',                  # Schedule the event for Mondays.
+            hour=hour,                          # Set the hour of execution.
+            minute=minute,                      # Set the minute of execution.
+            second=second,                      # Set the second of execution.
+            start_date=self.__start_date,       # Restrict the schedule start if set.
+            end_date=self.__end_date,           # Restrict the schedule end if set.
+            jitter=self.__random_delay          # Apply random delay (jitter) if configured.
         )
 
         # Store a human-readable description of the schedule.
@@ -3423,7 +3423,7 @@ class Event(IEvent):
 
     def everyTuesdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3438,7 +3438,7 @@ class Event(IEvent):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3476,13 +3476,13 @@ class Event(IEvent):
 
         # Configure the trigger to execute the event every Tuesday at the specified hour, minute, and second.
         self.__trigger = CronTrigger(
-            day_of_week='tue',  # Schedule the event for Tuesdays.
-            hour=hour,          # Set the hour of execution.
-            minute=minute,      # Set the minute of execution.
-            second=second,      # Set the second of execution.
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay (jitter) if configured.
+            day_of_week='tue',                  # Schedule the event for Tuesdays.
+            hour=hour,                          # Set the hour of execution.
+            minute=minute,                      # Set the minute of execution.
+            second=second,                      # Set the second of execution.
+            start_date=self.__start_date,       # Restrict the schedule start if set.
+            end_date=self.__end_date,           # Restrict the schedule end if set.
+            jitter=self.__random_delay          # Apply random delay (jitter) if configured.
         )
 
         # Store a human-readable description of the schedule.
@@ -3493,7 +3493,7 @@ class Event(IEvent):
 
     def everyWednesdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3508,7 +3508,7 @@ class Event(IEvent):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3546,13 +3546,13 @@ class Event(IEvent):
 
         # Configure the trigger to execute the event every Wednesday at the specified hour, minute, and second.
         self.__trigger = CronTrigger(
-            day_of_week='wed',  # Schedule the event for Wednesdays.
-            hour=hour,          # Set the hour of execution.
-            minute=minute,      # Set the minute of execution.
-            second=second,      # Set the second of execution.
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay (jitter) if configured.
+            day_of_week='wed',                  # Schedule the event for Wednesdays.
+            hour=hour,                          # Set the hour of execution.
+            minute=minute,                      # Set the minute of execution.
+            second=second,                      # Set the second of execution.
+            start_date=self.__start_date,       # Restrict the schedule start if set.
+            end_date=self.__end_date,           # Restrict the schedule end if set.
+            jitter=self.__random_delay          # Apply random delay (jitter) if configured.
         )
 
         # Store a human-readable description of the schedule.
@@ -3563,7 +3563,7 @@ class Event(IEvent):
 
     def everyThursdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3578,7 +3578,7 @@ class Event(IEvent):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3616,13 +3616,13 @@ class Event(IEvent):
 
         # Configure the trigger to execute the event every Thursday at the specified hour, minute, and second.
         self.__trigger = CronTrigger(
-            day_of_week='thu',  # Schedule the event for Thursdays.
-            hour=hour,          # Set the hour of execution.
-            minute=minute,      # Set the minute of execution.
-            second=second,      # Set the second of execution.
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay (jitter) if configured.
+            day_of_week='thu',                  # Schedule the event for Thursdays.
+            hour=hour,                          # Set the hour of execution.
+            minute=minute,                      # Set the minute of execution.
+            second=second,                      # Set the second of execution.
+            start_date=self.__start_date,       # Restrict the schedule start if set.
+            end_date=self.__end_date,           # Restrict the schedule end if set.
+            jitter=self.__random_delay          # Apply random delay (jitter) if configured.
         )
 
         # Store a human-readable description of the schedule.
@@ -3633,7 +3633,7 @@ class Event(IEvent):
 
     def everyFridayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3648,7 +3648,7 @@ class Event(IEvent):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3686,13 +3686,13 @@ class Event(IEvent):
 
         # Configure the trigger to execute the event every Friday at the specified hour, minute, and second.
         self.__trigger = CronTrigger(
-            day_of_week='fri',  # Schedule the event for Fridays.
-            hour=hour,          # Set the hour of execution.
-            minute=minute,      # Set the minute of execution.
-            second=second,      # Set the second of execution.
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay (jitter) if configured.
+            day_of_week='fri',                  # Schedule the event for Fridays.
+            hour=hour,                          # Set the hour of execution.
+            minute=minute,                      # Set the minute of execution.
+            second=second,                      # Set the second of execution.
+            start_date=self.__start_date,       # Restrict the schedule start if set.
+            end_date=self.__end_date,           # Restrict the schedule end if set.
+            jitter=self.__random_delay          # Apply random delay (jitter) if configured.
         )
 
         # Store a human-readable description of the schedule.
@@ -3703,7 +3703,7 @@ class Event(IEvent):
 
     def everySaturdayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3718,7 +3718,7 @@ class Event(IEvent):
         Parameters
         ----------
         hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3773,7 +3773,7 @@ class Event(IEvent):
 
     def everySundayAt(
         self,
-        hour: int = 0,
+        hour: int,
         minute: int = 0,
         second: int = 0
     ) -> bool:
@@ -3787,8 +3787,8 @@ class Event(IEvent):
 
         Parameters
         ----------
-        hour : int, optional
-            The hour of the day when the event should run. Must be in the range [0, 23]. Default is 0.
+        hour : int
+            The hour of the day when the event should run. Must be in the range [0, 23].
         minute : int, optional
             The minute of the hour when the event should run. Must be in the range [0, 59]. Default is 0.
         second : int, optional
@@ -3826,13 +3826,13 @@ class Event(IEvent):
 
         # Configure the trigger to execute the event every Sunday at the specified hour, minute, and second.
         self.__trigger = CronTrigger(
-            day_of_week='sun',  # Schedule the event for Sundays.
-            hour=hour,          # Set the hour of execution.
-            minute=minute,      # Set the minute of execution.
-            second=second,      # Set the second of execution.
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay (jitter) if configured.
+            day_of_week='sun',                  # Schedule the event for Sundays.
+            hour=hour,                          # Set the hour of execution.
+            minute=minute,                      # Set the minute of execution.
+            second=second,                      # Set the second of execution.
+            start_date=self.__start_date,       # Restrict the schedule start if set.
+            end_date=self.__end_date,           # Restrict the schedule end if set.
+            jitter=self.__random_delay          # Apply random delay (jitter) if configured.
         )
 
         # Store a human-readable description of the schedule.
@@ -3864,13 +3864,15 @@ class Event(IEvent):
         be applied to the trigger.
         """
 
-        # Configure the trigger to execute the event every week using an IntervalTrigger.
-        # Apply any configured start_date, end_date, and random_delay (jitter).
-        self.__trigger = IntervalTrigger(
-            weeks=1,
-            start_date=self.__start_date,  # Restrict the schedule start if set.
-            end_date=self.__end_date,      # Restrict the schedule end if set.
-            jitter=self.__random_delay     # Apply random delay if configured.
+        # Configure the trigger to execute the event every week.
+        self.__trigger = CronTrigger(
+            day_of_week='sun',
+            hour=0,
+            minute=0,
+            second=0,
+            start_date=self.__start_date,
+            end_date=self.__end_date,
+            jitter=self.__random_delay
         )
 
         # Store a human-readable description of the schedule for reference or logging.

orionis/console/tasks/schedule.py

@@ -72,6 +72,13 @@ class Schedule(ISchedule):
             and prepares all required internal structures for scheduling and event handling.
         """
 
+        # List of operations that can be performed on the scheduler
+        self.__operations = [
+            'schedule:pause',
+            'schedule:resume',
+            'schedule:shutdown'
+        ]
+
         # Store the application instance for configuration and service access.
         self.__app: IApplication = app
 
@@ -1342,12 +1349,13 @@ class Schedule(ISchedule):
 
             # Iterate through each job and attempt to pause it
             for job in all_jobs:
+
                 try:
                     # Get the job ID safely
                     job_id = self.__getAttribute(job, 'id', None)
 
-                    # Skip jobs without a valid ID
-                    if not job_id:
+                    # Skip jobs without a valid user-defined ID (ignore system/operation jobs)
+                    if not job_id or not isinstance(job_id, str) or job_id.strip() == "" or job_id in self.__operations:
                         continue
 
                     # Pause the job in the scheduler
@@ -1909,6 +1917,24 @@ class Schedule(ISchedule):
         # Return True if the scheduler is running, otherwise False
         return self.__scheduler.running
 
+    def isPaused(self) -> bool:
+        """
+        Check if the scheduler is currently paused.
+
+        This method determines whether the scheduler is in a paused state by checking if there are
+        any jobs that were paused using the `pause` method. If there are jobs in the internal set
+        `__pausedByPauseEverything`, it indicates that the scheduler has been paused.
+
+        Returns
+        -------
+        bool
+            True if the scheduler is currently paused (i.e., there are jobs in the paused set);
+            False otherwise.
+        """
+
+        # The scheduler is considered paused if there are any jobs in the paused set
+        return len(self.__pausedByPauseEverything) > 0
+
     def forceStop(self) -> None:
         """
         Forcefully stop the scheduler immediately, bypassing graceful shutdown.

orionis/metadata/framework.py

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

{orionis-0.621.0.dist-info → orionis-0.622.0.dist-info}/METADATA

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

{orionis-0.621.0.dist-info → orionis-0.622.0.dist-info}/RECORD

@@ -24,12 +24,12 @@ orionis/console/contracts/cli_request.py,sha256=qIV8ig8PG39LYp1acnUD8GYsNRSHncxI
 orionis/console/contracts/command.py,sha256=Wvm62hw2gDIPNmoEUFyhKUERjZ6wnAbI-UDY_5gJE24,3626
 orionis/console/contracts/console.py,sha256=phaQhCLWa81MLzB5ydOSaUfEIdDq7fOjvym8Rmi-arc,11908
 orionis/console/contracts/debug.py,sha256=tEdF3_HJwDAgccXVEk_LGf43Am2ylbcx9i0Qvj3MFyU,1011
-orionis/console/contracts/event.py,sha256=Iu03z04ujkiYl6DksYT8QVXSJGabd5T_5dT67UozeCw,119978
+orionis/console/contracts/event.py,sha256=KQESAycPzBE3xoDTnbYLz_XXg-7dwrybYKbaJjgkCMY,119842
 orionis/console/contracts/executor.py,sha256=JAzK64_5HfIGm3_BwsUv7-ZeC2Y-3mpxOByHaXwuy9A,4278
 orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
 orionis/console/contracts/progress_bar.py,sha256=NYebL2h-vg2t2H6IhJjuC37gglRkpT-MW71wbJtpLNg,1784
 orionis/console/contracts/reactor.py,sha256=iT6ShoCutAWEeJzOf_PK7CGXi9TgrOD5tewHFVQ2NQw,6075
-orionis/console/contracts/schedule.py,sha256=CHZ0qf9awMqy19uqNeDr-mNqqRc4X961kLcA0m0exLs,13080
+orionis/console/contracts/schedule.py,sha256=xtXgp4BPhvhg3YSM4mrIdbyoBdr4OJBi1gBM_kJN5UQ,13694
 orionis/console/contracts/schedule_event_listener.py,sha256=h06qsBxuEMD3KLSyu0JXdUDHlQW19BX9lA09Qrh2QXg,3818
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/core/reactor.py,sha256=6scyrKukt6BEcLBxIrfAKA8QYnvNTl2dXePw6IWGPUw,43831
@@ -55,7 +55,7 @@ orionis/console/exceptions/__init__.py,sha256=rY9PE85TO_HpI5cfGWbZSDzk5aOUjErqBZ
 orionis/console/exceptions/cli_exceptions.py,sha256=nk3EGkRheDbw8vrxKgUxkAAPA6gPpO2dE5nDeVHJHA0,3580
 orionis/console/fluent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/fluent/command.py,sha256=0jyhB45LIjDS7nkjNhkkvEXEzdOBmT49qKIooYY_DbI,8261
-orionis/console/fluent/event.py,sha256=kEynb0mQDyEiTiEnctoJoPizFfe0TkySOsMaECob3UY,166495
+orionis/console/fluent/event.py,sha256=RM6Aaz-2MYQg4RWxYdr6oBNaAjNVp9DE_tI5iwl2mAk,166672
 orionis/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/output/console.py,sha256=EtSDWRBW8wk0iJdPfB1mzU49krLJBaSAUdVdVOzzhQ4,17888
 orionis/console/output/executor.py,sha256=uQjFPOlyZLFj9pcyYPugCqxwJog0AJgK1OcmQH2ELbw,7314
@@ -64,7 +64,7 @@ orionis/console/request/cli_request.py,sha256=lO7088xlVK1VP-NhCIgAo7qXGzCW3nXVOJ
 orionis/console/stub/command.stub,sha256=IfQ0bTrpataVFcT1ZdHyyiYNZ67D5Aox_QvgVJLeJnI,1240
 orionis/console/stub/listener.stub,sha256=DbX-ghx2-vb73kzQ6L20lyg5vSKn58jSLTwFuwNQU9k,4331
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/schedule.py,sha256=0P600_2JiA3ON9gqKNruEBGlQpMCGZW10pw3pXqH0bI,86912
+orionis/console/tasks/schedule.py,sha256=Evlqlz-hsOyEzPrkuHApYlG-aBputrShBkIMmdLaqnw,87976
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/container.py,sha256=yfhRs85YpPvqGRfrjblkHEuZGCN0BijremI-3r1Epak,96842
 orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -216,7 +216,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=lbvbicyGSvxD7hHMZszvxPibTTbu-sMZ5D2ru8djvdU,4109
+orionis/metadata/framework.py,sha256=3c636E6HS3G-0vSPyERKJhYAs2M_GaVvVTYQLZ72LEE,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
@@ -403,8 +403,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.621.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.621.0.dist-info/METADATA,sha256=G6IePwko5jyIq0Ywu5X5uSepzFGUM_mTQZDvfAbs6E4,4801
-orionis-0.621.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.621.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.621.0.dist-info/RECORD,,
+orionis-0.622.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.622.0.dist-info/METADATA,sha256=Xgen5LEVWbhYuZ6eyXEoGmwo-GV4mGJR5lZSOfDOxtQ,4801
+orionis-0.622.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.622.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.622.0.dist-info/RECORD,,