orionis 0.408.0__py3-none-any.whl → 0.410.0__py3-none-any.whl

orionis/metadata/framework.py

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

orionis/services/log/contracts/log_service.py

@@ -4,20 +4,72 @@ class ILoggerService(ABC):
 
     @abstractmethod
     def info(self, message: str) -> None:
-        """Log an informational message."""
+        """
+        Logs an informational message.
+
+        Parameters
+        ----------
+        message : str
+            The message to be logged as informational.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        # To be implemented by subclasses
         pass
 
     @abstractmethod
     def error(self, message: str) -> None:
-        """Log an error message."""
+        """
+        Logs an error message.
+
+        Parameters
+        ----------
+        message : str
+            The message to be logged as an error.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        # To be implemented by subclasses
         pass
 
     @abstractmethod
     def warning(self, message: str) -> None:
-        """Log a warning message."""
+        """
+        Logs a warning message.
+
+        Parameters
+        ----------
+        message : str
+            The message to be logged as a warning.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        # To be implemented by subclasses
         pass
 
     @abstractmethod
     def debug(self, message: str) -> None:
-        """Log a debug message."""
+        """
+        Logs a debug message.
+
+        Parameters
+        ----------
+        message : str
+            The message to be logged for debugging purposes.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        # To be implemented by subclasses
         pass

orionis/services/log/handlers/filename.py

@@ -12,19 +12,27 @@ class FileNameLogger:
         ----------
         path : str
             The original file path for the log file.
-        """
 
-        # If the path is not a string or is empty, raise a ValueError
+        Raises
+        ------
+        ValueError
+            If the provided path is not a non-empty string.
+        """
+        # Validate that the path is a non-empty string
         if not isinstance(path, str) or not path:
             raise ValueError("The 'path' parameter must be a non-empty string.")
 
-        # Set the instance variable __path to the stripped path
+        # Store the stripped path as a private instance variable
         self.__path = path.strip()
 
     def generate(self) -> str:
         """
         Generate a new log file path with a timestamp prefix.
 
+        The method constructs a new file path by prefixing the original file name
+        with a timestamp in the format 'YYYYMMDD_HHMMSS'. It also ensures that the
+        directory for the log file exists, creating it if necessary.
+
         Returns
         -------
         str
@@ -32,10 +40,10 @@ class FileNameLogger:
 
         Notes
         -----
-        The method ensures that the directory for the log file exists.
+        - The timestamp is generated using the current date and time.
+        - The directory for the log file is created if it does not exist.
         """
-
-        # Split the original path to extract the base name and extension
+        # Split the original path into components based on the separator
         if '/' in self.__path:
             parts = self.__path.split('/')
         elif '\\' in self.__path:
@@ -43,22 +51,22 @@ class FileNameLogger:
         else:
             parts = self.__path.split(os.sep)
 
-        # Get the base name and extension
+        # Extract the base file name and its extension
         filename, ext = os.path.splitext(parts[-1])
 
-        # Create the path without the last part
+        # Reconstruct the directory path (excluding the file name)
         path = os.path.join(*parts[:-1]) if len(parts) > 1 else ''
 
-        # Prefix the base name with a timestamp
+        # Generate a timestamp prefix for the file name
         prefix = datetime.now().strftime("%Y%m%d_%H%M%S")
 
-        # Join the path, prefix, and filename to create the full path
+        # Build the full file path with the timestamped file name
         full_path = os.path.join(path, f"{prefix}_{filename}{ext}")
 
-        # Ensure the log directory exists
+        # Ensure the log directory exists; create it if it does not
         log_dir = Path(full_path).parent
         if not log_dir.exists():
             log_dir.mkdir(parents=True, exist_ok=True)
 
-        # Return the full path as a string
+        # Return the full path to the timestamped log file
         return full_path

orionis/services/log/handlers/size_rotating.py

@@ -5,17 +5,25 @@ class PrefixedSizeRotatingFileHandler(RotatingFileHandler):
 
     def rotation_filename(self, default_name) -> str:
         """
-        Generate a rotated log filename by prefixing the original filename with a timestamp.
+        Generates a rotated log filename by prefixing the original filename with a timestamp.
 
         Parameters
         ----------
         default_name : str
-            The original file path to be rotated.
+            The original file path that is subject to rotation.
 
         Returns
         -------
         str
-            The new file path with the base name prefixed by a timestamp in the format 'YYYYMMDD_HHMMSS'.
+            The new file path as a string, where the base name is prefixed with a timestamp
+            in the format 'YYYYMMDD_HHMMSS'. This ensures uniqueness and chronological ordering
+            of rotated log files.
+
+        Notes
+        -----
+        This method utilizes the FileNameLogger class to construct the prefixed filename.
+        The timestamp prefix helps in identifying the creation time of each rotated log file.
         """
 
+        # Generate the new filename using FileNameLogger, which adds a timestamp prefix.
         return FileNameLogger(default_name).generate()

orionis/services/log/handlers/timed_rotating.py

@@ -5,17 +5,25 @@ class PrefixedTimedRotatingFileHandler(TimedRotatingFileHandler):
 
     def rotation_filename(self, default_name) -> str:
         """
-        Generate a rotated log filename by prefixing the original filename with a timestamp.
+        Generates a rotated log filename by prefixing the original filename with a timestamp.
 
         Parameters
         ----------
         default_name : str
-            The original file path to be rotated.
+            The original file path that is subject to rotation.
 
         Returns
         -------
         str
-            The new file path with the base name prefixed by a timestamp in the format 'YYYYMMDD_HHMMSS'.
+            The new file path as a string, where the base name is prefixed with a timestamp
+            in the format 'YYYYMMDD_HHMMSS'. This ensures each rotated log file is uniquely
+            identified by its creation time.
+
+        Notes
+        -----
+        This method utilizes the FileNameLogger class to construct the new filename.
+        The timestamp prefix helps in organizing and distinguishing rotated log files.
         """
 
+        # Use FileNameLogger to generate a new filename with a timestamp prefix
         return FileNameLogger(default_name).generate()

orionis/services/log/log_service.py

@@ -14,33 +14,46 @@ class LoggerService(ILoggerService):
         **kwargs
     ):
         """
-        Initialize the LoggerService with the provided configuration.
+        Initializes the LoggerService instance with the provided logging configuration.
+
+        This constructor sets up the logger configuration using either a `Logging` object,
+        a configuration dictionary, or keyword arguments. It validates the input and
+        ensures that the configuration is properly instantiated before initializing
+        the logger. If no configuration is provided, it attempts to create one using
+        the supplied keyword arguments.
 
         Parameters
         ----------
         config : Logging or dict, optional
-            The logging configuration. Can be an instance of the Logging class,
-            a dictionary of configuration parameters, or None. If None, configuration
-            is initialized using kwargs.
+            The logging configuration. Can be an instance of the `Logging` class,
+            a dictionary containing configuration parameters, or None. If None,
+            configuration is initialized using `kwargs`.
         **kwargs
-            Additional keyword arguments used to initialize the Logging configuration
-            if config is None.
+            Additional keyword arguments used to initialize the `Logging` configuration
+            if `config` is None.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It sets up the logger service instance.
 
         Raises
         ------
         LoggerRuntimeError
-            If the logger configuration cannot be initialized from the provided arguments.
+            If the logger configuration cannot be initialized from the provided arguments,
+            such as invalid types or missing required parameters.
         """
 
-        # Attributes
+        # Initialize private attributes for logger and configuration
         self.__logger = None
         self.__config = None
 
-        # Initialize the logger configuration using **kwargs if provided
+        # If no configuration is provided, attempt to create one using kwargs
         if config is None:
             try:
                 self.__config = Logging(**kwargs)
             except Exception as e:
+                # Raise a runtime error if configuration initialization fails
                 raise LoggerRuntimeError(
                     f"Error initializing logger configuration: {e}. "
                     "Please check the provided parameters. "
@@ -49,54 +62,64 @@ class LoggerService(ILoggerService):
                     f"Expected: {Logging.__module__}.{Logging.__name__} or dict."
                 )
 
-        # If config is a dictionary, convert it to Logging
+        # If config is a dictionary, convert it to a Logging instance
         elif isinstance(config, dict):
             self.__config = Logging(**config)
 
-        # If config is already an instance of Logging, use it directly
+        # If config is already a Logging instance, use it directly
         elif isinstance(config, Logging):
             self.__config = config
 
-        # Initialize LoggerService
+        # Initialize the logger using the validated configuration
         self.__initLogger()
 
     def __initLogger(self):
         """
-        Configures the logger with the specified settings.
+        Initializes and configures the logger instance based on the provided settings.
+
+        This method sets up the logger to write logs to a file, using different handlers
+        depending on the logging channel type (e.g., stack, hourly, daily, weekly, monthly, chunked).
+        It ensures the log format includes a timestamp, log level, and message. If the specified
+        log directory does not exist, it is created automatically. The logger's level and retention
+        policies are determined by the configuration.
+
+        Parameters
+        ----------
+        None
 
-        This method sets up the logger to write logs to a file. If the specified
-        directory does not exist, it creates it. The log format includes the
-        timestamp and the log message.
+        Returns
+        -------
+        None
+            This method does not return any value. It sets up the logger instance as an attribute.
 
         Raises
         ------
         LoggerRuntimeError
-            If the logger cannot be initialized due to an error.
+            If the logger cannot be initialized due to an error in configuration or handler setup.
         """
         import logging
         from datetime import datetime
 
         try:
-
-            # List to hold the handlers
+            # List to hold the logging handlers
             handlers = []
 
-            # Get the channel from the configuration
+            # Retrieve the default logging channel from configuration
             channel: str = self.__config.default
 
-            # Get the configuration for the specified channel
+            # Get the configuration object for the selected channel
             config_channels = getattr(self.__config.channels, channel)
 
-            # Get the path from the channel configuration
+            # Generate the log file path using the FileNameLogger utility
             path: str = FileNameLogger(getattr(config_channels, 'path')).generate()
 
-            # Get Level from the channel configuration, defaulting to 10 (DEBUG)
+            # Determine the logging level (default to DEBUG if not specified)
             level: Level | int = getattr(config_channels, 'level', 10)
             level = level if isinstance(level, int) else level.value
 
-            # Create handlers based on the channel type
+            # Select and configure the appropriate handler based on the channel type
             if channel == "stack":
-
+                # Simple file handler for stack channel
                 handlers = [
                     logging.FileHandler(
                         filename=path,
@@ -105,89 +128,92 @@ class LoggerService(ILoggerService):
                 ]
 
             elif channel == "hourly":
-
+                # Rotating file handler for hourly logs
                 handlers = [
                     PrefixedTimedRotatingFileHandler(
-                        filename = path,
-                        when = "h",
-                        interval = 1,
-                        backupCount = getattr(config_channels, 'retention_hours', 24),
-                        encoding = "utf-8",
-                        utc = False
+                        filename=path,
+                        when="h",
+                        interval=1,
+                        backupCount=getattr(config_channels, 'retention_hours', 24),
+                        encoding="utf-8",
+                        utc=False
                     )
                 ]
 
             elif channel == "daily":
-
+                # Rotating file handler for daily logs
                 handlers = [
                     PrefixedTimedRotatingFileHandler(
-                        filename = path,
-                        when = "d",
-                        interval = 1,
-                        backupCount = getattr(config_channels, 'retention_days', 7),
-                        encoding = "utf-8",
-                        atTime = datetime.strptime(getattr(config_channels, 'at', "00:00"), "%H:%M").time(),
-                        utc = False
+                        filename=path,
+                        when="d",
+                        interval=1,
+                        backupCount=getattr(config_channels, 'retention_days', 7),
+                        encoding="utf-8",
+                        atTime=datetime.strptime(getattr(config_channels, 'at', "00:00"), "%H:%M").time(),
+                        utc=False
                     )
                 ]
 
             elif channel == "weekly":
-
+                # Rotating file handler for weekly logs
                 handlers = [
                     PrefixedTimedRotatingFileHandler(
-                        filename = path,
-                        when = "w0",
-                        interval = 1,
-                        backupCount = getattr(config_channels, 'retention_weeks', 4),
-                        encoding = "utf-8",
-                        utc = False
+                        filename=path,
+                        when="w0",
+                        interval=1,
+                        backupCount=getattr(config_channels, 'retention_weeks', 4),
+                        encoding="utf-8",
+                        utc=False
                     )
                 ]
 
             elif channel == "monthly":
-
+                # Rotating file handler for monthly logs
                 handlers = [
                     PrefixedTimedRotatingFileHandler(
-                        filename = path,
-                        when = "midnight",
-                        interval = 30,
-                        backupCount = getattr(config_channels, 'retention_months', 4),
-                        encoding = "utf-8",
-                        utc = False
+                        filename=path,
+                        when="midnight",
+                        interval=30,
+                        backupCount=getattr(config_channels, 'retention_months', 4),
+                        encoding="utf-8",
+                        utc=False
                     )
                 ]
 
             elif channel == "chunked":
-
+                # Size-based rotating file handler for chunked logs
                 handlers = [
                     PrefixedSizeRotatingFileHandler(
-                        filename = path,
-                        maxBytes = getattr(config_channels, 'mb_size', 10) * 1024 * 1024,
-                        backupCount =getattr(config_channels, 'files', 5),
-                        encoding ="utf-8"
+                        filename=path,
+                        maxBytes=getattr(config_channels, 'mb_size', 10) * 1024 * 1024,
+                        backupCount=getattr(config_channels, 'files', 5),
+                        encoding="utf-8"
                     )
                 ]
 
-            # Configure the logger
+            # Configure the logger with the selected handlers and formatting
             logging.basicConfig(
-                level = level,
-                format = "%(asctime)s [%(levelname)s] - %(message)s",
-                datefmt = "%Y-%m-%d %H:%M:%S",
-                encoding = "utf-8",
-                handlers = handlers
+                level=level,
+                format="%(asctime)s [%(levelname)s] - %(message)s",
+                datefmt="%Y-%m-%d %H:%M:%S",
+                encoding="utf-8",
+                handlers=handlers
             )
 
-            # Get the logger instance
+            # Store the logger instance as a private attribute
             self.__logger = logging.getLogger(__name__)
 
         except Exception as e:
-
             # Raise a runtime error if logger initialization fails
             raise LoggerRuntimeError(f"Failed to initialize logger: {e}")
 
     def info(self, message: str) -> None:
         """
-        Log an informational message.
+        Logs an informational message to the configured logger.
+
+        This method records informational messages that highlight the progress or state
+        of the application at a coarse-grained level. The message is stripped of leading
+        and trailing whitespace before being logged.
 
         Parameters
         ----------
@@ -197,12 +223,19 @@ class LoggerService(ILoggerService):
         Returns
         -------
         None
+            This method does not return any value.
         """
+
+        # Log the informational message after stripping whitespace
         self.__logger.info(message.strip())
 
     def error(self, message: str) -> None:
         """
-        Log an error message.
+        Logs an error-level message to the configured logger.
+
+        This method records error messages that indicate serious issues or failures
+        within the application. The message is stripped of leading and trailing
+        whitespace before being logged.
 
         Parameters
         ----------
@@ -212,12 +245,19 @@ class LoggerService(ILoggerService):
         Returns
         -------
         None
+            This method does not return any value.
         """
+
+        # Log the error message after stripping whitespace
         self.__logger.error(message.strip())
 
     def warning(self, message: str) -> None:
         """
-        Log a warning message.
+        Log a warning-level message to the configured logger.
+
+        This method records warning messages that indicate potential issues or
+        unexpected situations in the application. The message is stripped of
+        leading and trailing whitespace before being logged.
 
         Parameters
         ----------
@@ -227,20 +267,30 @@ class LoggerService(ILoggerService):
         Returns
         -------
         None
+            This method does not return any value.
         """
+
+        # Log the warning message after stripping whitespace
         self.__logger.warning(message.strip())
 
     def debug(self, message: str) -> None:
         """
-        Log a debug message.
+        Logs a debug-level message to the configured logger.
+
+        This method records diagnostic messages that are useful for debugging
+        and development purposes. The message is stripped of leading and trailing
+        whitespace before being logged.
 
         Parameters
         ----------
         message : str
-            The debug message to log.
+            The debug message to be logged.
 
         Returns
         -------
         None
+            This method does not return any value.
         """
+
+        # Log the debug message after stripping whitespace
         self.__logger.debug(message.strip())

orionis/services/paths/contracts/resolver.py

@@ -1,5 +1,4 @@
 from abc import ABC, abstractmethod
-from typing import Optional
 
 class IResolver(ABC):
     """

{orionis-0.408.0.dist-info → orionis-0.410.0.dist-info}/METADATA

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

{orionis-0.408.0.dist-info → orionis-0.410.0.dist-info}/RECORD

@@ -258,7 +258,7 @@ 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=lyVpWF0MG5Xr2V2hDnMRTAMzJ-rQJ2v7c8oWkA1Dmno,4960
+orionis/metadata/framework.py,sha256=8BMmCsNHCJxxuPr1sLdcSdigrF3I8BnleyXlPN74N-o,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
@@ -328,19 +328,19 @@ orionis/services/introspection/modules/contracts/reflection.py,sha256=YLqKg5Ehad
 orionis/services/introspection/objects/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/objects/types.py,sha256=vNKWc2b7K-X7B2X8RCimgAWQqbQlVT-aL24nUB8t_yQ,6343
 orionis/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/log/log_service.py,sha256=IrqAXR4uMlR1kjvh6quPUgf_wJdR9oPe_sQKSoQMQCE,8148
+orionis/services/log/log_service.py,sha256=DsbU8HVf035HxumFm4Xjo7kYhuXf0D57Xhuz7uzKhGo,11344
 orionis/services/log/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/log/contracts/log_service.py,sha256=ky7T2EIvJQMV0tKMSwFsUxDBoA24xYro8ChC6-7iUtY,546
+orionis/services/log/contracts/log_service.py,sha256=nTJaj32CbtAEliEdCa6fx-hekAHYEka-hEFiPkven6o,1691
 orionis/services/log/exceptions/__init__.py,sha256=PPn_LBV3U-0Yi69ZLDQmlkbmlL1iLTleLw-s88Ipg9o,84
 orionis/services/log/exceptions/runtime.py,sha256=LnaK0w0WlgxtZ9Zjn9RYIgp6fbQZmXZ_1fy9dkuA2jQ,468
 orionis/services/log/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/log/handlers/filename.py,sha256=nq9eqwFt60oVA5CSsIwO-At37mQgxTd08aYSOpvnIrs,1989
-orionis/services/log/handlers/size_rotating.py,sha256=oE2dQ7GWeKRq5X4j6030mg_ZKZ1urUFXY-ZOG6lSquI,690
-orionis/services/log/handlers/timed_rotating.py,sha256=9wPf-dSt3E-KG8BGusnMp3gXu2oy_RWGGkqDm9zO5FU,701
+orionis/services/log/handlers/filename.py,sha256=2BSW8_gQ-1GKccqC7FIGh_QnIxHgi2e-CarL2C0DGI8,2477
+orionis/services/log/handlers/size_rotating.py,sha256=SLg7r-XW1NWyVxN8wJxeI8jhypzdXw_jq2zg5uy3iaQ,1131
+orionis/services/log/handlers/timed_rotating.py,sha256=UJicPwHcIVl2FPRPjuiKwH3-zuiPG1YV7UYLLMPm4To,1128
 orionis/services/paths/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/paths/resolver.py,sha256=9PXTawN3QV142Fhe7C2EqXyAlf984Hc05A_M2cqXAps,3217
 orionis/services/paths/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/paths/contracts/resolver.py,sha256=DzaA0ThOJXHh0xkQigayPPAvpheknulz_xCdezfuCQA,1290
+orionis/services/paths/contracts/resolver.py,sha256=--kmKOX0m9Wt1ZkWUdFOJIJ58c4--KlD9NweH7UR0G4,1261
 orionis/services/paths/exceptions/__init__.py,sha256=r5b4D4XWNK07zLtqaXBk_PNYszScqbp_8kUN37cOk4E,184
 orionis/services/paths/exceptions/exception.py,sha256=cK-TbUT02X2lvbAP4yFdfHx4S45wBOcYl3_tiWd67UM,472
 orionis/services/paths/exceptions/file.py,sha256=bsK0QoXwRFyDeHvITxwmgaBuwiO2eoRUhRzNizmX1No,475
@@ -428,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.408.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.410.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=asv8TkkupVoex6SWod74NBl4dSs7wb9mLmu_glNdNy8,14815
@@ -539,6 +539,8 @@ tests/services/inspection/reflection/test_reflection_instance.py,sha256=xaCLsTbl
 tests/services/inspection/reflection/test_reflection_module.py,sha256=NbHJT0BokFjgC4Jw6Ax0YP5QVircXmwC6uAO33CeIeM,19765
 tests/services/inspection/reflection/mock/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/inspection/reflection/mock/fake_reflect_instance.py,sha256=iqWoT6tNym3OijK0wcF0iKMp3HTlq5kAoztzC4fdTlM,18595
+tests/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/services/log/test_log.py,sha256=fCI2gX9-YN1z-xPMwIlggUFHeBlqfUajQoyQu4dmao0,2868
 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
@@ -559,8 +561,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.408.0.dist-info/METADATA,sha256=n5ql9Cat7kQbHjFV3goNTgyUPgouORkrqTgZuMIwjjE,4772
-orionis-0.408.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.408.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.408.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.408.0.dist-info/RECORD,,
+orionis-0.410.0.dist-info/METADATA,sha256=ElthJSB4RNC4kRMhMxFPPUnEVLqadnxCC-EXXwfK4Yc,4772
+orionis-0.410.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.410.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.410.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.410.0.dist-info/RECORD,,

tests/services/log/test_log.py

@@ -0,0 +1,97 @@
+from orionis.services.log.log_service import LoggerService
+from orionis.support.facades.logger import Log
+from orionis.test.cases.asynchronous import AsyncTestCase
+
+class TestLoggerService(AsyncTestCase):
+
+    async def testHasInfoMethod(self):
+        """
+        Checks if the LoggerService class has an 'info' method.
+
+        Returns
+        -------
+        None
+            This test passes if the 'info' method exists, otherwise it fails.
+        """
+        self.assertTrue(hasattr(LoggerService, "info"))
+
+    async def testHasErrorMethod(self):
+        """
+        Checks if the LoggerService class has an 'error' method.
+
+        Returns
+        -------
+        None
+            This test passes if the 'error' method exists, otherwise it fails.
+        """
+        self.assertTrue(hasattr(LoggerService, "error"))
+
+    async def testHasWarningMethod(self):
+        """
+        Checks if the LoggerService class has a 'warning' method.
+
+        Returns
+        -------
+        None
+            This test passes if the 'warning' method exists, otherwise it fails.
+        """
+        self.assertTrue(hasattr(LoggerService, "warning"))
+
+    async def testHasDebugMethod(self):
+        """
+        Checks if the LoggerService class has a 'debug' method.
+
+        Returns
+        -------
+        None
+            This test passes if the 'debug' method exists, otherwise it fails.
+        """
+        self.assertTrue(hasattr(LoggerService, "debug"))
+
+    async def testLoggerWritesInfo(self):
+        """
+        Tests that the logger writes an info-level message.
+
+        Returns
+        -------
+        None
+            This test passes if the info message is processed without error.
+        """
+        # Log an info message
+        Log.info("Mensaje de prueba info")
+
+    async def testLoggerWritesError(self):
+        """
+        Tests that the logger writes an error-level message.
+
+        Returns
+        -------
+        None
+            This test passes if the error message is processed without error.
+        """
+        # Log an error message
+        Log.error("Mensaje de prueba error")
+
+    async def testLoggerWritesWarning(self):
+        """
+        Tests that the logger writes a warning-level message.
+
+        Returns
+        -------
+        None
+            This test passes if the warning message is processed without error.
+        """
+        # Log a warning message
+        Log.warning("Mensaje de prueba warning")
+
+    async def testLoggerWritesDebug(self):
+        """
+        Tests that the logger writes a debug-level message.
+
+        Returns
+        -------
+        None
+            This test passes if the debug message is processed without error.
+        """
+        # Log a debug message
+        Log.debug("Mensaje de prueba debug")