orionis 0.512.0__tar.gz → 0.513.0__tar.gz

{orionis-0.512.0/orionis.egg-info → orionis-0.513.0}/PKG-INFO

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

{orionis-0.512.0 → orionis-0.513.0}/orionis/console/base/command.py

@@ -2,7 +2,7 @@ from typing import Any, Dict, List
 from orionis.console.args.argument import CLIArgument
 from orionis.console.dynamic.progress_bar import ProgressBar
 from orionis.console.output.console import Console
-from orionis.console.base.contracts.command import IBaseCommand
+from orionis.console.contracts.command import IBaseCommand
 
 class BaseCommand(Console, ProgressBar, IBaseCommand):
     """

{orionis-0.512.0 → orionis-0.513.0}/orionis/console/base/scheduler.py

@@ -1,5 +1,5 @@
 from datetime import datetime
-from orionis.console.base.contracts.scheduler import IBaseScheduler
+from orionis.console.contracts.scheduler import IBaseScheduler
 from orionis.console.contracts.schedule import ISchedule
 
 class BaseScheduler(IBaseScheduler):

{orionis-0.512.0 → orionis-0.513.0}/orionis/console/contracts/schedule_event_listener.py

@@ -1,5 +1,4 @@
 from abc import ABC, abstractmethod
-from typing import TYPE_CHECKING
 from orionis.console.entities.job_error import JobError
 from orionis.console.entities.job_executed import JobExecuted
 from orionis.console.entities.job_max_instances import JobMaxInstances
@@ -9,9 +8,6 @@ from orionis.console.entities.job_removed import JobRemoved
 from orionis.console.entities.job_resume import JobResume
 from orionis.console.entities.job_submitted import JobSubmitted
 
-if TYPE_CHECKING:
-    from orionis.console.contracts.schedule import ISchedule
-
 class IScheduleEventListener(ABC):
     """
     Interface for event listeners that handle various stages of event processing.

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

@@ -0,0 +1,140 @@
+from abc import ABC, abstractmethod
+from datetime import datetime
+from orionis.console.contracts.schedule import ISchedule
+
+class IBaseScheduler(ABC):
+
+    # 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
+
+    @abstractmethod
+    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. 
+            This object provides methods to add tasks to the scheduler.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is intended to be overridden
+            by subclasses to specify scheduled tasks.
+
+        Notes
+        -----
+        This method serves as a contract for subclasses to implement task registration
+        logic. Subclasses should use the provided `schedule` object to define and
+        register tasks that the scheduler will execute.
+        """
+        # Abstract method to be implemented by subclasses for task registration
+        pass
+
+    @abstractmethod
+    def onStarted(self):
+        """
+        Called when the scheduler is started.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Subclasses should override this method to implement custom behavior that
+        should occur when the scheduler starts running. This can include initializing
+        resources or logging the start event.
+        """
+        # Abstract method to define behavior when the scheduler starts
+        pass
+
+    @abstractmethod
+    def onPaused(self):
+        """
+        Called when the scheduler is paused.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Subclasses should override this method to define custom behavior that occurs
+        when the scheduler enters a paused state. This can include saving the current
+        state or logging the pause event.
+        """
+        # Abstract method to define behavior when the scheduler is paused
+        pass
+
+    @abstractmethod
+    def onResumed(self):
+        """
+        Called when the scheduler is resumed from a paused state.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Subclasses should override this method to implement any actions that need to
+        occur when the scheduler resumes operation. This can include restoring the
+        state or logging the resume event.
+        """
+        # Abstract method to define behavior when the scheduler is resumed
+        pass
+
+    @abstractmethod
+    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
+        -----
+        Subclasses can override this method to perform any necessary cleanup or
+        finalization tasks, such as releasing resources or logging the finalization
+        event.
+        """
+        # Abstract method to define behavior when the scheduler is finalized
+        pass
+
+    @abstractmethod
+    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
+        -----
+        Subclasses can override this method to implement custom error handling logic
+        for the scheduler. This can include logging the error, notifying stakeholders,
+        or attempting to recover from the error.
+        """
+        # Abstract method to define behavior for handling errors in the scheduler
+        pass

{orionis-0.512.0 → orionis-0.513.0}/orionis/console/core/reactor.py

@@ -4,7 +4,7 @@ import re
 from typing import Any, List, Optional
 from orionis.console.args.argument import CLIArgument
 from orionis.console.base.command import BaseCommand
-from orionis.console.base.contracts.command import IBaseCommand
+from orionis.console.contracts.command import IBaseCommand
 from orionis.console.contracts.reactor import IReactor
 from orionis.console.enums.command import Command
 from orionis.console.exceptions import CLIOrionisValueError

{orionis-0.512.0 → orionis-0.513.0}/orionis/console/tasks/schedule.py

@@ -121,13 +121,9 @@ class Scheduler(ISchedule):
             formatted as "YYYY-MM-DD HH:MM:SS".
         """
 
-        # Get the current time in the configured timezone
-        now = pytz.timezone(self.__app.config('app.timezone', 'UTC')).localize(
-            pytz.datetime.datetime.now()
-        )
-
-        # Return the formatted date and time string
-        return now.strftime('%Y-%m-%d %H:%M:%S')
+        tz = pytz.timezone(self.__app.config("app.timezone", "UTC"))
+        now = datetime.now(tz)
+        return now.strftime("%Y-%m-%d %H:%M:%S")
 
     def __suscribeListeners(
         self
@@ -210,25 +206,24 @@ class Scheduler(ISchedule):
 
         # Display a start message for the scheduler worker on the rich console
         # Add a blank line for better formatting
-        if self.__app.config('app.debug', False):
-            self.__rich_console.line()
-            panel_content = Text.assemble(
-                (" Orionis Scheduler Worker ", "bold white on green"),                      # Header text with styling
-                ("\n\n", ""),                                                               # Add spacing
-                ("The scheduled tasks worker has started successfully.\n", "white"),        # Main message
-                (f"Started at: {now}\n", "dim"),                                            # Display the start time in dim text
-                ("To stop the worker, press ", "white"),                                    # Instruction text
-                ("Ctrl+C", "bold yellow"),                                                  # Highlight the key combination
-                (".", "white")                                                              # End the instruction
-            )
-
-            # Display the message in a styled panel
-            self.__rich_console.print(
-                Panel(panel_content, border_style="green", padding=(1, 2))
-            )
-
-            # Add another blank line for better formatting
-            self.__rich_console.line()
+        self.__rich_console.line()
+        panel_content = Text.assemble(
+            (" Orionis Scheduler Worker ", "bold white on green"),                      # Header text with styling
+            ("\n\n", ""),                                                               # Add spacing
+            ("The scheduled tasks worker has started successfully.\n", "white"),        # Main message
+            (f"Started at: {now}\n", "dim"),                                            # Display the start time in dim text
+            ("To stop the worker, press ", "white"),                                    # Instruction text
+            ("Ctrl+C", "bold yellow"),                                                  # Highlight the key combination
+            (".", "white")                                                              # End the instruction
+        )
+
+        # Display the message in a styled panel
+        self.__rich_console.print(
+            Panel(panel_content, border_style="green", padding=(1, 2))
+        )
+
+        # Add another blank line for better formatting
+        self.__rich_console.line()
 
         # Retrieve the global identifier for the scheduler started event
         scheduler_started = ListeningEvent.SCHEDULER_STARTED.value

{orionis-0.512.0 → orionis-0.513.0}/orionis/foundation/application.py

@@ -2,7 +2,7 @@ import asyncio
 import time
 from pathlib import Path
 from typing import Any, List, Type
-from orionis.console.base.contracts.scheduler import IBaseScheduler
+from orionis.console.contracts.scheduler import IBaseScheduler
 from orionis.console.base.scheduler import BaseScheduler
 from orionis.container.container import Container
 from orionis.container.contracts.service_provider import IServiceProvider

{orionis-0.512.0 → orionis-0.513.0}/orionis/metadata/framework.py

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

{orionis-0.512.0 → orionis-0.513.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.512.0 → orionis-0.513.0}/orionis.egg-info/SOURCES.txt

@@ -20,9 +20,6 @@ orionis/console/base/__init__.py
 orionis/console/base/command.py
 orionis/console/base/scheduler.py
 orionis/console/base/scheduler_event_listener.py
-orionis/console/base/contracts/__init__.py
-orionis/console/base/contracts/command.py
-orionis/console/base/contracts/scheduler.py
 orionis/console/commands/__init__.py
 orionis/console/commands/cache.py
 orionis/console/commands/help.py
@@ -33,11 +30,13 @@ orionis/console/commands/test.py
 orionis/console/commands/version.py
 orionis/console/commands/workflow.py
 orionis/console/contracts/__init__.py
+orionis/console/contracts/command.py
 orionis/console/contracts/event.py
 orionis/console/contracts/kernel.py
 orionis/console/contracts/reactor.py
 orionis/console/contracts/schedule.py
 orionis/console/contracts/schedule_event_listener.py
+orionis/console/contracts/scheduler.py
 orionis/console/core/__init__.py
 orionis/console/core/reactor.py
 orionis/console/dumper/__init__.py

orionis-0.512.0/orionis/console/base/contracts/scheduler.py

@@ -1,38 +0,0 @@
-from abc import ABC, abstractmethod
-from datetime import datetime
-from orionis.console.contracts.schedule import ISchedule
-
-class IBaseScheduler(ABC):
-
-    # 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
-
-    @abstractmethod
-    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.
-
-        Notes
-        -----
-        This method should be implemented in subclasses to add specific tasks
-        to the scheduler using the provided `schedule` object.
-        """
-        # This method should be overridden in subclasses to define scheduled tasks.
-        pass