orionis 0.217.0__py3-none-any.whl → 0.219.0__py3-none-any.whl

orionis/framework.py

@@ -5,7 +5,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.217.0"
+VERSION = "0.219.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"
@@ -26,7 +26,7 @@ SKELETON = "https://github.com/orionis-framework/skeleton"
 FRAMEWORK = "https://github.com/orionis-framework/framework"
 
 # URL to the project's documentation
-DOCS = "https://github.com/orionis-framework/docs"
+DOCS = "https://orionis-framework.com/"
 
 # API URL to the project's JSON data
 API = "https://pypi.org/pypi/orionis/json"

orionis/luminate/application.py

@@ -10,7 +10,7 @@ from orionis.luminate.foundation.environment.environment_bootstrapper import Env
 from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
 from orionis.luminate.foundation.providers.service_providers_bootstrapper import ServiceProvidersBootstrapper
 from orionis.luminate.patterns.singleton import SingletonMeta
-from orionis.luminate.support.asyn_run import AsyncExecutor
+from orionis.luminate.support.async_io.async_coroutine import AsyncExecutor
 
 class Application(metaclass=SingletonMeta):
     """

orionis/luminate/container/resolve.py

@@ -1,7 +1,7 @@
 from typing import Any, Callable
 from orionis.luminate.container.container import Container
 from orionis.luminate.container.exception import OrionisContainerValueError
-from orionis.luminate.support.asyn_run import AsyncExecutor
+from orionis.luminate.support.async_io.async_coroutine import AsyncExecutor
 
 class Resolve:
     """

orionis/luminate/contracts/facades/facade.py

@@ -1,5 +1,5 @@
 from orionis.luminate.container.container import Container
-from orionis.luminate.support.asyn_run import AsyncExecutor
+from orionis.luminate.support.async_io.async_coroutine import AsyncExecutor
 
 class FacadeMeta(type):
     """

orionis/luminate/support/async_io/async_coroutine.py

@@ -0,0 +1,48 @@
+import asyncio
+from inspect import iscoroutine
+from typing import Any, Coroutine, TypeVar, Union
+from orionis.luminate.support.async_io.contracts.async_coroutine import IAsyncCoroutine
+
+T = TypeVar("T")
+
+class AsyncCoroutine(IAsyncCoroutine):
+    """
+    A utility class for executing coroutine objects in various asynchronous and synchronous contexts.
+    This class provides a static method to execute coroutine objects, handling different scenarios
+    such as running within an active event loop (e.g., in Jupyter notebooks or Starlette) or in a
+    synchronous context without an active event loop.
+
+    Methods
+    -------
+    execute(coro: Coroutine[Any, Any, T]) -> Union[T, asyncio.Future]
+        Executes the given coroutine object, adapting to the current execution context.
+    """
+
+    @staticmethod
+    def execute(coro: Coroutine[Any, Any, T]) -> Union[T, asyncio.Future]:
+        """
+        Executes the given coroutine object, adapting to the current execution context.
+        If there is an active event loop, it uses `asyncio.ensure_future` to schedule the coroutine.
+        If there is no active event loop, it uses `asyncio.run` to run the coroutine directly.
+        If the coroutine is already running, it returns a `Future` object that can be awaited.
+
+        Parameters
+        ----------
+        coro : Coroutine[Any, Any, T]
+            The coroutine object
+        """
+        if not iscoroutine(coro):
+            raise TypeError("Expected a coroutine object.")
+
+        try:
+            loop = asyncio.get_running_loop()
+        except RuntimeError:
+            # No hay loop activo: ejecutamos directamente
+            return asyncio.run(coro)
+
+        if loop.is_running():
+            # Ya hay un loop activo (notebooks, FastAPI, etc.)
+            return asyncio.ensure_future(coro)  # devuelve un Future (debes await si estás en async)
+        else:
+            # Estamos en código síncrono, pero con acceso al loop
+            return loop.run_until_complete(coro)

orionis/luminate/support/async_io/contracts/async_coroutine.py

@@ -0,0 +1,31 @@
+import asyncio
+from typing import Any, Coroutine, TypeVar, Union
+
+T = TypeVar("T")
+
+class IAsyncCoroutine:
+    """
+    Interface for executing asynchronous coroutines.
+
+    Methods
+    -------
+    execute(coro: Coroutine[Any, Any, T]) -> Union[T, asyncio.Future]
+        Executes the given coroutine.
+    """
+
+    @staticmethod
+    def execute(coro: Coroutine[Any, Any, T]) -> Union[T, asyncio.Future]:
+        """
+        Execute the given coroutine.
+
+        Parameters
+        ----------
+        coro : Coroutine[Any, Any, T]
+            The coroutine to be executed.
+
+        Returns
+        -------
+        Union[T, asyncio.Future]
+            The result of the coroutine execution or a Future object.
+        """
+        pass

orionis/luminate/support/standard/std.py

@@ -4,15 +4,6 @@ class StdClass(IStdClass):
     """
     A dynamic class that allows setting arbitrary attributes,
     similar to PHP's stdClass.
-
-    Examples
-    --------
-    >>> obj = StdClass(name='Raul', age=30)
-    >>> obj.name
-    'Raul'
-    >>> obj.update(age=31)
-    >>> obj.toDict()
-    {'name': 'Raul', 'age': 31}
     """
 
     def __init__(self, **kwargs):

orionis/luminate/test/contracts/test_std_out.py

@@ -0,0 +1,17 @@
+from typing import Any
+
+class ITestStdOut:
+    """
+    Utility for printing debug info during tests, including caller context (file, line, method).
+    """
+
+    @staticmethod
+    def print(*args: Any) -> None:
+        """
+        Print arguments to the console with file, line, and method of the caller.
+
+        Parameters
+        ----------
+        *args : Any
+            Any values to print. The first argument is ignored (typically the class or context).
+        """

orionis/luminate/test/contracts/test_suite.py

@@ -0,0 +1,37 @@
+class ITests:
+    """
+    Provides utility methods to configure and execute unit tests from specified folders.
+    """
+
+    @staticmethod
+    def execute(folders: list, print_result:bool = True, throw_exception:bool = False):
+        """
+        Configure and run unit tests from a list of folder definitions.
+
+        Parameters
+        ----------
+        folders : list of dict
+            Each dict must include:
+            - 'folder_path' (str): Path to the folder with test files.
+            - 'base_path' (str): Base path for resolving test imports.
+            - 'pattern' (str): Glob pattern for test file names.
+
+        print_result : bool, default=True
+            Whether to print test results to the console.
+
+        throw_exception : bool, default=False
+            Whether to raise exceptions on test failures.
+
+        Returns
+        -------
+        UnitTestClass
+            The initialized and executed test suite.
+
+        Raises
+        ------
+        TypeError
+            If `folders` is not a list of dictionaries.
+        KeyError
+            If any dictionary lacks required keys: 'folder_path', 'base_path', or 'pattern'.
+        """
+        pass

orionis/luminate/test/contracts/test_unit.py

@@ -0,0 +1,82 @@
+from typing import Any, Dict, Optional
+
+class IUnitTest:
+    """
+    Advanced unit testing utility for discovering, executing, and reporting test results
+    with support for folder-based discovery, regex filtering, and customizable output.
+
+    Attributes
+    ----------
+    loader : unittest.TestLoader
+        Internal loader for test discovery.
+    suite : unittest.TestSuite
+        The aggregated test suite to be executed.
+    test_results : List[TestResult]
+        List of captured results per test, including status and errors.
+    start_time : float
+        Timestamp when the test execution started.
+    """
+
+    def addFolder(
+        self,
+        folder_path: str,
+        base_path: str = "tests",
+        pattern: str = "test_*.py",
+        test_name_pattern: Optional[str] = None
+    ):
+        """
+        Discover and add test cases from a given folder to the test suite.
+
+        Parameters
+        ----------
+        folder_path : str
+            Relative path to the folder containing test files.
+        base_path : str, default="tests"
+            Base path used to resolve full path to test modules.
+        pattern : str, default="test_*.py"
+            Glob pattern to match test filenames.
+        test_name_pattern : Optional[str], optional
+            Regex pattern to filter discovered test method names.
+
+        Returns
+        -------
+        UnitTest
+            Self instance for chaining.
+
+        Raises
+        ------
+        ValueError
+            If folder is invalid or no tests are found.
+        """
+        pass
+
+    def run(self, print_result:bool = True, throw_exception:bool = False) -> Dict[str, Any]:
+        """
+        Run all added tests and return a summary of the results.
+
+        Parameters
+        ----------
+        print_result : bool, default=True
+            Whether to print a formatted report to the console.
+        throw_exception : bool, default=False
+            Raise an exception if there are failures or errors.
+
+        Returns
+        -------
+        Dict[str, Any]
+            Summary including:
+            - total_tests : int
+            - passed : int
+            - failed : int
+            - errors : int
+            - skipped : int
+            - total_time : str (e.g., '1.234 seconds')
+            - success_rate : str (e.g., '87.5%')
+            - test_details : List[Dict[str, Any]]
+
+        Raises
+        ------
+        OrionisTestFailureException
+            If any test fails or errors occur and `throw_exception=True`.
+        """
+        pass

orionis/luminate/test/test_case.py

@@ -1,5 +1,62 @@
 import unittest
 from orionis.luminate.test.test_std_out import TestStdOut
 
-class TestCase(unittest.TestCase, TestStdOut):
+class TestCase(unittest.IsolatedAsyncioTestCase, TestStdOut):
+    """
+    TestCase is a base class for unit tests that provides support for asynchronous
+    testing using `unittest.IsolatedAsyncioTestCase` and additional functionality
+    from `TestStdOut`."""
+    async def asyncSetUp(self):
+        """
+        Asynchronous setup method called before each test.
+        It ensures that the parent class's asyncSetUp method is invoked to initialize
+        any required resources.
+        """
+        await super().asyncSetUp()
+
+    async def asyncTearDown(self):
+        """
+        Asynchronous teardown method called after each test.
+        It ensures that the parent class's asyncTearDown method is invoked to clean up
+        any resources used during the test.
+        """
+        await super().asyncTearDown()
+
+# Another asynchronous test case class
+class TestAsyncCase(unittest.IsolatedAsyncioTestCase, TestStdOut):
+    """
+    TestAsyncCase is a test case class designed for asynchronous unit testing.
+    It inherits from `unittest.IsolatedAsyncioTestCase` to provide support for
+    async test methods and `TestStdOut` for additional functionality.
+    Methods
+    -------
+    asyncSetUp()
+        Asynchronous setup method called before each test. It ensures that the
+        parent class's asyncSetUp method is invoked to initialize any required
+        resources.
+    asyncTearDown()
+        Asynchronous teardown method called after each test. It ensures that the
+        parent class's asyncTearDown method is invoked to clean up any resources
+        used during the test.
+    """
+    async def asyncSetUp(self):
+        """
+        Asynchronous setup method called before each test.
+        It ensures that the parent class's asyncSetUp method is invoked to initialize
+        """
+        await super().asyncSetUp()
+
+    async def asyncTearDown(self):
+        """
+        Asynchronous teardown method called after each test.
+        It ensures that the parent class's asyncTearDown method is invoked to clean up
+        """
+        await super().asyncTearDown()
+
+class TestSyncCase(unittest.TestCase, TestStdOut):
+    """
+    TestSyncCase is a test case class designed for synchronous unit testing.
+    It inherits from `unittest.TestCase` to provide support for standard test methods
+    and `TestStdOut` for additional functionality.
+    """
     pass

orionis/luminate/test/test_std_out.py

@@ -1,8 +1,9 @@
 import os
 import sys
 from orionis.luminate.console.output.console import Console
+from orionis.luminate.test.contracts.test_std_out import ITestStdOut
 
-class TestStdOut:
+class TestStdOut(ITestStdOut):
     """
     A utility class for printing debug information during testing. This class temporarily
     redirects the standard output and error streams to their original states to ensure
@@ -56,7 +57,7 @@ class TestStdOut:
         _line = sys._getframe(1).f_lineno
 
         # Print the contextual information and the provided arguments
-        Console.textMuted(f"[DEBUG] File: {_file}, Line: {_line}, Method: {_method}")
+        Console.textMuted(f"[Printout] File: {_file}, Line: {_line}, Method: {_method}")
         print(*args[1:], end='\n')
         Console.newLine()
 

orionis/luminate/test/test_suite.py

@@ -1,6 +1,7 @@
+from orionis.luminate.test.contracts.test_suite import ITests
 from orionis.luminate.test.test_unit import UnitTest as UnitTestClass
 
-class Tests:
+class Tests(ITests):
     """
     A class containing test utility methods.
 

orionis/luminate/test/test_unit.py

@@ -7,11 +7,12 @@ from contextlib import redirect_stdout, redirect_stderr
 from dataclasses import asdict
 from typing import Any, Dict, List, Optional, Tuple
 from orionis.luminate.console.output.console import Console
+from orionis.luminate.test.contracts.test_unit import IUnitTest
 from orionis.luminate.test.test_exception import OrionisTestFailureException
 from orionis.luminate.test.test_result import TestResult
 from orionis.luminate.test.test_status import TestStatus
 
-class UnitTest:
+class UnitTest(IUnitTest):
     """
     An advanced testing framework for discovering, running, and analyzing unit tests.
 

{orionis-0.217.0.dist-info → orionis-0.219.0.dist-info}/METADATA

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

{orionis-0.217.0.dist-info → orionis-0.219.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console.py,sha256=4gYWxf0fWYgJ4RKwARvnTPh06FL3GJ6SAZ7R2NzOICw,1342
-orionis/framework.py,sha256=RCaBy69xj2GAOJ8qBC1JliYV7FzXH8HNRwvWltjWgoQ,1469
+orionis/framework.py,sha256=FaBRVAKmUaPiIZfyAYO_fDsoQioniy_o7AlvxNFzpT8,1458
 orionis/installer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/installer/manager.py,sha256=Li4TVziRXWfum02xNG4JHwbnLk-u8xzHjdqKz-D894k,2755
 orionis/installer/output.py,sha256=7O9qa2xtXMB_4ZvVi-Klneom9YazwygAd_4uYAoxhbU,8548
@@ -10,7 +10,7 @@ orionis/installer/contracts/manager.py,sha256=Zfndhuyu0JaTKo3PsGsKmVsvotQMw8Pmt4
 orionis/installer/contracts/output.py,sha256=t1KLw610-hHy63UbFFE2BYwWHWRbW8_ofuEvRLx_IUE,983
 orionis/installer/contracts/setup.py,sha256=aWYkCv-z48bXXZynYapc3uMIE1gyO6XnkTw3b4MTBq4,784
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/application.py,sha256=bpZeV8NEHLNm8MkS6suCX3nd7LYB4dOTIgaIivKl2xI,9526
+orionis/luminate/application.py,sha256=j6aEhCZhmann6HiuhoWmnJQbNTqZdu3oegPt0SQtJX4,9542
 orionis/luminate/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/config/app.py,sha256=o-Ons0LMp77_E18e_dx_DqGVbjaY2l-5RdVSCILxgfg,1655
 orionis/luminate/config/auth.py,sha256=ivAUgoEYEtfdC49vDwOl_MXFUVAQnUJTc8iG3Lu0Stc,430
@@ -48,7 +48,7 @@ orionis/luminate/container/container.py,sha256=9xdODX1h4YK6V-THrfgm5XN95imobExzr
 orionis/luminate/container/container_integrity.py,sha256=6d9FsGk-Rm1AXgqBS3Nww49dR7n1ptXTTNyGUuBHgNY,10111
 orionis/luminate/container/exception.py,sha256=ap1SqYEjQEEHXJJTNmL7V1jrmRjgT5_7geZ95MYkhMA,1691
 orionis/luminate/container/lifetimes.py,sha256=2lbdiV7R2WlJf1cLD6eBxLnJud_lZvX1IhQH2Djy3Ww,375
-orionis/luminate/container/resolve.py,sha256=Vg0VI3DGzZO6-D3AHX1BpEoiyC5hPDTR-NuiWkl7U_c,2306
+orionis/luminate/container/resolve.py,sha256=3wyMgJ0hQVAW_-Tx5nmXx3_nTjV_gSGNmqLZXUthgc8,2322
 orionis/luminate/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/application.py,sha256=FIR6WMY0y-Hkjp0jWfjJV9kwIqBb-RB1-Jl0GWCk9eI,1077
 orionis/luminate/contracts/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -67,7 +67,7 @@ orionis/luminate/contracts/console/output/progress_bar.py,sha256=sOkQzQsliFemqZH
 orionis/luminate/contracts/container/container.py,sha256=rLOS1eYir1e1e06OVNTGESbR24rFOIU1CVni_8AbHgs,8802
 orionis/luminate/contracts/container/container_integrity.py,sha256=xigWcyxLUaFoWXEI75ucJ50Ypw2NtOiRp_CgOY3Qk20,4408
 orionis/luminate/contracts/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/contracts/facades/facade.py,sha256=YZBF7KpkQ16sOxT-slwWkWMJ13LPCtdPzWuruFntCY0,1500
+orionis/luminate/contracts/facades/facade.py,sha256=LOACtfRduXo-0_de7smacMIGQHlap4D1y4oVTzsIK-Y,1516
 orionis/luminate/contracts/facades/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/facades/commands/commands_facade.py,sha256=LpSfZb3lTmhgMx0H42NmFbKLvcOqSDIbpQrkQpF9RPY,1274
 orionis/luminate/contracts/facades/commands/scheduler_facade.py,sha256=CR2E7WbYGt8ZMpekUzWBHCor3FEnBmYMDwPfKSYPq84,947
@@ -159,8 +159,11 @@ orionis/luminate/services/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm
 orionis/luminate/services/files/path_resolver_service.py,sha256=gCGVLtdXGuEIE6I8tm6JEB84HS1Fa5rk2whO2R6u8Wc,1698
 orionis/luminate/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/log/log_service.py,sha256=jrCrKz7Uj6n_ri-v5A4YOILQGUQ9MAmrlSizbbOvKhI,8303
-orionis/luminate/support/asyn_run.py,sha256=MTwVGNEnKRqD582oZRpUDQ141-hXoO5wc4NSdC7ct0E,1114
-orionis/luminate/support/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
+orionis/luminate/support/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/adapters/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
+orionis/luminate/support/async_io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/async_io/async_coroutine.py,sha256=EZJ0WUc5QX0G_KIhDAn6YQvPG6TI3A-oQI1Rjsp8NfU,2055
+orionis/luminate/support/async_io/contracts/async_coroutine.py,sha256=D2NhVwPO_TKQ9UjLn61aeC0n7GmIXHtVpdel8pruXcI,763
 orionis/luminate/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/inspection/container_integrity.py,sha256=6d9FsGk-Rm1AXgqBS3Nww49dR7n1ptXTTNyGUuBHgNY,10111
 orionis/luminate/support/inspection/functions.py,sha256=4wDT7iNp-5l4vuHk0UsIxN9wakASJRD4V0KY24uMDzk,7227
@@ -180,17 +183,21 @@ orionis/luminate/support/parsers/exception_parser.py,sha256=6MTeql76c1Muh9Nn-jz2
 orionis/luminate/support/parsers/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/parsers/contracts/exception_parser.py,sha256=HcWN7nJrvD7xLREPKEnBhyG30IkkAB7Bx_hGpcfb0ZE,912
 orionis/luminate/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/support/standard/std.py,sha256=AlhDc0CXC8_TSfZfkodefl_MwCyauX2E3CUXJF6_55w,3761
+orionis/luminate/support/standard/std.py,sha256=t6dkZxOmSsu3yaIwlvRwdTcV-6KS8lZE5YuYv7FpCb0,3573
 orionis/luminate/support/standard/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/standard/contracts/std.py,sha256=x9sVir2yg4hve56cCklIdVSr8utruIO_sUdlTNfZ1Ds,3109
 orionis/luminate/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/test/test_case.py,sha256=jFhNcUZWuDTDFpe_nYJTqXQChA4z5kxu0I2YCONGSVk,134
+orionis/luminate/test/test_case.py,sha256=y3-u3oJtCHLP-DoVW3jan2i96Y78VVdIM1pL7iV0uqU,2508
 orionis/luminate/test/test_exception.py,sha256=21PILTXnMuL5-wT3HGKjIklt8VeIYDcQDN346i-BbJw,1336
 orionis/luminate/test/test_result.py,sha256=Px2_M70r_y7BntRITk_h0IPTbSTW5XhDyklMKHm3JJI,999
 orionis/luminate/test/test_status.py,sha256=vNKRmp1lud_ZGTayf3A8wO_0vEYdFABy_oMw-RcEc1c,673
-orionis/luminate/test/test_std_out.py,sha256=annYLGDkskRpMuLwTAswwrgrYmwsXIyKE02M_ePv-qc,2765
-orionis/luminate/test/test_suite.py,sha256=eg3OwknndYSNCip_f5twpaJSFrBIuKpZQgUwBORblWA,2218
-orionis/luminate/test/test_unit.py,sha256=HtPDWzFXpgFwWYej8z2BArU4k5lItH57K_E-l21MBWo,12070
+orionis/luminate/test/test_std_out.py,sha256=rPwXCf3qvMzkZHRCu03KvLCfD4K7cPOB02BZNpXtaiU,2851
+orionis/luminate/test/test_suite.py,sha256=85OvJRZBzpFGxGw-28n0rXWYjbhACs0nZn5t3FHtzcg,2289
+orionis/luminate/test/test_unit.py,sha256=ZTsGlFJ-vwc77sfb7kLDs_sAwJL4L1YP8R9nFUWlgZY,12146
+orionis/luminate/test/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/test/contracts/test_std_out.py,sha256=ryvMotj-rpVKOsyGqW0B0IEHuF8DdQj1Rn0K8xiyBOE,489
+orionis/luminate/test/contracts/test_suite.py,sha256=ieyhZLfC09VfMraskMdWUTUFAD03aaG_8FURWI_d_YQ,1214
+orionis/luminate/test/contracts/test_unit.py,sha256=3euExuq7QgkJljnENxDyZW-okrw9S0apLnhf93o0Vqg,2612
 orionis/static/ascii/icon.ascii,sha256=IgrlVjcYxcCrr0cJuJkOnEz0aEdAQBTyLzO5ainKsWc,398
 orionis/static/ascii/info.ascii,sha256=HF_o2eXaiw5iqcOhHfnPByn5GJ_O2eBwSK3IpTfYOwY,457
 orionis/static/bg/galaxy.jpg,sha256=_FuPghOe9LBrIWv1eKZ9fiZR72sEz5obvXGDnD7MzTc,172244
@@ -204,12 +211,18 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/test_example.py,sha256=8EYjl1b-J_479dmJdQoAcKCKr7JUydW7EmPQpeiF13Y,586
 tests/support/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/adapters/test_doct_dict.py,sha256=Rh0wUZLBErqrzwoRSUa7t1rpRm-Qp-HRYk2NMSvCSrg,806
+tests/support/adapters/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/adapters/fakes/fake_dict.py,sha256=KD48_xBc8pqj3LAe1_v1esu-1Fdz8fL5eZ70LSqkcbg,393
+tests/support/async_io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/async_io/test_async_coroutine.py,sha256=1TW_gCmpN98210RV9EwpuuoEQfoFMd3VkPe0djqiang,1595
 tests/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/support/inspection/test_reflection_abstract.py,sha256=K78avxUlI_dYKofSvVcuaVLAz-CivWSe3RkhrO-IRcA,9185
-tests/support/inspection/test_reflection_concrete.py,sha256=XEDzYP3Ac0CkjoukPIFeBz2FIXYW0SJV9uAw7aC2e7E,6662
-tests/support/inspection/test_reflection_concrete_with_abstract.py,sha256=G29gqevXQd7TBOluaPpK6ER-24a4uK-zaImamig7cEE,4650
-tests/support/inspection/test_reflection_instance.py,sha256=iwwf-QY-O3kR_HTHdATUnu9iXn6Nat7d8Y8Hxhwfpb0,6938
-tests/support/inspection/test_reflection_instance_with_abstract.py,sha256=RQkw2BYY8TLuk6h_9NIa_5JfRL7RG8004ro252t6YF8,4059
+tests/support/inspection/test_reflection_abstract.py,sha256=6w8vm8H_fR4Z-KYjQGm8bq-HcetlpQl0EsDmDy3WzQ8,9311
+tests/support/inspection/test_reflection_concrete.py,sha256=3BWSU7MkFEv2UgAVAwhiaMrzEwAyDBBJCa6edOENKSU,6782
+tests/support/inspection/test_reflection_concrete_with_abstract.py,sha256=85cV9loDvtLG7sUxD6n_Ja0KV3x8FYakE2Z0W2Iruu8,4680
+tests/support/inspection/test_reflection_instance.py,sha256=8XKkEhboESLG2UaJ-STJ8STe7mUO4YDkKy01kiiGvkI,7197
+tests/support/inspection/test_reflection_instance_with_abstract.py,sha256=l6tidHJUJpWhol-E5GfQEpMZ5gIVZFsegwVtMk8tYhs,4089
 tests/support/inspection/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/inspection/fakes/fake_reflection_abstract.py,sha256=7qtz44brfFzE4oNYi9kIsvdWP79nP2FnzSz-0bU__pg,5045
 tests/support/inspection/fakes/fake_reflection_concrete.py,sha256=j6gzsxE3xq5oJ30H_Hm1RsUwEY3jOYBu4sclxtD1ayo,1047
@@ -217,14 +230,14 @@ tests/support/inspection/fakes/fake_reflection_concrete_with_abstract.py,sha256=
 tests/support/inspection/fakes/fake_reflection_instance.py,sha256=G16rZdJWC3L8SGEQkmwktvw4n7IAusIIx9Tm-ZFLcg4,1419
 tests/support/inspection/fakes/fake_reflection_instance_with_abstract.py,sha256=SfL8FuFmr650RlzXTrP4tGMfsPVZLhOxVnBXu_g1POg,1471
 tests/support/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/support/parsers/test_exception_parser.py,sha256=vSbSDAGH0TFIP4C6xfCecOgQYP-Aibqrb3K8ewWig0c,2339
+tests/support/parsers/test_exception_parser.py,sha256=s-ZRbxyr9bs5uis2SM0IN-vCc-AJhWqRnEMIVgeEFXE,2363
 tests/support/parsers/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/parsers/fakes/fake_custom_error.py,sha256=BD8tQPhmIYFYVcaeMpEQ6uK1d6pcU4EGbwRkVfCZp7c,802
 tests/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/support/standard/test_std.py,sha256=DzP9iIsWhQgq_xHJ2qdn-9tAJULC4gMLWESl0fygOVk,1982
-orionis-0.217.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.217.0.dist-info/METADATA,sha256=OhfW7ZAmuO0MuQkklf1_2KVIOr4LyTGX8_D_wzp7TLg,3003
-orionis-0.217.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.217.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.217.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.217.0.dist-info/RECORD,,
+tests/support/standard/test_std.py,sha256=bJ5LV_OKEEZa_Bk3PTk9Kapk6qECLzcKf0hfR_x2QqM,2042
+orionis-0.219.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.219.0.dist-info/METADATA,sha256=W5NoZ3LdC1k5d1-FS5YxhFFmRekdIanU22_-7aD7Zh4,3003
+orionis-0.219.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.219.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.219.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.219.0.dist-info/RECORD,,

tests/support/adapters/fakes/fake_dict.py

@@ -0,0 +1,15 @@
+fake_dict = {
+    "type": "framework",
+    "name": "Orionis Framework",
+    "features": {
+        "authentication": True,
+        "csrf_protection": True,
+        "session_management": True,
+        "logging": True,
+        "error_handling": True,
+        "database_integration": True,
+        "template_engine": True,
+        "api_support": True,
+        "routing": True
+    }
+}

tests/support/adapters/test_doct_dict.py

@@ -0,0 +1,21 @@
+from orionis.luminate.support.adapters.dot_dict import DotDict
+from orionis.luminate.test.test_case import TestCase
+from tests.support.adapters.fakes.fake_dict import fake_dict
+
+class TestsDotDict(TestCase):
+
+    async def testAccessByDot(self):
+        """
+        Test the ability to access dictionary values using dot notation.
+        """
+        # Create a DotDict instance from the fake_dict
+        dot_dict = DotDict(fake_dict)
+
+        # Access the 'type' attribute using dot notation
+        self.assertEqual(dot_dict.type, "framework")
+
+        # Access the 'name' attribute using dot notation
+        self.assertEqual(dot_dict.name, "Orionis Framework")
+
+        # Access a nested attribute using dot notation
+        self.assertEqual(dot_dict.features.authentication, True)

tests/support/async_io/test_async_coroutine.py

@@ -0,0 +1,35 @@
+from orionis.luminate.support.async_io.async_coroutine import AsyncCoroutine
+from orionis.luminate.test.test_case import TestCase
+from tests.support.adapters.fakes.fake_dict import fake_dict
+
+class TestsAsyncCoroutine(TestCase):
+
+    async def testExecuteWithActiveEventLoop(self):
+        """
+        Test the execution of a coroutine within an active event loop.
+        This test simulates a scenario where the coroutine is executed in an environment with an active event loop,
+        such as a Jupyter notebook or a Starlette application.
+        """
+        async def sample_coroutine():
+            return "Hello, World!"
+
+        result = await AsyncCoroutine.execute(sample_coroutine())
+        self.assertEqual(result, "Hello, World!")
+
+    async def testExecuteWithoutActiveEventLoop(self):
+        """
+        Test the execution of a coroutine without an active event loop.
+        This test simulates a scenario where the coroutine is executed in a synchronous context without an active event loop.
+        """
+        async def sample_coroutine():
+            return "Hello, World!"
+        result = await AsyncCoroutine.execute(sample_coroutine())
+        self.assertEqual(result, "Hello, World!")
+
+    async def testExecuteWithNonCoroutine(self):
+        """
+        Test the execution of a non-coroutine object.
+        This test checks that a TypeError is raised when a non-coroutine object is passed to the execute method.
+        """
+        with self.assertRaises(TypeError) as context:
+            AsyncCoroutine.execute("not a coroutine")