orionis 0.589.0__py3-none-any.whl → 0.590.0__py3-none-any.whl

orionis/console/core/reactor.py

@@ -850,7 +850,8 @@ class Reactor(IReactor):
                 output = self.__app.call(command_instance, command.method)
 
                 # Calculate elapsed time and log completion with DONE state if command.timestamps are enabled
-                elapsed_time = round(self.__performance_counter.stop(), 2)
+                self.__performance_counter.stop()
+                elapsed_time = round(self.__performance_counter.getSeconds(), 2)
                 if command.timestamps:
                     self.__executer.done(program=signature, time=f"{elapsed_time}s")
 
@@ -866,7 +867,8 @@ class Reactor(IReactor):
                 self.__logger.error(f"Command '{signature}' execution failed: {e}")
 
                 # Calculate elapsed time and log failure with ERROR state if command.timestamps are enabled
-                elapsed_time = round(self.__performance_counter.stop(), 2)
+                self.__performance_counter.stop()
+                elapsed_time = round(self.__performance_counter.getSeconds(), 2)
                 if command.timestamps:
                     self.__executer.fail(program=signature, time=f"{elapsed_time}s")
 

orionis/metadata/framework.py

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

orionis/support/performance/contracts/counter.py

@@ -9,7 +9,7 @@ class IPerformanceCounter(ABC):
     """
 
     @abstractmethod
-    def start(self) -> float:
+    def start(self) -> 'IPerformanceCounter':
         """
         Start the performance counter.
 
@@ -18,13 +18,13 @@ class IPerformanceCounter(ABC):
 
         Returns
         -------
-        float
-            The timestamp (in fractional seconds) at which the counter was started.
+        IPerformanceCounter
+            The instance of the performance counter for method chaining.
         """
         pass
 
     @abstractmethod
-    def stop(self) -> float:
+    def stop(self) -> 'IPerformanceCounter':
         """
         Stop the performance counter and calculate the elapsed time.
 
@@ -32,9 +32,106 @@ class IPerformanceCounter(ABC):
         the elapsed time since `start()` was called. The elapsed time is the
         difference between the end and start timestamps.
 
+        Returns
+        -------
+        IPerformanceCounter
+            The instance of the performance counter for method chaining.
+        """
+        pass
+
+    @abstractmethod
+    def elapsedTime(self) -> float:
+        """
+        Get the elapsed time between the last start and stop calls.
+
+        This method returns the elapsed time calculated during the last
+        `stop()` call. If the counter has not been started and stopped,
+        it raises an exception.
+
+        Returns
+        -------
+        float
+            The elapsed time in seconds (as a float) between the last `start()` and `stop()` calls.
+
+        Raises
+        ------
+        ValueError
+            If the counter has not been started and stopped properly.
+        """
+        pass
+
+    @abstractmethod
+    def getMicroseconds(self) -> float:
+        """
+        Get the elapsed time in microseconds.
+
+        This method returns the elapsed time in microseconds by converting
+        the value obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in microseconds (as a float).
+        """
+        pass
+
+    @abstractmethod
+    def getMilliseconds(self) -> float:
+        """
+        Get the elapsed time in milliseconds.
+
+        This method returns the elapsed time in milliseconds by converting
+        the value obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in milliseconds (as a float).
+        """
+        pass
+
+    @abstractmethod
+    def getSeconds(self) -> float:
+        """
+        Get the elapsed time in seconds.
+
+        This method returns the elapsed time in seconds, which is the same
+        value as obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in seconds (as a float).
+        """
+        pass
+
+    @abstractmethod
+    def getMinutes(self) -> float:
+        """
+        Get the elapsed time in minutes.
+
+        This method returns the elapsed time in minutes by converting
+        the value obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in minutes (as a float).
+        """
+        pass
+
+    @abstractmethod
+    def restart(self) -> float:
+        """
+        Restart the performance counter.
+
+        This method resets the start and end times to None and starts the counter again.
+        It is useful for measuring a new interval without creating a new instance of
+        PerformanceCounter.
+
         Returns
         -------
         float
-            The elapsed time in seconds (as a float) between when `start()` and `stop()` were called.
+            The timestamp (in fractional seconds) at which the counter was restarted.
         """
         pass

orionis/support/performance/counter.py

@@ -49,7 +49,10 @@ class PerformanceCounter(IPerformanceCounter):
         # Time when the counter is stopped; initialized to None
         self.__end_time = None
 
-    def start(self) -> float:
+        # Difference between end time and start time; initialized to None
+        self.__diff_time = None
+
+    def start(self) -> 'PerformanceCounter':
         """
         Start the performance counter.
 
@@ -58,15 +61,15 @@ class PerformanceCounter(IPerformanceCounter):
 
         Returns
         -------
-        float
-            The timestamp (in fractional seconds) at which the counter was started.
+        IPerformanceCounter
+            The instance of the performance counter for method chaining.
         """
 
         # Record the current time as the start time
         self.__start_time = time.perf_counter()
-        return self.__start_time
+        return self
 
-    def stop(self) -> float:
+    def stop(self) -> 'PerformanceCounter':
         """
         Stop the performance counter and calculate the elapsed time.
 
@@ -76,12 +79,119 @@ class PerformanceCounter(IPerformanceCounter):
 
         Returns
         -------
-        float
-            The elapsed time in seconds (as a float) between when `start()` and `stop()` were called.
+        IPerformanceCounter
+            The instance of the performance counter for method chaining.
         """
 
         # Record the current time as the end time
         self.__end_time = time.perf_counter()
 
         # Calculate and return the elapsed time
-        return self.__end_time - self.__start_time
+        self.__diff_time = self.__end_time - self.__start_time
+        return self
+
+    def elapsedTime(self) -> float:
+        """
+        Get the elapsed time between the last start and stop calls.
+
+        This method returns the elapsed time calculated during the last
+        `stop()` call. If the counter has not been started and stopped,
+        it raises an exception.
+
+        Returns
+        -------
+        float
+            The elapsed time in seconds (as a float) between the last `start()` and `stop()` calls.
+
+        Raises
+        ------
+        ValueError
+            If the counter has not been started and stopped properly.
+        """
+
+        if self.__diff_time is None:
+            raise ValueError("Counter has not been started and stopped properly.")
+
+        return self.__diff_time
+
+    def getMicroseconds(self) -> float:
+        """
+        Get the elapsed time in microseconds.
+
+        This method returns the elapsed time in microseconds by converting
+        the value obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in microseconds (as a float).
+        """
+
+        return self.elapsedTime() * 1_000_000
+
+    def getMilliseconds(self) -> float:
+        """
+        Get the elapsed time in milliseconds.
+
+        This method returns the elapsed time in milliseconds by converting
+        the value obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in milliseconds (as a float).
+        """
+
+        return self.elapsedTime() * 1_000
+
+    def getSeconds(self) -> float:
+        """
+        Get the elapsed time in seconds.
+
+        This method returns the elapsed time in seconds, which is the same
+        value as obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in seconds (as a float).
+        """
+
+        return self.elapsedTime()
+
+    def getMinutes(self) -> float:
+        """
+        Get the elapsed time in minutes.
+
+        This method returns the elapsed time in minutes by converting
+        the value obtained from `elapsedTime()`.
+
+        Returns
+        -------
+        float
+            The elapsed time in minutes (as a float).
+        """
+
+        return self.elapsedTime() / 60
+
+    def restart(self) -> float:
+        """
+        Restart the performance counter.
+
+        This method resets the start and end times to None and starts the counter again.
+        It is useful for measuring a new interval without creating a new instance of
+        PerformanceCounter.
+
+        Returns
+        -------
+        float
+            The timestamp (in fractional seconds) at which the counter was restarted.
+        """
+
+        # Reset start and end times
+        self.__start_time = None
+        self.__end_time = None
+        self.__diff_time = None
+
+        # Start the counter again
+        return self.start()

orionis/test/core/unit_test.py

@@ -17,6 +17,7 @@ from orionis.foundation.config.testing.enums.drivers import PersistentDrivers
 from orionis.foundation.config.testing.enums.mode import ExecutionMode
 from orionis.foundation.contracts.application import IApplication
 from orionis.services.introspection.instances.reflection import ReflectionInstance
+from orionis.support.performance.contracts.counter import IPerformanceCounter
 from orionis.test.contracts.test_result import IOrionisTestResult
 from orionis.test.contracts.unit_test import IUnitTest
 from orionis.test.entities.result import TestResult
@@ -384,7 +385,10 @@ class UnitTest(IUnitTest):
         - Provides detailed error messages for failed imports and missing tests.
         """
         try:
+
+            # Iterate through all imported test modules
             for test_module in self.__modules:
+
                 # Load all tests from the current module
                 module_suite = self.__loader.loadTestsFromModule(test_module)
 
@@ -454,7 +458,8 @@ class UnitTest(IUnitTest):
             )
 
     def run(
-        self
+        self,
+        performance_counter: IPerformanceCounter
     ) -> Dict[str, Any]:
         """
         Execute the test suite and return a summary of the results.
@@ -470,16 +475,15 @@ class UnitTest(IUnitTest):
             If the test suite execution fails and throw_exception is True.
         """
 
+        # Record the start time in seconds
+        performance_counter.start()
+
         # Length of all tests in the suite
         total_tests = len(list(self.__flattenTestSuite(self.__suite)))
 
         # If no tests are found, print a message and return early
         if total_tests == 0:
-            self.__printer.zeroTestsMessage()
-            return
-
-        # Record the start time in nanoseconds
-        start_time = time.time_ns()
+            return self.__printer.zeroTestsMessage()
 
         # Print the start message with test suite details
         self.__printer.startMessage(
@@ -499,7 +503,8 @@ class UnitTest(IUnitTest):
         self.__error_buffer = error_buffer.getvalue()
 
         # Calculate execution time in milliseconds
-        execution_time = (time.time_ns() - start_time) / 1_000_000_000
+        performance_counter.stop()
+        execution_time = performance_counter.getSeconds()
 
         # Generate a summary of the test results
         summary = self.__generateSummary(result, execution_time)

orionis/test/kernel.py

@@ -69,7 +69,7 @@ class TestKernel(ITestKernel):
         """
 
         # Run the unit test suite and collect the output summary
-        output = self.__unit_test.run()
+        output = self.__app.call(self.__unit_test, 'run')
 
         # Only log detailed report if output is available
         if output is not None:

{orionis-0.589.0.dist-info → orionis-0.590.0.dist-info}/METADATA

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

{orionis-0.589.0.dist-info → orionis-0.590.0.dist-info}/RECORD

@@ -32,7 +32,7 @@ orionis/console/contracts/reactor.py,sha256=iT6ShoCutAWEeJzOf_PK7CGXi9TgrOD5tewH
 orionis/console/contracts/schedule.py,sha256=N-AYUa1CJY7a4CV9L1EX_EUDtGlDJMg4y0aV9EDby1Q,16090
 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=-Yf7EIrohU-2gnxJfqRvuhD49ITef64CKMECiTCx0eQ,43108
+orionis/console/core/reactor.py,sha256=AjusZMznUmrfIlUWlFGPaTNZi5fQ2FHCedQOmgHetfM,43222
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/debug.py,sha256=p8uflSXeDJDrVM9mZY4JMYEus73Z6TsLnQQtgP0QUak,22427
 orionis/console/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -217,7 +217,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=irwkjMiq-HpsbJxAOnhjji
 orionis/foundation/providers/testing_provider.py,sha256=2akFnabtH_cV_7z_2cCL7u8cPCGvCJAmlhMcnlCrc4c,3742
 orionis/foundation/providers/workers_provider.py,sha256=P_YtJuPNrdJAQJkAqI11KI0c6GSB9NqIuuCKpRytE0g,3937
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=txjk_25DYSonM4bVEfG0F3hPxtu46pq9X86ix4aIOyQ,4109
+orionis/metadata/framework.py,sha256=7Qamg4AASaPxTO8Is_Gn8xfzZKI92BhuKTIvZSGHSPU,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
@@ -347,9 +347,9 @@ orionis/support/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 orionis/support/patterns/singleton/__init__.py,sha256=BIyMYL5yXpzv_F-jsSEtoKYseGlM8jdJT8hwGuXZZl8,62
 orionis/support/patterns/singleton/meta.py,sha256=TmrE-QlkglBChD4bmMgQRGT3nli6Kf6UvDl1tiEjQ_o,3801
 orionis/support/performance/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/support/performance/counter.py,sha256=eTr1VoFy1Jiqc4lmyhrYGTe2ge-Vpl1zuzYt_3nMTP8,2947
+orionis/support/performance/counter.py,sha256=-IyrsnJKTq3H3J2O0vmTUsuZTeduLlkyvFNDPqUnRiY,6055
 orionis/support/performance/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/support/performance/contracts/counter.py,sha256=uDBFk4YswAI4O72t2lc2H8Ck86WU4tp8p4gPXg-r3mw,1317
+orionis/support/performance/contracts/counter.py,sha256=JK-ZOzC4emxxz5wGgpOJZuoTGOZawU2b06rTyGjosgc,3971
 orionis/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/support/standard/std.py,sha256=zwXOellgGy9LTmeAK-rCIr7CgKYg5iQijMjdwmMblFA,3800
 orionis/support/standard/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -359,7 +359,7 @@ orionis/support/standard/exceptions/standard.py,sha256=BM0VHLRYD7SzoMJkaA7BxY528
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
 orionis/support/wrapper/dot_dict.py,sha256=T8xWwwOhBZHNeXRwE_CxvOwG9UFxsLqNmOJjV2CNIrc,7284
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/kernel.py,sha256=6yvS0vQBuZ5M2wH2DzTMSRA-judzCK1fnnzkmLfw49w,3970
+orionis/test/kernel.py,sha256=omGCyj45ES4T5YhC7WVya21oR64O3ymiTgwq1d7mDUE,3988
 orionis/test/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/cases/asynchronous.py,sha256=3e1Y3qzIxVU7i7lbLFEVyJ89IA74JsB7famx71W-p2E,1974
 orionis/test/cases/synchronous.py,sha256=S5jhuDEZ5I9wosrTFaCtowkD5r5HzJH6mKPOdEJcDJE,1734
@@ -372,7 +372,7 @@ orionis/test/contracts/render.py,sha256=wpDQzUtT0r8KFZ7zPcxWHXQ1EVNKxzA_rZ6ZKUcZ
 orionis/test/contracts/test_result.py,sha256=SNXJ2UerkweYn7uCT0i0HmMGP0XBrL_9KJs-0ZvIYU4,4002
 orionis/test/contracts/unit_test.py,sha256=hOuMgm1JVk3ERLrpMnDhShMWCJCJBdgOsY-U6kPaO0k,2335
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/core/unit_test.py,sha256=mge6EZvfSeZKxSGo6k0-5putfvEByRF-IDAFx-9aSNY,64908
+orionis/test/core/unit_test.py,sha256=Yqn_Q-aM0-x2zzsnB-h3XBGg20iCrn1pkT1UFI-L0RE,65105
 orionis/test/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/entities/result.py,sha256=eZ6UIqGmFW8FZ9x8PB_MZbLAc-SAuUyi4FUcMYIZzGo,4777
 orionis/test/enums/__init__.py,sha256=M3imAgMvKFTKg55FbtVoY3zxj7QRY9AfaUWxiSZVvn4,66
@@ -406,8 +406,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=1FJHFBRHbwI5FV90F9-cMUmT10xrA5tc2bY1ysTzD-8,4094
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.589.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.589.0.dist-info/METADATA,sha256=1tRDA0nH_HAgPvPbBNK0ZywbkcihrZRHkLU-pxDRHPE,4801
-orionis-0.589.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.589.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.589.0.dist-info/RECORD,,
+orionis-0.590.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.590.0.dist-info/METADATA,sha256=tCJPLPBw0Lyfjjn3RITEIgrYYOuSjgV7ung6ipxijr8,4801
+orionis-0.590.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.590.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.590.0.dist-info/RECORD,,