orionis 0.523.0__py3-none-any.whl → 0.524.0__py3-none-any.whl

orionis/console/tasks/schedule.py

@@ -1,7 +1,7 @@
 import asyncio
 from datetime import datetime
 import logging
-from typing import Dict, List, Optional, Union
+from typing import Any, Awaitable, Callable, Dict, List, Optional, Union
 import pytz
 from apscheduler.triggers.date import DateTrigger
 from apscheduler.events import (
@@ -401,7 +401,7 @@ class Scheduler(ISchedule):
                         except RuntimeError:
 
                             # Message indicating that the listener could not be invoked
-                            error_msg = f"Cannot run async listener for '{scheduler_event}': no event loop running"
+                            error_msg = f"Cannot run listener for '{scheduler_event}': no event loop running"
 
                             # Log the error message
                             self.__logger.error(error_msg)
@@ -600,74 +600,6 @@ class Scheduler(ISchedule):
         # Log an informational message indicating that the scheduler has started
         self.__logger.info(f"Orionis Scheduler started successfully at {now}.")
 
-    def __pausedListener(
-        self,
-        event: SchedulerPaused
-    ) -> None:
-        """
-        Handle the scheduler paused event for logging and invoking registered listeners.
-
-        This method is triggered when the scheduler is paused. It logs an informational
-        message indicating that the scheduler has been paused successfully and displays
-        a formatted message on the rich console. If a listener is registered for the
-        scheduler paused event, it invokes the listener with the event details.
-
-        Parameters
-        ----------
-        event : SchedulerPaused
-            An event object containing details about the scheduler paused event.
-
-        Returns
-        -------
-        None
-            This method does not return any value. It performs logging, displays
-            a message on the console, and invokes any registered listener for the
-            scheduler paused event.
-        """
-
-        # Get the current time in the configured timezone
-        now = self.__getCurrentTime()
-
-        # Check if a listener is registered for the scheduler paused event
-        self.__globalCallableListener(event, ListeningEvent.SCHEDULER_PAUSED)
-
-        # Log an informational message indicating that the scheduler has been paused
-        self.__logger.info(f"Orionis Scheduler paused successfully at {now}.")
-
-    def __resumedListener(
-        self,
-        event: SchedulerResumed
-    ) -> None:
-        """
-        Handle the scheduler resumed event for logging and invoking registered listeners.
-
-        This method is triggered when the scheduler resumes from a paused state. It logs an informational
-        message indicating that the scheduler has resumed successfully and displays a formatted message
-        on the rich console. If a listener is registered for the scheduler resumed event, it invokes
-        the listener with the event details.
-
-        Parameters
-        ----------
-        event : SchedulerResumed
-            An event object containing details about the scheduler resumed event.
-
-        Returns
-        -------
-        None
-            This method does not return any value. It performs logging, displays
-            a message on the console, and invokes any registered listener for the
-            scheduler resumed event.
-        """
-
-        # Get the current time in the configured timezone
-        now = self.__getCurrentTime()
-
-        # Check if a listener is registered for the scheduler resumed event
-        self.__globalCallableListener(event, ListeningEvent.SCHEDULER_RESUMED)
-
-        # Log an informational message indicating that the scheduler has resumed
-        self.__logger.info(f"Orionis Scheduler resumed successfully at {now}.")
-
     def __shutdownListener(
         self,
         event: SchedulerShutdown
@@ -1038,6 +970,53 @@ class Scheduler(ISchedule):
         # Register the listener for the specified event in the internal listeners dictionary
         self.__listeners[event] = listener
 
+    def wrapAsyncFunction(
+        self,
+        func: Callable[..., Awaitable[Any]]
+    ) -> Callable[..., Any]:
+        """
+        Wrap an asynchronous function to be called in a synchronous context.
+
+        This method takes an asynchronous function (a coroutine) and returns a synchronous
+        wrapper function that can be called in a non-async context. The wrapper function
+        ensures that the asynchronous function is executed within the appropriate event loop.
+
+        Parameters
+        ----------
+        func : Callable[..., Awaitable[Any]]
+            The asynchronous function (coroutine) to be wrapped. This function should be
+            defined using the `async def` syntax and return an awaitable object.
+
+        Returns
+        -------
+        Callable[..., Any]
+            A synchronous wrapper function that can be called in a non-async context.
+            When invoked, this wrapper will execute the original asynchronous function
+            within the appropriate event loop.
+
+        Raises
+        ------
+        ValueError
+            If the provided `func` is not an asynchronous function (coroutine).
+        """
+
+        # Define a synchronous wrapper function
+        def sync_wrapper(*args, **kwargs) -> Any:
+            try:
+                # Try to get the current event loop
+                loop = asyncio.get_event_loop()
+                if loop.is_running():
+                    # If the loop is already running, create a task for the coroutine
+                    return asyncio.create_task(func(*args, **kwargs))
+                else:
+                    # If the loop is not running, run the coroutine until complete
+                    return loop.run_until_complete(func(*args, **kwargs))
+            except RuntimeError:
+                # If no event loop exists, create a new one and run the coroutine
+                return asyncio.run(func(*args, **kwargs))
+
+        return sync_wrapper
+
     def pauseEverythingAt(
         self,
         at: datetime
@@ -1073,8 +1052,8 @@ class Scheduler(ISchedule):
         if not isinstance(at, datetime):
             raise ValueError("The 'at' parameter must be a datetime object.")
 
-        # Define a function to pause the scheduler
-        def schedule_pause():
+        # Define an async function to pause the scheduler
+        async def schedule_pause():
 
             # Only pause jobs if the scheduler is currently running
             if self.isRunning():
@@ -1105,13 +1084,14 @@ class Scheduler(ISchedule):
                             self.__scheduler.pause_job(job.id)
                             self.__paused_by_pause_everything.add(job.id)
 
-                            # Excute the paused listener
-                            self.__pausedListener(JobPause(
-                                code=EVENT_SCHEDULER_PAUSED,
-                                job_id=job.id if hasattr(job, 'id') else None,
-                                alias=job.name if hasattr(job, 'name') else None,
-                                jobstore=job.jobstore if hasattr(job, 'jobstore') else None,
-                            ))
+                            # Execute the task callable listener
+                            self.__globalCallableListener(SchedulerPaused(EVENT_SCHEDULER_PAUSED), ListeningEvent.SCHEDULER_PAUSED)
+
+                            # Get the current time in the configured timezone
+                            now = self.__getCurrentTime()
+
+                            # Log an informational message indicating that the scheduler has resumed
+                            self.__logger.info(f"Orionis Scheduler resumed successfully at {now}.")
 
                         except Exception as e:
 
@@ -1133,7 +1113,7 @@ class Scheduler(ISchedule):
 
             # Add a job to the scheduler to pause it at the specified datetime
             self.__scheduler.add_job(
-                func=schedule_pause,                            # Function to pause the scheduler
+                func=self.wrapAsyncFunction(schedule_pause),    # Function to pause the scheduler
                 trigger=DateTrigger(run_date=at),               # Trigger type is 'date' for one-time execution
                 id="scheduler_pause_at",                        # Unique job ID for pausing the scheduler
                 name="Pause Scheduler",                         # Descriptive name for the job
@@ -1183,8 +1163,8 @@ class Scheduler(ISchedule):
         if not isinstance(at, datetime):
             raise ValueError("The 'at' parameter must be a datetime object.")
 
-        # Define a function to resume the scheduler
-        def schedule_resume():
+        # Define an async function to resume the scheduler
+        async def schedule_resume():
 
             # Only resume jobs if the scheduler is currently running
             if self.isRunning():
@@ -1201,11 +1181,14 @@ class Scheduler(ISchedule):
                             self.__scheduler.resume_job(job_id)
                             self.__logger.info(f"User job '{job_id}' has been resumed.")
 
-                            # Excute the resumed listener
-                            self.__resumedListener(JobResume(
-                                code=EVENT_SCHEDULER_RESUMED,
-                                job_id=job_id
-                            ))
+                            # Execute the task callable listener
+                            self.__globalCallableListener(SchedulerResumed(EVENT_SCHEDULER_RESUMED), ListeningEvent.SCHEDULER_RESUMED)
+
+                            # Get the current time in the configured timezone
+                            now = self.__getCurrentTime()
+
+                            # Log an informational message indicating that the scheduler has been paused
+                            self.__logger.info(f"Orionis Scheduler paused successfully at {now}.")
 
                         except Exception as e:
 
@@ -1230,7 +1213,7 @@ class Scheduler(ISchedule):
 
             # Add a job to the scheduler to resume it at the specified datetime
             self.__scheduler.add_job(
-                func=schedule_resume,                           # Function to resume the scheduler
+                func=self.wrapAsyncFunction(schedule_resume),   # Function to resume the scheduler
                 trigger=DateTrigger(run_date=at),               # Trigger type is 'date' for one-time execution
                 id="scheduler_resume_at",                       # Unique job ID for resuming the scheduler
                 name="Resume Scheduler",                        # Descriptive name for the job

orionis/metadata/framework.py

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

{orionis-0.523.0.dist-info → orionis-0.524.0.dist-info}/METADATA

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

{orionis-0.523.0.dist-info → orionis-0.524.0.dist-info}/RECORD

@@ -81,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=l4J-HEPaj1mxB_PYQMgG9dRHUe01wUag8fKLLnR2N2M,164395
 orionis/console/tasks/listener.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/schedule.py,sha256=QQtETxI_SrApPN6JlyWgWB3ExkR3w2iFgeR-UCEV8fA,77612
+orionis/console/tasks/schedule.py,sha256=gaH9YSoYDQOTTktEaFyk5OIFUQz-jtkpzQJfKHs6hf4,77213
 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
@@ -239,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=JjXMnmgYxlzZmmwSkOaQe2TZAI5nx3vfWRDzNbUMKVM,4109
+orionis/metadata/framework.py,sha256=TVYmpZeUzyz9k7416c1ZPMT-vPrPgTbht4x1iJwTmu4,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
@@ -417,7 +417,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.523.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.524.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
@@ -563,8 +563,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.523.0.dist-info/METADATA,sha256=628aQJLd-wjZTMQT2KZF_n4t8gWzcu36dWBrrTQWEpw,4801
-orionis-0.523.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.523.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.523.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.523.0.dist-info/RECORD,,
+orionis-0.524.0.dist-info/METADATA,sha256=YIVkp5NLpvcgxHQzPTGxREf3MOnCRs65C-f4QkJPAuI,4801
+orionis-0.524.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.524.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.524.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.524.0.dist-info/RECORD,,