orionis 0.77.0__tar.gz → 0.78.0__tar.gz

{orionis-0.77.0/orionis.egg-info → orionis-0.78.0}/PKG-INFO

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

{orionis-0.77.0 → orionis-0.78.0}/orionis/framework.py

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

{orionis-0.77.0 → orionis-0.78.0}/orionis/luminate/config/logging.py

@@ -1,8 +1,9 @@
 from dataclasses import dataclass, field
-from typing import Any, Dict, Union
+from datetime import time
+from typing import Dict, Union
 
 @dataclass
-class Single:
+class Stack:
     """
     Represents a single log file configuration.
 
@@ -17,7 +18,25 @@ class Single:
     """
     path: str
     level: str
-    stream: bool
+
+
+@dataclass
+class Hourly:
+    """
+    Represents an hourly log file rotation configuration.
+
+    Attributes
+    ----------
+    path : str
+        The file path where hourly logs are stored.
+    level : str
+        The logging level (e.g., 'info', 'error', 'debug').
+    retention_hours : int
+        The number of hours to retain log files before deletion.
+    """
+    path: str
+    level: str
+    retention_hours: int
 
 
 @dataclass
@@ -31,15 +50,53 @@ class Daily:
         The file path where daily logs are stored.
     level : str
         The logging level (e.g., 'info', 'error', 'debug').
-    days : int
+    retention_days : int
         The number of days to retain log files before deletion.
-    stream : bool
-        Whether to output logs to the console.
+    at_time : time
+        The time of day when the log rotation should occur.
+    """
+    path: str
+    level: str
+    retention_days: int
+    at: time
+
+
+@dataclass
+class Weekly:
+    """
+    Represents a weekly log file rotation configuration.
+
+    Attributes
+    ----------
+    path : str
+        The file path where weekly logs are stored.
+    level : str
+        The logging level (e.g., 'info', 'error', 'debug').
+    retention_weeks : int
+        The number of weeks to retain log files before deletion.
+    """
+    path: str
+    level: str
+    retention_weeks: int
+
+
+@dataclass
+class Monthly:
+    """
+    Represents a monthly log file rotation configuration.
+
+    Attributes
+    ----------
+    path : str
+        The file path where monthly logs are stored.
+    level : str
+        The logging level (e.g., 'info', 'error', 'debug').
+    retention_months : int
+        The number of months to retain log files before deletion.
     """
     path: str
     level: str
-    days: int
-    stream: bool
+    retention_months: int
 
 
 @dataclass
@@ -56,20 +113,16 @@ class Chunked:
         The file path where chunked logs are stored.
     level : str
         The logging level (e.g., 'info', 'error', 'debug').
-    max_size : Union[int, str]
+    max_mb_size : Union[int, str]
         The maximum file size before creating a new chunk.
         Can be an integer (bytes) or a string (e.g., '10MB', '500KB').
     max_files : int
         The maximum number of log files to retain before older files are deleted.
-    stream : bool
-        Whether to output logs to the console.
     """
-
     path: str
     level: str
-    max_size: Union[int, str]  # Supports both numeric and formatted string sizes ('10MB')
-    max_files: int  # Ensures only a certain number of log files are kept
-    stream: bool
+    mb_size: Union[int, str]
+    files: int
 
 
 @dataclass
@@ -86,9 +139,12 @@ class Channels:
     chunked : Chunked
         Configuration for chunked log file storage.
     """
-    single: Single
-    daily: Daily
-    chunked: Chunked
+    stack = Stack
+    hourly = Hourly
+    daily = Daily
+    weekly = Weekly
+    monthly = Monthly
+    chunked = Chunked
 
 
 @dataclass

orionis-0.78.0/orionis/luminate/services/log/log_service.py

@@ -0,0 +1,251 @@
+import logging
+import os
+import re
+from datetime import datetime
+from logging.handlers import RotatingFileHandler, TimedRotatingFileHandler
+from pathlib import Path
+from orionis.contracts.services.log.i_log_service import ILogguerService
+from orionis.luminate.services.config.config_service import ConfigService
+
+class LogguerService(ILogguerService):
+    """
+    A service class for logging messages with different severity levels.
+
+    This class initializes a logger that can write logs to a file. It supports
+    various log levels such as INFO, ERROR, SUCCESS, WARNING, and DEBUG.
+
+    Attributes
+    ----------
+    logger : logging.Logger
+        The logger instance used to log messages.
+
+    Methods
+    -------
+    __init__(config_service: ConfigService)
+        Initializes the logger with ConfigService
+    _initialize_logger(config_service: ConfigService)
+        Configures the logger with ConfigService settings.
+    info(message: str) -> None
+        Logs an informational message.
+    error(message: str) -> None
+        Logs an error message.
+    success(message: str) -> None
+        Logs a success message (treated as info).
+    warning(message: str) -> None
+        Logs a warning message.
+    debug(message: str) -> None
+        Logs a debug message.
+    """
+
+    def __init__(self, config_service : ConfigService):
+        """
+        Initializes the logger with the specified path, log level, and filename.
+
+        Parameters
+        ----------
+        config_service : ConfigService
+            The configuration service instance.
+        """
+        self.config_service = config_service
+        self._initialize_logger()
+
+    def _path_resolver(self, filename: str):
+        """
+        Resolves the log file path based on the specified filename.
+        """
+        base_path = Path(os.getcwd())
+        log_dir = base_path / "storage" / "logs"
+
+        # Create the log directory if it does not exist
+        if not log_dir.exists():
+            log_dir.mkdir(parents=True, exist_ok=True)
+
+        return log_dir / filename
+
+    def _initialize_logger(self):
+        """
+        Configures the logger with the specified settings.
+
+        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.
+
+        Parameters
+        ----------
+        config_service : ConfigService
+            The configuration service instance.
+
+        Raises
+        ------
+        RuntimeError
+            If the logger cannot be initialized due to an error.
+        """
+        try:
+
+            channel : str = self.config_service.get("logging.default")
+            config : dict = self.config_service.get(f"logging.channels.{channel}", {})
+            path : str = config.get("path", 'logs/orionis.log')
+            app_timezone : str = self.config_service.get("app.timezone", "UTC")
+
+            if channel == "stack":
+
+                handlers = [
+                    logging.FileHandler(
+                        filename=self._path_resolver(path),
+                        encoding="utf-8"
+                    )
+                ]
+
+            elif channel == "hourly":
+
+                handlers = [
+                    TimedRotatingFileHandler(
+                        filename=self._path_resolver(path),
+                        when="h",
+                        interval=1,
+                        backupCount=config.get('retention_hours', 24),
+                        encoding="utf-8",
+                        utc= True if app_timezone == "UTC" else False
+                    )
+                ]
+
+            elif channel == "daily":
+
+                backup_count : str = config.get('retention_days', 30)
+                hour_at : str = config.get('at', "00:00")
+                if backup_count < 1 or not backup_count.isdigit():
+                    raise ValueError("The 'retention_days' value must be an integer greater than 0.")
+                if not bool(re.match(r"^(?:[01]?\d|2[0-3]):[0-5]?\d$", hour_at)):
+                    raise ValueError("The 'at' value must be a valid time in the format HH:MM.")
+
+                handlers = [
+                    TimedRotatingFileHandler(
+                        filename=self._path_resolver(path),
+                        when="d",
+                        interval=1,
+                        backupCount=backup_count,
+                        encoding="utf-8",
+                        atTime=datetime.strptime(hour_at, "%H:%M").time(),
+                        utc= True if app_timezone == "UTC" else False
+                    )
+                ]
+
+            elif channel == "weekly":
+
+                backup_count : str = config.get('retention_weeks', 4)
+                if backup_count < 1 or not backup_count.isdigit():
+                    raise ValueError("The 'retention_weeks' value must be an integer greater than 0.")
+                handlers = [
+                    TimedRotatingFileHandler(
+                        filename=self._path_resolver(path),
+                        when="w0",
+                        interval=1,
+                        backupCount=backup_count,
+                        encoding="utf-8",
+                        utc= True if app_timezone == "UTC" else False
+                    )
+                ]
+
+            elif channel == "monthly":
+
+                backup_count : str = config.get('retention_months', 2)
+                if backup_count < 1 or not backup_count.isdigit():
+                    raise ValueError("The 'retention_months' value must be an integer greater than 0.")
+                handlers = [
+                    TimedRotatingFileHandler(
+                        filename=self._path_resolver(path),
+                        when="midnight",
+                        interval=30,
+                        backupCount=backup_count,
+                        encoding="utf-8",
+                        utc= True if app_timezone == "UTC" else False
+                    )
+                ]
+
+            elif channel == "chunked":
+
+                max_bytes : str = config.get('mb_size', 5).replace("MB", "")
+                if max_bytes < 1 or not max_bytes.isdigit():
+                    raise ValueError("The 'mb_size' value must be an integer greater than 0.")
+                backup_count : str = config.get('max_files', 5)
+                if backup_count < 1 or not backup_count.isdigit():
+                    raise ValueError("The 'max_files' value must be an integer greater than 0.")
+                handlers = [
+                    RotatingFileHandler(
+                        filename=self._path_resolver(path),
+                        maxBytes= max_bytes * 1024 * 1024,
+                        backupCount=backup_count,
+                        encoding="utf-8"
+                    )
+                ]
+
+
+            # Configure the logger
+            logging.basicConfig(
+                level=config.get("level", "INFO").upper(),
+                format="%(asctime)s - %(message)s",
+                datefmt="%Y-%m-%d %H:%M:%S",
+                encoding="utf-8",
+                handlers=handlers
+            )
+
+            # Get the logger instance
+            self.logger = logging.getLogger(__name__)
+
+        except Exception as e:
+            raise RuntimeError(f"Failed to initialize logger: {e}")
+
+    def info(self, message: str) -> None:
+        """
+        Logs an informational message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        self.logger.info(f"[INFO] - {message}")
+
+    def error(self, message: str) -> None:
+        """
+        Logs an error message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        self.logger.error(f"[ERROR] - {message}")
+
+    def success(self, message: str) -> None:
+        """
+        Logs a success message (treated as info).
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        self.logger.info(f"[SUCCESS] - {message}")
+
+    def warning(self, message: str) -> None:
+        """
+        Logs a warning message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        self.logger.warning(f"[WARNING] - {message}")
+
+    def debug(self, message: str) -> None:
+        """
+        Logs a debug message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        self.logger.debug(f"[DEBUG] - {message}")

{orionis-0.77.0 → orionis-0.78.0/orionis.egg-info}/PKG-INFO

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

orionis-0.77.0/orionis/luminate/services/log/log_service.py

@@ -1,159 +0,0 @@
-import os
-import logging
-from pathlib import Path
-from typing import Optional
-from orionis.contracts.services.log.i_log_service import ILogguerService
-
-class LogguerService(ILogguerService):
-    """
-    A service class for logging messages with different severity levels.
-
-    This class initializes a logger that can write logs to a file. It supports
-    various log levels such as INFO, ERROR, SUCCESS, WARNING, and DEBUG.
-
-    Attributes
-    ----------
-    logger : logging.Logger
-        The logger instance used to log messages.
-
-    Methods
-    -------
-    __init__(path: Optional[str] = None, level: int = logging.INFO, filename: Optional[str] = 'orionis.log')
-        Initializes the logger with the specified path, log level, and filename.
-    _initialize_logger(path: Optional[str], level: int, filename: Optional[str] = 'orionis.log')
-        Configures the logger with the specified settings.
-    info(message: str) -> None
-        Logs an informational message.
-    error(message: str) -> None
-        Logs an error message.
-    success(message: str) -> None
-        Logs a success message (treated as info).
-    warning(message: str) -> None
-        Logs a warning message.
-    debug(message: str) -> None
-        Logs a debug message.
-    """
-
-    def __init__(self, path: Optional[str] = None, level: int = logging.INFO, filename: Optional[str] = 'orionis.log'):
-        """
-        Initializes the logger with the specified path, log level, and filename.
-
-        Parameters
-        ----------
-        path : Optional[str]
-            The directory path where the log file will be stored. If not provided,
-            it defaults to a 'logs' directory inside the 'storage' folder of the
-            current working directory.
-        level : int
-            The logging level (e.g., logging.INFO, logging.ERROR). Defaults to logging.INFO.
-        filename : Optional[str]
-            The name of the log file. Defaults to 'orionis.log'.
-        """
-        self._initialize_logger(path, level, filename)
-
-    def _initialize_logger(self, path: Optional[str], level: int, filename: Optional[str] = 'orionis.log'):
-        """
-        Configures the logger with the specified settings.
-
-        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.
-
-        Parameters
-        ----------
-        path : Optional[str]
-            The directory path where the log file will be stored.
-        level : int
-            The logging level (e.g., logging.INFO, logging.ERROR).
-        filename : Optional[str]
-            The name of the log file.
-
-        Raises
-        ------
-        RuntimeError
-            If the logger cannot be initialized due to an error.
-        """
-        try:
-            # Resolve the log directory and file path
-            if path is None:
-                base_path = Path(os.getcwd())
-                log_dir = base_path / "storage" / "logs"
-
-                # Create the log directory if it does not exist
-                if not log_dir.exists():
-                    log_dir.mkdir(parents=True, exist_ok=True)
-
-                path = log_dir / filename
-
-            # Configure the logger
-            logging.basicConfig(
-                level=level,
-                format="%(asctime)s - %(message)s",
-                datefmt="%Y-%m-%d %H:%M:%S",
-                encoding="utf-8",
-                handlers=[
-                    logging.FileHandler(path, encoding="utf-8")
-                    # logging.StreamHandler()  # Uncomment to also log to the console
-                ]
-            )
-
-            # Get the logger instance
-            self.logger = logging.getLogger(__name__)
-
-        except Exception as e:
-            raise RuntimeError(f"Failed to initialize logger: {e}")
-
-    def info(self, message: str) -> None:
-        """
-        Logs an informational message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        self.logger.info(f"[INFO] - {message}")
-
-    def error(self, message: str) -> None:
-        """
-        Logs an error message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        self.logger.error(f"[ERROR] - {message}")
-
-    def success(self, message: str) -> None:
-        """
-        Logs a success message (treated as info).
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        self.logger.info(f"[SUCCESS] - {message}")
-
-    def warning(self, message: str) -> None:
-        """
-        Logs a warning message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        self.logger.warning(f"[WARNING] - {message}")
-
-    def debug(self, message: str) -> None:
-        """
-        Logs a debug message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        self.logger.debug(f"[DEBUG] - {message}")