orionis 0.512.0__py3-none-any.whl → 0.513.0__py3-none-any.whl

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/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/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/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/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/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/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/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.dist-info → orionis-0.513.0.dist-info}/METADATA

@@ -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.dist-info → orionis-0.513.0.dist-info}/RECORD

@@ -7,12 +7,9 @@ orionis/console/args/argument.py,sha256=Is8Z8_kW4DvcK1nK1UU-sa6Pk0BeOdcRczCayW0Z
 orionis/console/args/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/args/enums/actions.py,sha256=S3T-vWS6DJSGtANrq3od3-90iYAjPvJwaOZ2V02y34c,1222
 orionis/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/base/command.py,sha256=nasVPyKEvuv8sDFEWXhHyBCWAmSLfPPm2XlKaYYt_pM,6642
-orionis/console/base/scheduler.py,sha256=lUHd83YhpsojxcCDme2e9Gcw6ebnsdRFgny4MKH5-rc,3380
+orionis/console/base/command.py,sha256=OM4xqVgpv_1RZVyVG8BzOHl1sP9FT5mPUwZjMil8IRg,6637
+orionis/console/base/scheduler.py,sha256=5B1msuEwvEdaUIFzaLU8-QtfrbqduIkXfM7pubWhoZg,3375
 orionis/console/base/scheduler_event_listener.py,sha256=m3p55Zz7HrMxGU3S3oMaMG58YPSRXPJUVCh4Ky7GFR8,4062
-orionis/console/base/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/base/contracts/command.py,sha256=vmAJD0yMQ5-AD_s9_xCFEAl64sKk65z7U2E196dALQM,5760
-orionis/console/base/contracts/scheduler.py,sha256=y8q4qv6oxjnWSt9G0HP2IjogtWIASfJaMO5vkG22U1Q,1184
 orionis/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/commands/cache.py,sha256=8DsYoRzSBLn0P9qkGVItRbo0R6snWBDBg0_Xa7tmVhs,2322
 orionis/console/commands/help.py,sha256=zfSw0pYaOnFN-_Ozdn4veBQDYMgSSDY10nPDCi-7tTY,3199
@@ -23,13 +20,15 @@ orionis/console/commands/test.py,sha256=-EmQwFwMBuby3OI9HwqMIwuJzd2CGbWbOqmwrR25
 orionis/console/commands/version.py,sha256=SUuNDJ40f2uq69OQUmPQXJKaa9Bm_iVRDPmBd7zc1Yc,3658
 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/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
 orionis/console/contracts/reactor.py,sha256=Xeq7Zrw6WE5MV_XOQfiQEchAFbb6-0TjLpjWOxYW--g,4554
 orionis/console/contracts/schedule.py,sha256=gMd_CS-W8d_pOX6dBjcqtYRL_rXzTWdzeg-WyrI2g7g,6260
-orionis/console/contracts/schedule_event_listener.py,sha256=dD88szDWcTSrIkMrZOlhGXB-m0jXQtKYEUZk5rxvGXY,13004
+orionis/console/contracts/schedule_event_listener.py,sha256=0HSQ49O-Wzyn0P3rrfP2xsfSioIAaCv3n_pgEkhyY1o,12887
+orionis/console/contracts/scheduler.py,sha256=90QoeoUGOLgLhzCKbWHpuAdWzmHiV1FQXrhzJajLMBA,4354
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=3i7-jn_HBwYfsNR8xpExt5Owi3nk9BfHnW7J7lUmb-4,30414
+orionis/console/core/reactor.py,sha256=JlxNiqmyzAqiS21hxOMD5ELiDNPzmGHYDNrdlaMvYuI,30409
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/dump.py,sha256=CATERiQ6XuIrKQsDaWcVxzTtlAJI9qLJX44fQxEX8ws,22443
 orionis/console/dumper/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -82,7 +81,7 @@ orionis/console/request/cli_request.py,sha256=7-sgYmNUCipuHLVAwWLJiHv0cJCDmsM1Lu
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/tasks/event.py,sha256=UhAIbSHueyykzny8SorxKbo8S-_TxP6jLhT-FuFyLL0,163405
 orionis/console/tasks/listener.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/schedule.py,sha256=1VOLwLxmnlFx7CehWPOgSBAxnoBkmCwkRYsGo9NgGvM,47138
+orionis/console/tasks/schedule.py,sha256=l9hgDMPIbkJi1O1K2GupZD-HD1ygYRPLPdcEbdVFQWM,46877
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/container.py,sha256=aF_b6lTUpG4YCo9yFJEzsntTdIzgMMXFW5LyWqAJVBQ,87987
 orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -124,7 +123,7 @@ orionis/failure/contracts/handler.py,sha256=4N9yMkMgdhtHbRGAyCtuTx3GmkPP74vhqdRL
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=ogys062uhim5QMYU62ezlnumRAnYQlUf_vZvQY47S3U,1227
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=4fkbnb2r7rfyn0_0JIX-wG-hRZzRVLQySWO7v4a_4e0,83797
+orionis/foundation/application.py,sha256=GmfLnpWuhX_6d1gzUk1v7jy_R72XpLJdA-hEOrXQn_Q,83792
 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
@@ -240,7 +239,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=72SoixFog9IOE9Ve9Xcfw6
 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=odvj4VtrkvwqfB9sDAmuu7FEiT6n79mgB5NQb05ME2A,4109
+orionis/metadata/framework.py,sha256=6NoNocgXwGzH22ftuxlsTj_szulwLBhp3y1YnjY2DoA,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
@@ -416,7 +415,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.512.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.513.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
@@ -562,8 +561,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.512.0.dist-info/METADATA,sha256=dkTy4zSWuTdWAIJ0UYihCTdOnHJyS7B9rf5sarLqOnA,4801
-orionis-0.512.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.512.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.512.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.512.0.dist-info/RECORD,,
+orionis-0.513.0.dist-info/METADATA,sha256=LGeTVazZK9z_4kIpNC0uuJfJJdbdbBzguVb-YRJ1x5c,4801
+orionis-0.513.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.513.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.513.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.513.0.dist-info/RECORD,,

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