orionis 0.406.0__py3-none-any.whl → 0.407.0__py3-none-any.whl

orionis/services/system/imports.py

@@ -2,58 +2,68 @@ from typing import List, Dict, Any
 from orionis.services.system.contracts.imports import IImports
 
 class Imports(IImports):
-    """
-    Utility class to collect and display information about currently loaded Python modules.
-
-    This class provides methods to gather details about user-defined Python modules
-    currently loaded in `sys.modules`, excluding standard library and virtual environment modules.
-    It can display the collected information in a formatted table using the Rich library.
-    """
 
     def __init__(self):
         """
-        Initialize the Imports object.
+        Initialize the Imports instance.
+
+        This constructor sets up the Imports object by initializing an empty list
+        to store information about user-defined Python modules. The list will
+        contain dictionaries, each representing a module with its name, file path,
+        and defined symbols.
 
-        Initializes an empty list to store module information.
+        Returns
+        -------
+        None
+            This method does not return any value.
         """
+
+        # List to hold information about imported modules
         self.imports: List[Dict[str, Any]] = []
 
     def collect(self) -> 'Imports':
         """
         Collect information about user-defined Python modules currently loaded.
 
-        For each qualifying module, gathers:
-            - The module's name.
-            - The relative file path to the module from the current working directory.
-            - A list of symbols (functions, classes, or submodules) defined in the module.
+        Iterates through all modules in `sys.modules` and gathers details for each qualifying module:
+            - Module name.
+            - Relative file path from the current working directory.
+            - List of symbols (functions, classes, or submodules) defined in the module.
 
-        Excludes:
-            - Modules from the standard library.
-            - Modules from the active virtual environment (if any).
-            - Binary extension modules (.pyd, .dll, .so).
-            - Special modules like "__main__", "__mp_main__", and modules starting with "_distutils".
+        Excludes modules that:
+            - Are part of the standard library.
+            - Reside in the active virtual environment (if any).
+            - Are binary extension modules (e.g., `.pyd`, `.dll`, `.so`).
+            - Are special modules such as `"__main__"`, `"__mp_main__"`, or those starting with `"_distutils"`.
 
-        The collected information is stored in `self.imports` as a list of dictionaries.
+        The collected information is stored in `self.imports` as a list of dictionaries, each containing the module's name, file path, and symbols.
 
         Returns
         -------
         Imports
-            The current instance with updated imports information.
+            The current instance of `Imports` with the `imports` attribute updated to include information about the collected modules.
         """
 
         import sys
         import os
         import types
 
+        # Clear any previously collected imports
         self.imports.clear()
+
+        # Get standard library paths to exclude standard modules
         stdlib_paths = [os.path.dirname(os.__file__)]
+
+        # Get virtual environment path if active
         venv_path = os.environ.get("VIRTUAL_ENV")
         if venv_path:
             venv_path = os.path.abspath(venv_path)
 
+        # Iterate over all loaded modules
         for name, module in list(sys.modules.items()):
-            file:str = getattr(module, '__file__', None)
+            file: str = getattr(module, '__file__', None)
 
+            # Filter out unwanted modules based on path, type, and name
             if (
                 file
                 and not any(file.startswith(stdlib_path) for stdlib_path in stdlib_paths)
@@ -62,18 +72,25 @@ class Imports(IImports):
                 and name not in ("__main__", "__mp_main__")
                 and not name.startswith("_distutils")
             ):
+
+                # Get relative file path from current working directory
                 rel_file = os.path.relpath(file, os.getcwd())
                 symbols = []
 
+                # Collect symbols defined in the module (functions, classes, submodules)
                 try:
                     for attr in dir(module):
                         value = getattr(module, attr)
                         if isinstance(value, (types.FunctionType, type, types.ModuleType)):
+
+                            # Ensure symbol is defined in this module
                             if getattr(value, '__module__', None) == name:
                                 symbols.append(attr)
                 except Exception:
+                    # Ignore errors during symbol collection
                     pass
 
+                # Only add modules that are not __init__.py and have symbols
                 if not rel_file.endswith('__init__.py') and symbols:
                     self.imports.append({
                         "name": name,
@@ -81,32 +98,45 @@ class Imports(IImports):
                         "symbols": symbols,
                     })
 
+        # Return the current instance with updated imports
         return self
 
     def display(self) -> None:
         """
         Display a formatted table of collected import statements using the Rich library.
 
-        If the imports have not been collected yet, it calls `self.collect()` to gather them.
-        The table includes columns for the import name, file, and imported symbols, and is
-        rendered inside a styled panel in the console.
+        This method presents a visual summary of all collected user-defined Python modules.
+        If the imports have not been collected yet, it automatically calls `self.collect()` to gather them.
+        The output is rendered as a table inside a styled panel in the console, showing each module's name,
+        relative file path, and its defined symbols.
+
+        Parameters
+        ----------
+        None
 
         Returns
         -------
         None
+            This method does not return any value. It outputs the formatted table to the console.
         """
 
+        # Collect imports if not already done
         if not self.imports:
             self.collect()
 
+        # Import Rich components for console output
         from rich.console import Console
         from rich.table import Table
         from rich.box import MINIMAL
         from rich.panel import Panel
 
+        # Create a console instance for output
         console = Console()
+
+        # Set table width to 75% of console width
         width = int(console.size.width * 0.75)
 
+        # Create a table with minimal box style and custom formatting
         table = Table(
             box=MINIMAL,
             show_header=True,
@@ -117,14 +147,17 @@ class Imports(IImports):
             collapse_padding=True,
         )
 
+        # Add columns for module name, file path, and symbols
         table.add_column("Name", style="cyan", no_wrap=True)
         table.add_column("File", style="white")
         table.add_column("Symbols", style="magenta")
 
+        # Populate the table with sorted import data
         for imp in sorted(self.imports, key=lambda x: x["name"].lower()):
             symbols_str = ", ".join(imp["symbols"])
             table.add_row(imp["name"], imp["file"], symbols_str)
 
+        # Render the table inside a styled panel in the console
         console.print(Panel(
             table,
             title="[bold blue]🔎 Loaded Python Modules (Orionis Imports Trace)[/bold blue]",
@@ -134,10 +167,17 @@ class Imports(IImports):
 
     def clear(self) -> None:
         """
-        Clear the collected imports list.
+        Remove all entries from the collected imports list.
+
+        This method resets the `imports` attribute by removing all currently stored
+        module information. It is useful for discarding previously collected data
+        before performing a new collection or when a fresh state is required.
 
         Returns
         -------
         None
+            This method does not return any value. The `imports` list is emptied in place.
         """
+
+        # Remove all items from the imports list to reset its state
         self.imports.clear()

orionis/services/system/runtime/imports.py

@@ -25,6 +25,7 @@ Notes
 - Thread safety is provided via a threading.Lock.
 
 """
+
 import builtins
 from collections import defaultdict
 from threading import Lock
@@ -40,40 +41,48 @@ _import_lock = Lock()
 
 def custom_import(name, globals=None, locals=None, fromlist=(), level=0):
     """
-    Custom import function that tracks imports of 'orionis' modules.
+    Tracks and logs imports of modules whose names start with 'orionis'.
+
+    This function overrides Python's built-in import mechanism to monitor
+    how many times modules from the 'orionis' package are imported. It
+    increments an internal counter for each such import and prints a log
+    message with the module name, import count, and fromlist. Thread safety
+    is ensured using a lock.
 
     Parameters
     ----------
     name : str
         The name of the module to import.
     globals : dict, optional
-        The global namespace.
+        The global namespace in which the import is performed.
     locals : dict, optional
-        The local namespace.
+        The local namespace in which the import is performed.
     fromlist : tuple, optional
         Names to import from the module.
     level : int, optional
-        Relative import level.
+        Relative import level (0 for absolute, >0 for relative).
 
     Returns
     -------
-    module
-        The imported module.
+    module : ModuleType
+        The imported module object as returned by the original import function.
     """
-    # Check if the module name starts with 'orionis'
+    # Only track imports for modules starting with 'orionis'
     if str(name).startswith("orionis"):
         with _import_lock:
+
+            # Increment the import count for this module
             _import_count[name] += 1
             count = _import_count[name]
 
-            # Print the import details
+            # Print import details to the console
             print(
                 f"\033[1;37mModule\033[0m: \033[90m{name}\033[0m | "
                 f"\033[1;37mImported\033[0m: \033[90m{count}\033[0m | "
                 f"\033[1;37mFromList\033[0m: \033[90m{fromlist}\033[0m"
             )
 
-    # Call the original import function
+    # Delegate the actual import to the original __import__ function
     return _original_import(name, globals, locals, fromlist, level)
 
 # Override the built-in __import__ function

orionis/services/system/workers.py

@@ -4,21 +4,10 @@ import psutil
 from orionis.services.system.contracts.workers import IWorkers
 
 class Workers(IWorkers):
-    """
-    Estimate the optimal number of worker processes based on system CPU and memory resources.
-
-    This class calculates the recommended number of Uvicorn (or similar) workers by considering:
-    the number of available CPU cores, total system memory (RAM), and the estimated memory usage per worker.
-
-    Parameters
-    ----------
-    ram_per_worker : float, optional
-        Estimated amount of RAM in gigabytes (GB) that each worker will consume. Default is 0.5.
-    """
 
     def __init__(self, ram_per_worker: float = 0.5):
         """
-        Initialize the worker system with resource constraints.
+        Initialize the Workers system with resource constraints.
 
         Parameters
         ----------
@@ -33,31 +22,75 @@ class Workers(IWorkers):
             Total system RAM in gigabytes.
         _ram_per_worker : float
             RAM allocated per worker in gigabytes.
+
+        Returns
+        -------
+        None
+            This constructor does not return a value.
         """
+
+        # Get the number of CPU cores available
         self._cpu_count = multiprocessing.cpu_count()
+
+        # Get the total system RAM in gigabytes
         self._ram_total_gb = psutil.virtual_memory().total / (1024 ** 3)
+
+        # Set the RAM allocated per worker
         self._ram_per_worker = ram_per_worker
 
     def setRamPerWorker(self, ram_per_worker: float) -> None:
         """
-        Set the amount of RAM allocated per worker.
+        Update the RAM allocation per worker.
 
         Parameters
         ----------
         ram_per_worker : float
-            Amount of RAM (in GB) allocated per worker.
+            The new amount of RAM (in GB) to allocate for each worker.
+
+        Returns
+        -------
+        None
+            This method does not return a value. It updates the internal RAM allocation setting.
+
+        Notes
+        -----
+        Changing the RAM allocation per worker may affect the recommended number of workers
+        calculated by the system. This method only updates the internal configuration and does
+        not trigger any recalculation automatically.
         """
+
+        # Update the RAM allocated per worker
         self._ram_per_worker = ram_per_worker
 
     def calculate(self) -> int:
         """
-        Compute the maximum number of workers supported by the current machine.
+        Compute the recommended maximum number of worker processes for the current machine,
+        considering both CPU and memory constraints.
+
+        Parameters
+        ----------
+        None
 
         Returns
         -------
         int
-            The recommended number of worker processes based on CPU and memory constraints.
+            The maximum number of worker processes that can be safely run in parallel,
+            determined by the lesser of available CPU cores and memory capacity.
+
+        Notes
+        -----
+        The calculation is based on:
+            - The total number of CPU cores available.
+            - The total system RAM divided by the RAM allocated per worker.
+        The method ensures that neither CPU nor memory resources are overcommitted.
+
         """
+
+        # Calculate the maximum workers allowed by CPU core count
         max_workers_by_cpu = self._cpu_count
+
+        # Calculate the maximum workers allowed by available RAM
         max_workers_by_ram = math.floor(self._ram_total_gb / self._ram_per_worker)
+
+        # Return the minimum of the two to avoid overcommitting resources
         return min(max_workers_by_cpu, max_workers_by_ram)

orionis/test/output/dumper.py

@@ -65,6 +65,7 @@ class TestDumper(ITestDumper):
                     AsyncTestCase,
                     SyncTestCase,
                     unittest.TestCase,
+                    unittest.IsolatedAsyncioTestCase
                 ),
             )
 

{orionis-0.406.0.dist-info → orionis-0.407.0.dist-info}/METADATA

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

{orionis-0.406.0.dist-info → orionis-0.407.0.dist-info}/RECORD

@@ -258,24 +258,26 @@ orionis/foundation/providers/progress_bar_provider.py,sha256=WW3grNgH-yV2meSSTeO
 orionis/foundation/providers/testing_provider.py,sha256=iJSN2RIChbYIL-1ue6vmPmDMCSrvERDkti4Er9MPiLA,1102
 orionis/foundation/providers/workers_provider.py,sha256=kiQjQRyUEyiBX2zcbF_KmqRgvc7Bvxsvg5oMtIvYniM,1075
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=7tsbyNrZzvwa53bbYPFKynkVczIn2llFfSswwTIClaM,4960
+orionis/metadata/framework.py,sha256=sxmczNtZqJR0Rs5IYehyU1JvfxRfRsuHwLo1m8wI70g,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/asynchrony/coroutines.py,sha256=GkTyv-uHo-MOzwo8akwIS2HDSkTaL3CpnaRPG-4iXUY,2365
+orionis/services/asynchrony/coroutines.py,sha256=Aj5a1LTosnGUA0meSHivC1OJBYOQ7xq3US_PzWTc91w,3113
 orionis/services/asynchrony/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/asynchrony/contracts/coroutines.py,sha256=Wuwp2k4HXAX-tQ3waVIT8AmzX_HeIbjliRchKIqy2k0,688
+orionis/services/asynchrony/contracts/coroutines.py,sha256=BOMDd84mZB2IndaTbGdQOAvil-KAsO6YcX5tv0A1FKo,1145
 orionis/services/asynchrony/exceptions/__init__.py,sha256=COm6RhSiuwWqy3YcJ_0gVu6XHjn5P3zVaiUp5Pw_h48,99
-orionis/services/asynchrony/exceptions/exception.py,sha256=eopQpl-2chut-iN1drBy-53EDKava1icwtcWUF4S1Cc,472
+orionis/services/asynchrony/exceptions/exception.py,sha256=yAVsjZ2lLAoFgNIiMcOtCYnwGI1y8GoYdUAxTQwLtTY,820
 orionis/services/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/environment/env.py,sha256=vKx9zO2DpUK089fL17qxQ4X4tLYzN3exGAKg3d-rp3c,2272
 orionis/services/environment/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/environment/contracts/env.py,sha256=7lezGxABAG63pEEvzAmHXgr9izBI6TCp05Trx_SRvc4,2054
 orionis/services/environment/contracts/types.py,sha256=n0USxUblz0Ofbo1ef0hnGHGkuGjSiWk-SBWVPXv33mE,1994
 orionis/services/environment/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/environment/core/dot_env.py,sha256=EZZTI-SuwCXgEXXmGOKhAARQIWxUSjYVIhWsMbE3TMI,10157
+orionis/services/environment/core/dot_env.py,sha256=Dgkmy0juaFKZPEkv7nN7VvdYryX8fDs0JgRGOIHj7PM,10090
 orionis/services/environment/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/environment/dynamic/types.py,sha256=nf7HJjm-1S-BH2YnuBQNNWvb3Aqu-QYPUTfJRgVYZ1Y,18336
+orionis/services/environment/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/services/environment/enums/cast_type.py,sha256=hoZhljXHNn03VYbg6VTauGyppmcoRjaepylrOKSBvu8,1217
 orionis/services/environment/exceptions/__init__.py,sha256=YwLc8GsB0swlwu9T9Qt2vevaCoq5V2vmPUSlEUAqg2Q,199
 orionis/services/environment/exceptions/exception.py,sha256=NnxWmgoSca7LXi7GLDa95HSBPKotFfy8u729d1OAmCc,479
 orionis/services/environment/exceptions/value.py,sha256=Pe1qNHRrM9T0AzESN284CzA3GQYxzokfXPMOVqOTlyQ,475
@@ -283,6 +285,11 @@ orionis/services/environment/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeu
 orionis/services/environment/helpers/functions.py,sha256=MtlDTA1W8KVJu0cohh4TsuPg8CPcnySf36cp9E9tpJI,595
 orionis/services/environment/key/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/environment/key/key_generator.py,sha256=BHvcFiPOmJHQotstMNkUdoEwb0mNxQk5iyvQU3JlJ94,1134
+orionis/services/environment/serializer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/services/environment/serializer/values.py,sha256=ERnQWgCAljhJ9pRSd-knnGD5i6ne5Ho-4bh93pgDtwY,364
+orionis/services/environment/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/services/environment/validators/key_name.py,sha256=heMQoMY4vF9sIYAlET7noTQz383daGPvJnJOb62nxFo,1577
+orionis/services/environment/validators/types.py,sha256=AQvIZzBWxZ6-iJhzRkroim5CKBvWq2lTttRyXzc-6GU,1922
 orionis/services/introspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/reflection.py,sha256=_Wdy8Wtt3RKXAqg9o5rvYa_Hyu-Z4674LKnNVg7u7pU,11467
 orionis/services/introspection/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -338,13 +345,13 @@ orionis/services/paths/exceptions/__init__.py,sha256=r5b4D4XWNK07zLtqaXBk_PNYszS
 orionis/services/paths/exceptions/exception.py,sha256=cK-TbUT02X2lvbAP4yFdfHx4S45wBOcYl3_tiWd67UM,472
 orionis/services/paths/exceptions/file.py,sha256=bsK0QoXwRFyDeHvITxwmgaBuwiO2eoRUhRzNizmX1No,475
 orionis/services/system/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/system/imports.py,sha256=5j2Rkf6vMLnCQjqcox4-0y0tZoxgPfv7EP8eruG7vnA,4990
-orionis/services/system/workers.py,sha256=QO5IXjH8BXWUlHzH1TiRKt3vn4LZklRI02nSL17hWPo,2199
+orionis/services/system/imports.py,sha256=aSXG9879ur91d6OsqV2DUYWmmwbwFHX8CHb99cPfFcU,7057
+orionis/services/system/workers.py,sha256=EfGxU_w42xRnZ1yslsui3wVG8pfe__V3GYGEIyo8JxQ,3144
 orionis/services/system/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/system/contracts/imports.py,sha256=nE2fDS2bDbwltHCmzOsEMhUymYy092zoGX-NOXLE4J4,1167
-orionis/services/system/contracts/workers.py,sha256=plst9CcYqwkEcy-LPdfJbdKPKaeq8hmtWk0B5mlH2wo,1017
+orionis/services/system/contracts/imports.py,sha256=wTlr0ck1vcrAoBU91_rgu8cN4dCRnWixsq-ovwXQOn0,2767
+orionis/services/system/contracts/workers.py,sha256=T7P48btql90IaPugMVUmR0Gl2-r9DnuOwTpJZkRvg0Q,1837
 orionis/services/system/runtime/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/system/runtime/imports.py,sha256=eWp_MmrvxWHl-lsNO0M5FC9OsCcY1BXsiJTlPk0cfRU,2550
+orionis/services/system/runtime/imports.py,sha256=iIwIx8RjBHaiveCdj_WPiMMbWsKGbIs02qpAzL_L3Z0,3158
 orionis/support/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/support/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/support/entities/base.py,sha256=4WuAzrk_sfWp8Wv5Yl9IUF6kTctlAXlSxHGh5mdu3MQ,3982
@@ -399,7 +406,7 @@ orionis/test/exceptions/persistence.py,sha256=GbNwpUfrtZ-VstX_Amflg8OwQ3WEWOnDmn
 orionis/test/exceptions/runtime.py,sha256=yLLBtDR61k53OIAwi5wVLxap79Agh2khXrhRb4bTe9k,778
 orionis/test/exceptions/value.py,sha256=P9SD64EWATKneV-QP-yhfJ2GxyypKxqgmk5MqiguxV0,1001
 orionis/test/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/output/dumper.py,sha256=GSWWAWIW_OfN9HOORhn_AsEzYEJFgGstfwBp14hudDg,7094
+orionis/test/output/dumper.py,sha256=vagHHjTaRdffCBO7pjylsYqSSoh11MnavZcCmr8RLPs,7148
 orionis/test/output/printer.py,sha256=cpElVLaK94JtQeHpgN-HTSuE8dJhPhZMt51L7Lramz8,29080
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/records/logs.py,sha256=WhOmRJhQck76vx8l_c_7M-H8_RS9p3yB_jJ39Rnx-Lc,19050
@@ -421,7 +428,7 @@ orionis/test/validators/web_report.py,sha256=-h3Fe9jY93_kzUhd2NBIqEfCcBpu-8Ei9x3
 orionis/test/validators/workers.py,sha256=LGffDKtK6SKixFKzIYPQpI5aFeQPAGXpv_LUtmEu6g4,1102
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=3ICz68l-WF3BtnYqH5m-ktN9UD00MELMbmMnyJDV74A,4768
-orionis-0.406.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.407.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/test_container.py,sha256=INLMHbcQzB7SQi6W0xO_nKCMUw50VK7NQMPRDuYnU5Q,10781
@@ -454,7 +461,7 @@ tests/container/validators/test_is_subclass.py,sha256=iid5n1B6GDYqwtSlmRG0lJBH6g
 tests/container/validators/test_is_valid_alias.py,sha256=mRkdDLHZuM0ogJn38lV35gwnxXP3J-a-1EWaoij-qUM,3957
 tests/container/validators/test_lifetime.py,sha256=2iOO8Leo7VHb9ZrbiwaTptFC4hHv3QStomcFMO3qSH0,3191
 tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/example/test_example.py,sha256=yctjQT5ocYEu__kNvJxmQJ-l5yxRMkohwcfYWSjWDVo,25566
+tests/example/test_example.py,sha256=XJEcsro3vCO5m4zvMiWUGphvd0C7oIkBtUfQgTDsdUU,25568
 tests/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -509,11 +516,11 @@ tests/foundation/config/testing/test_foundation_config_testing.py,sha256=BQsQVGm
 tests/foundation/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/foundation/exceptions/test_foundation_config_exceptions.py,sha256=tiXKxGSP8majXpLPyoGR0WGvDE1LoLXQK6NpcQNqz_A,4091
 tests/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/metadata/test_metadata_framework.py,sha256=S0eujj2Z3PWpPBzpoqShs4rkfD4Frna4geUoS_uZfTE,3380
-tests/metadata/test_metadata_package.py,sha256=WaBnp0ufj9NKbLzMOCBdt5OAWr-WCA_j8Y05vgC_8Ek,2870
+tests/metadata/test_metadata_framework.py,sha256=1tCNciuPVgZPK-V8PzENJCXN-1bTktWPN9u03N4Eelw,5499
+tests/metadata/test_metadata_package.py,sha256=gXIX-N9toEHJsmFkdhAvJRnz2T5e6pbgK37I1eFYTGM,4770
 tests/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/services/asynchrony/test_services_asynchrony_coroutine.py,sha256=KijsHjPiia1w5_yJJWjJrFocjQEfbMT9kj1F4nY-Kbs,1659
+tests/services/asynchrony/test_services_asynchrony_coroutine.py,sha256=34Y0D6w2bVo_dm3oj0wzedMIJuSYieUG9Y2J1EQmZeo,3439
 tests/services/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/environment/test_services_environment.py,sha256=6UH3g2Z2DQYtGnyySCRnT35VCENlL-PQWHIdH6zA9rw,3767
 tests/services/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -535,8 +542,8 @@ tests/services/inspection/reflection/mock/fake_reflect_instance.py,sha256=iqWoT6
 tests/services/path/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/path/test_services_resolver.py,sha256=aWSSFgV_D10t3llUeCWEBB1mF3dWrZbFn5XbJy2sQME,3903
 tests/services/system/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/services/system/test_services_system_imports.py,sha256=RI7DHZUJSbtlL7xDSmbUtCMrIdE417qaMCJlL5H9IHQ,2967
-tests/services/system/test_services_system_workers.py,sha256=7WFs3u52kXs3FTWsqT7V3US4fqdQ6Cmd2pb8W_Mn7wk,3050
+tests/services/system/test_services_system_imports.py,sha256=jbtIQkw_4DI6x2E-4Lg3evnLAgCgDIBWE63LdJTLkxc,7507
+tests/services/system/test_services_system_workers.py,sha256=wITbpJHKW_OXqTaFeteNRFuw5Q3_7d9lWNJnFE2r6to,5052
 tests/support/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/parsers/test_services_parser_exceptions.py,sha256=3q2koa73YRaQXDUWp7GAX1e-rgeazwP7mSNhMkJLoQA,2672
@@ -552,8 +559,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=nTNrvJkMSPx_aopEQ9
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=aWOOJiHji_U7gcJHbDukgMmfBEEQCLQdyqpXJD5q4BE,4643
 tests/testing/test_testing_unit.py,sha256=Krz0Bw1toI9qvLtKtYe_slNvi7fYmZbHK1i4DRPMfUM,7952
-orionis-0.406.0.dist-info/METADATA,sha256=rmI1fb0IoWTgG06IaCrA7FP5_1RSTPE6HfE034kJfc0,4772
-orionis-0.406.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.406.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.406.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.406.0.dist-info/RECORD,,
+orionis-0.407.0.dist-info/METADATA,sha256=x5LuteMx1-CBNPvZWGQE24vZVBlrwoXIfo-QOGJDJFw,4772
+orionis-0.407.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.407.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.407.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.407.0.dist-info/RECORD,,

tests/example/test_example.py

@@ -6,7 +6,7 @@ This module contains comprehensive test examples demonstrating the capabilities
 of the Orionis testing framework, including both synchronous and asynchronous
 testing patterns with dependency injection.
 
-Examples
+Examples:
 --------
     Run synchronous tests:
         >>> from tests.example.test_example import TestSynchronousExample
@@ -20,7 +20,7 @@ Examples
         >>> await test.asyncSetUp()
         >>> await test.testAsyncBasicOperations()
 
-Notes
+Notes:
 -----
     These examples showcase:
     - Dependency injection patterns