orionis 0.77.0__py3-none-any.whl → 0.78.0__py3-none-any.whl

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/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/luminate/services/log/log_service.py

@@ -1,8 +1,11 @@
-import os
 import logging
+import os
+import re
+from datetime import datetime
+from logging.handlers import RotatingFileHandler, TimedRotatingFileHandler
 from pathlib import Path
-from typing import Optional
 from orionis.contracts.services.log.i_log_service import ILogguerService
+from orionis.luminate.services.config.config_service import ConfigService
 
 class LogguerService(ILogguerService):
     """
@@ -18,10 +21,10 @@ class LogguerService(ILogguerService):
 
     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.
+    __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
@@ -34,24 +37,32 @@ class LogguerService(ILogguerService):
         Logs a debug message.
     """
 
-    def __init__(self, path: Optional[str] = None, level: int = logging.INFO, filename: Optional[str] = 'orionis.log'):
+    def __init__(self, config_service : ConfigService):
         """
         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'.
+        config_service : ConfigService
+            The configuration service instance.
+        """
+        self.config_service = config_service
+        self._initialize_logger()
+
+    def _path_resolver(self, filename: str):
         """
-        self._initialize_logger(path, level, filename)
+        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, path: Optional[str], level: int, filename: Optional[str] = 'orionis.log'):
+    def _initialize_logger(self):
         """
         Configures the logger with the specified settings.
 
@@ -61,12 +72,8 @@ class LogguerService(ILogguerService):
 
         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.
+        config_service : ConfigService
+            The configuration service instance.
 
         Raises
         ------
@@ -74,27 +81,112 @@ class LogguerService(ILogguerService):
             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)
+            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"
+                    )
+                ]
 
-                path = log_dir / filename
 
             # Configure the logger
             logging.basicConfig(
-                level=level,
+                level=config.get("level", "INFO").upper(),
                 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
-                ]
+                handlers=handlers
             )
 
             # Get the logger instance

{orionis-0.77.0.dist-info → orionis-0.78.0.dist-info}/METADATA

@@ -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.dist-info → orionis-0.78.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=0bM-hABXJSoPGuvEgnqeaj9qcLP8VjTQ3z9Mb0TSEUI,1381
-orionis/framework.py,sha256=IFueK59k0Oi4I_rwHSuiTjwOQfrBLbjm5_0VhY8Y-Q4,1386
+orionis/framework.py,sha256=M6GR_dTDAIhgQsjWISzWq42J6CbanHXfek4R1OVnad0,1386
 orionis/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/bootstrap/i_command_bootstrapper.py,sha256=cfpYWSlNhOY1q_C9o0H7F381OoM0Oh0qaeqP-c85nzk,2457
 orionis/contracts/bootstrap/i_config_bootstrapper.py,sha256=d2TXT74H2fCBbzWgrt9-ZG11S_H_YPQOEcJoIOrsgb0,4462
@@ -71,7 +71,7 @@ orionis/luminate/config/cache.py,sha256=nBKmDFDb91sbBriEsVLjMhrNb__j7YsRzZGQRDdA
 orionis/luminate/config/cors.py,sha256=zWKUylPiaUzGXTJM3eLmwY0HcAD7iOLp9QiAoTyAL08,2275
 orionis/luminate/config/database.py,sha256=oj-FQWtbwIYrJAQktSGBl96EZu78fr6IBcQxHbWDVBM,5619
 orionis/luminate/config/filesystems.py,sha256=fAn4Wx6naIb8E4U2TXJhVnx0Ipxpxc_Ee2w_FWfwlHI,2444
-orionis/luminate/config/logging.py,sha256=H110K6LyTCNgxZPqiGGn0z8FZ2I6kW5ZKfsVhoWB4KM,2832
+orionis/luminate/config/logging.py,sha256=mx3ifEVjKNZgaRlql1D7u-KxRiewKRAbz5VDcwAubaw,4047
 orionis/luminate/config/mail.py,sha256=3iYXG72bXiVns4sEPZ_A3-cGcFjGEGDXkuLKkk-hKtY,2102
 orionis/luminate/config/queue.py,sha256=DYjP5zD09ISsIX117wtOfjiG_iQrcrPoQVeeftmuO3c,1739
 orionis/luminate/config/session.py,sha256=7mOC_DfGIBDqAClSiewHoTA9Kht_zdHApvALcZc7cfY,1861
@@ -132,7 +132,7 @@ orionis/luminate/services/environment/environment_service.py,sha256=IgrfzLELNhnE
 orionis/luminate/services/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/files/path_resolver_service.py,sha256=E-G_E2H5QAZyxeMssARp7l1OBSxQurxkUPoKdSOCKEE,2041
 orionis/luminate/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/services/log/log_service.py,sha256=aiENimOQHqaEAsBJz2_698bt1IeJjddHnledLKfg25o,5262
+orionis/luminate/services/log/log_service.py,sha256=tlKnBLtJPx-LK6nQt39xYA48jcNkaJt2_Xj-wgcpfXA,8842
 orionis/luminate/support/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
 orionis/luminate/support/exception_to_dict.py,sha256=jpQ-c7ud1JLm8dTWbvMT1dI-rL3yTB2P8VxNscAX71k,2098
 orionis/luminate/support/reflection.py,sha256=VYpluTQJ0W_m6jYQ9_L02sYFrk2wlLYtLY2yp9rZMKA,11944
@@ -153,9 +153,9 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/class_example.py,sha256=dIPD997Y15n6WmKhWoOFSwEldRm9MdOHTZZ49eF1p3c,1056
 tests/tools/test_reflection.py,sha256=bhLQ7VGVod4B8sv-rW9AjnOumvaBVsoxieA3sdoM2yM,5244
-orionis-0.77.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.77.0.dist-info/METADATA,sha256=Olf98-_eRhclDi6IPTI95YgOvLWUlFleh4UZztctlcM,2978
-orionis-0.77.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.77.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.77.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.77.0.dist-info/RECORD,,
+orionis-0.78.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.78.0.dist-info/METADATA,sha256=WDNwmK36LqcGJUK9AeNPmk-tzZ1zf0pSz47qs283Qh4,2978
+orionis-0.78.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.78.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.78.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.78.0.dist-info/RECORD,,