orionis 0.578.0__py3-none-any.whl → 0.580.0__py3-none-any.whl

orionis/services/introspection/exceptions/introspection.py

@@ -0,0 +1,76 @@
+class ReflectionAttributeError(Exception):
+    """
+    Exception raised when an attribute cannot be found during reflection or introspection operations.
+
+    This exception is typically raised when attempting to access an attribute that does not exist
+    or is not accessible on the target object during reflection or introspection.
+
+    Parameters
+    ----------
+    *args : tuple
+        Variable length argument list passed to the base Exception.
+    **kwargs : dict
+        Arbitrary keyword arguments passed to the base Exception.
+
+    Returns
+    -------
+    ReflectionAttributeError
+        An instance of the ReflectionAttributeError exception.
+
+    Notes
+    -----
+    This exception does not define additional attributes beyond those provided by Exception.
+    """
+    pass  # Custom exception for attribute errors during reflection
+
+
+class ReflectionTypeError(Exception):
+    """
+    Exception raised when a type-related error occurs during reflection or introspection operations.
+
+    This exception signals issues such as invalid type usage, type mismatches, or unsupported types
+    encountered while performing reflection-based logic.
+
+    Parameters
+    ----------
+    *args : tuple
+        Variable length argument list passed to the base Exception.
+    **kwargs : dict
+        Arbitrary keyword arguments passed to the base Exception.
+
+    Returns
+    -------
+    ReflectionTypeError
+        An instance of the ReflectionTypeError exception.
+
+    Notes
+    -----
+    This exception does not define additional attributes beyond those provided by Exception.
+    """
+    pass  # Custom exception for type errors during reflection
+
+
+class ReflectionValueError(Exception):
+    """
+    Exception raised when a reflection operation encounters an invalid or unexpected value.
+
+    This exception is used within introspection services to indicate that a value obtained or
+    manipulated via reflection does not meet the expected criteria or format.
+
+    Parameters
+    ----------
+    *args : tuple
+        Variable length argument list passed to the base Exception.
+    **kwargs : dict
+        Arbitrary keyword arguments passed to the base Exception.
+
+    Returns
+    -------
+    ReflectionValueError
+        An instance of the ReflectionValueError exception.
+
+    Notes
+    -----
+    This exception does not define additional attributes beyond those provided by Exception.
+    """
+    pass  # Custom exception for value errors during reflection

orionis/services/log/exceptions/__init__.py

@@ -1,4 +1,4 @@
-from .runtime import LoggerRuntimeError
+from .log import LoggerRuntimeError
 
 __all__ = [
     "LoggerRuntimeError",

orionis/support/facades/application.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.foundation.contracts.application import IApplication
 
 class Application(Facade):
 
@@ -15,9 +16,9 @@ class Application(Facade):
         Returns
         -------
         str
-            The string identifier 'x-orionis.services.log.log_service' used as the
+            The string identifier "x-orionis.foundation.contracts.application.IApplication" used as the
             binding key to resolve the console service from the service container.
         """
 
         # Return the predefined binding key for the console output service
-        return "x-orionis.services.log.log_service"
+        return f"x-{IApplication.__module__}.{IApplication.__name__}"

orionis/support/facades/console.py

@@ -1,3 +1,4 @@
+from orionis.console.contracts.console import IConsole
 from orionis.container.facades.facade import Facade
 
 class Console(Facade):
@@ -15,9 +16,9 @@ class Console(Facade):
         Returns
         -------
         str
-            The string identifier 'x-orionis.console.output.console' used as the
+            The string identifier 'x-orionis.console.contracts.console.IConsole' used as the
             binding key to resolve the console service from the service container.
         """
 
         # Return the predefined binding key for the console output service
-        return "x-orionis.console.output.console"
+        return f"x-{IConsole.__module__}.{IConsole.__name__}"

orionis/support/facades/directory.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.services.file.contracts.directory import IDirectory
 
 class Directory(Facade):
 
@@ -14,8 +15,8 @@ class Directory(Facade):
         Returns
         -------
         str
-            The service container binding key 'x-orionis.services.file.contracts.directory'
+            The service container binding key 'x-orionis.services.file.contracts.directory.IDirectory'
             that identifies the workers service implementation.
         """
 
-        return "x-orionis.services.file.contracts.directory"
+        return f"x-{IDirectory.__module__}.{IDirectory.__name__}"

orionis/support/facades/dumper.py

@@ -1,3 +1,4 @@
+from orionis.console.contracts.debug import IDebug
 from orionis.container.facades.facade import Facade
 
 class Dumper(Facade):
@@ -14,9 +15,9 @@ class Dumper(Facade):
         Returns
         -------
         str
-            The service container binding key "x-orionis.console.dumper.dump"
+            The service container binding key "x-orionis.console.contracts.debug.IDebug"
             that identifies the dumper service instance.
         """
 
         # Return the specific binding key for the dumper service in the container
-        return "x-orionis.console.dumper.dump"
+        return f"x-{IDebug.__module__}.{IDebug.__name__}"

orionis/support/facades/executor.py

@@ -1,3 +1,4 @@
+from orionis.console.contracts.executor import IExecutor
 from orionis.container.facades.facade import Facade
 
 class ConsoleExecutor(Facade):
@@ -15,10 +16,10 @@ class ConsoleExecutor(Facade):
         Returns
         -------
         str
-            The string identifier 'x-orionis.console.output.executor' used as
+            The string identifier 'x-orionis.console.contracts.executor.IExecutor' used as
             the binding key to locate and resolve the executor service instance
             from the dependency injection container.
         """
 
         # Return the predefined binding key for the executor service
-        return "x-orionis.console.output.executor"
+        return f"x-{IExecutor.__module__}.{IExecutor.__name__}"

orionis/support/facades/inspire.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.services.inspirational.contracts.inspire import IInspire
 
 class Inspire(Facade):
 
@@ -15,9 +16,9 @@ class Inspire(Facade):
         Returns
         -------
         str
-            The service container binding key 'x-orionis.services.inspirational.inspire'
+            The service container binding key 'x-orionis.services.inspirational.contracts.inspire.IInspire'
             used to resolve the inspirational service instance.
         """
 
         # Return the service container binding key for the inspirational service
-        return "x-orionis.services.inspirational.inspire"
+        return f"x-{IInspire.__module__}.{IInspire.__name__}"

orionis/support/facades/logger.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.services.log.contracts.log_service import ILogger
 
 class Log(Facade):
 
@@ -14,10 +15,10 @@ class Log(Facade):
         Returns
         -------
         str
-            The service container binding key "x-orionis.services.log.log_service"
+            The service container binding key "x-orionis.services.log.contracts.log_service.ILogger"
             used to resolve the logger service instance from the dependency
             injection container.
         """
 
         # Return the service container binding key for the logger service
-        return "x-orionis.services.log.log_service"
+        return f"x-{ILogger.__module__}.{ILogger.__name__}"

orionis/support/facades/performance_counter.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.support.performance.contracts.counter import IPerformanceCounter
 
 class PerformanceCounter(Facade):
 
@@ -14,8 +15,8 @@ class PerformanceCounter(Facade):
         Returns
         -------
         str
-            The service container binding key 'x-orionis.support.performance.counter'
+            The service container binding key 'x-orionis.support.performance.contracts.counter.IPerformanceCounter
             that identifies the workers service implementation.
         """
 
-        return "x-orionis.support.performance.counter"
+        return f"x-{IPerformanceCounter.__module__}.{IPerformanceCounter.__name__}"

orionis/support/facades/progress_bar.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.console.contracts.progress_bar import IProgressBar
 
 class ProgressBar(Facade):
 
@@ -14,8 +15,8 @@ class ProgressBar(Facade):
         Returns
         -------
         str
-            The service container binding key 'x-orionis.console.dynamic.progress_bar'
+            The service container binding key 'x-orionis.console.contracts.progress_bar.IProgressBar
             used to retrieve the progress bar service instance.
         """
 
-        return "x-orionis.console.dynamic.progress_bar"
+        return f"x-{IProgressBar.__module__}.{IProgressBar.__name__}"

orionis/support/facades/reactor.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.console.contracts.reactor import IReactor
 
 class Reactor(Facade):
 
@@ -15,8 +16,8 @@ class Reactor(Facade):
         Returns
         -------
         str
-            The service container binding key "x-orionis.console.core.reactor"
+            The service container binding key "x-orionis.console.contracts.reactor.IReactor"
             used to resolve the testing component implementation.
         """
 
-        return "x-orionis.console.core.reactor"
+        return f"x-{IReactor.__module__}.{IReactor.__name__}"

orionis/support/facades/testing.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.test.contracts.unit_test import IUnitTest
 
 class Test(Facade):
 
@@ -15,8 +16,8 @@ class Test(Facade):
         Returns
         -------
         str
-            The service container binding key "x-orionis.test.core.unit_test"
+            The service container binding key "x-orionis.test.contracts.unit_test.IUnitTest"
             used to resolve the testing component implementation.
         """
 
-        return "x-orionis.test.core.unit_test"
+        return f"x-{IUnitTest.__module__}.{IUnitTest.__name__}"

orionis/support/facades/workers.py

@@ -1,4 +1,5 @@
 from orionis.container.facades.facade import Facade
+from orionis.services.system.contracts.workers import IWorkers
 
 class Workers(Facade):
 
@@ -7,15 +8,15 @@ class Workers(Facade):
         """
         Get the registered name of the component in the service container.
 
-        This method provides the binding key that the service container uses to 
-        resolve the workers service implementation. It serves as the bridge between 
+        This method provides the binding key that the service container uses to
+        resolve the workers service implementation. It serves as the bridge between
         the facade and the underlying service registration.
 
         Returns
         -------
         str
-            The service container binding key 'x-orionis.services.system.workers' 
+            The service container binding key 'x-orionis.services.system.contracts.workers.IWorkers'
             that identifies the workers service implementation.
         """
 
-        return "x-orionis.services.system.workers"
+        return f"x-{IWorkers.__module__}.{IWorkers.__name__}"

orionis/support/standard/exceptions/__init__.py

@@ -1,4 +1,4 @@
-from .value import OrionisStdValueException
+from .standard import OrionisStdValueException
 
 __all__ = [
     "OrionisStdValueException"

orionis/support/standard/exceptions/standard.py

@@ -0,0 +1,23 @@
+class OrionisStdValueException(Exception):
+    """
+    Exception raised for errors related to invalid or unexpected values in the Orionis standard support module.
+
+    This exception should be used when a function or operation encounters a value that does not satisfy the required criteria or constraints.
+
+    Parameters
+    ----------
+    message : str, optional
+        Error message describing the reason for the exception.
+
+    Returns
+    -------
+    OrionisStdValueException
+        An instance of the exception with an optional error message.
+
+    Attributes
+    ----------
+    message : str
+        Optional error message describing the reason for the exception.
+    """
+    # Inherits from the built-in Exception class to define a custom exception
+    pass

orionis/test/core/unit_test.py

@@ -492,12 +492,21 @@ class UnitTest(IUnitTest):
         OrionisTestFailureException
             If the test suite execution fails and throw_exception is True.
         """
+
+        # 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()
 
         # Print the start message with test suite details
         self.__printer.startMessage(
-            length_tests=len(list(self.__flattenTestSuite(self.__suite))),
+            length_tests=total_tests,
             execution_mode=self.__execution_mode,
             max_workers=self.__max_workers
         )

orionis/test/kernel.py

@@ -43,7 +43,7 @@ class TestKernel(ITestKernel):
         config = Testing(**app.config('testing'))
 
         # Resolve the unit test service from the application container
-        self.__unit_test: IUnitTest = app.make('x-orionis.test.core.unit_test')
+        self.__unit_test: IUnitTest = app.make(IUnitTest)
 
         # Apply configuration settings to the UnitTest instance
         self.__unit_test.configure(
@@ -68,7 +68,7 @@ class TestKernel(ITestKernel):
         )
 
         # Initialize the logger service for logging command execution details
-        self.__logger: ILogger = app.make('x-orionis.services.log.log_service')
+        self.__logger: ILogger = app.make(ILogger)
 
     def handle(self) -> IUnitTest:
         """
@@ -89,23 +89,25 @@ class TestKernel(ITestKernel):
         # Log the start of test execution
         ouput = self.__unit_test.run()
 
-        # Extract report details from output
-        total_tests = ouput.get("total_tests")
-        passed = ouput.get("passed")
-        failed = ouput.get("failed")
-        errors = ouput.get("errors")
-        skipped = ouput.get("skipped")
-        total_time = ouput.get("total_time")
-        success_rate = ouput.get("success_rate")
-        timestamp = ouput.get("timestamp")
-
-        # Log test execution completion with detailed summary
-        self.__logger.info(
-            f"Test execution completed at {timestamp} | "
-            f"Total: {total_tests}, Passed: {passed}, Failed: {failed}, "
-            f"Errors: {errors}, Skipped: {skipped}, "
-            f"Time: {total_time:.2f}s, Success rate: {success_rate:.2f}%"
-        )
+        if ouput is not None:
+
+            # Extract report details from output
+            total_tests = ouput.get("total_tests")
+            passed = ouput.get("passed")
+            failed = ouput.get("failed")
+            errors = ouput.get("errors")
+            skipped = ouput.get("skipped")
+            total_time = ouput.get("total_time")
+            success_rate = ouput.get("success_rate")
+            timestamp = ouput.get("timestamp")
+
+            # Log test execution completion with detailed summary
+            self.__logger.info(
+                f"Test execution completed at {timestamp} | "
+                f"Total: {total_tests}, Passed: {passed}, Failed: {failed}, "
+                f"Errors: {errors}, Skipped: {skipped}, "
+                f"Time: {total_time:.2f}s, Success rate: {success_rate:.2f}%"
+            )
 
         # Report the test results to the console
         return ouput

orionis/test/output/printer.py

@@ -84,6 +84,33 @@ class TestPrinter(ITestPrinter):
         else:
             self.__rich_console.print(str(value))
 
+    def zeroTestsMessage(self) -> None:
+        """
+        Display a message indicating that no tests were found to execute.
+
+        Returns
+        -------
+        None
+        """
+        # If not printing results, return early
+        if self.__print_result is False:
+            return
+
+        # Print the message inside a styled Rich panel (not as an error)
+        self.__rich_console.print(
+            Panel(
+                "No tests found to execute.",
+                border_style="yellow",
+                title="No Tests",
+                title_align="center",
+                width=self.__panel_width,
+                padding=(0, 1)
+            )
+        )
+
+        # Add a blank line after the panel for spacing
+        self.__rich_console.line(1)
+
     def startMessage(
         self,
         *,
@@ -368,6 +395,12 @@ class TestPrinter(ITestPrinter):
             # If there are no failures or errors, skip to the next test
             if test["status"] in (TestStatus.FAILED.name, TestStatus.ERRORED.name):
 
+                # Determine the status icon based on the test status
+                if test["status"] == TestStatus.FAILED.name:
+                    status_icon = "❌ FAILED: "
+                else:
+                    status_icon = "💥 ERRORED: "
+
                 # Print separator line before each test result with class name and method name
                 self.__rich_console.rule(title=f'🧪 {test["class"]}.{test["method"]}()', align="left")
 
@@ -388,16 +421,12 @@ class TestPrinter(ITestPrinter):
                     self.__rich_console.print(text)
 
                     # Print the error message with better formatting
-                    text = Text("Error in ", style="bold red")
-                    text.append(f'{_function}()', style="bold cyan")
-                    text.append(": ", style="bold red")
-
-                    # Extract just the first line of the error message for cleaner display
+                    text = Text(status_icon, style="red")
                     error_msg = test["error_message"] if test["error_message"] else "Unknown error"
-                    text.append(error_msg, style="red")
+                    text.append(error_msg, style="yellow")
                     self.__rich_console.print(text)
 
-                    # Print the code context (3 lines before and after the error)
+                    # Print the code context (1 line before and 2 lines after the error)
                     try:
 
                         # Open the file and read its lines
@@ -438,8 +467,7 @@ class TestPrinter(ITestPrinter):
                     self.__rich_console.print(text)
 
                     # Print the error message with better formatting
-                    text = Text("Error: ", style="bold red")
-                    text.append(f'{test["error_message"]}', style="red")
+                    text = Text(status_icon, style="bold red")
                     self.__rich_console.print(text)
 
                     # Print traceback if available

{orionis-0.578.0.dist-info → orionis-0.580.0.dist-info}/METADATA

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