orionis 0.198.0__py3-none-any.whl → 0.200.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/config/app.py

@@ -34,7 +34,6 @@ class App:
     custom : dict
         A dictionary for storing additional custom properties. Defaults to an empty dictionary.
     """
-
     name: str
     debug: bool
     bytecode: bool
@@ -45,6 +44,4 @@ class App:
     reload: bool
     cipher: str
     key: str
-
-    # Holds additional custom properties, initialized as an empty dictionary
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/auth.py

@@ -12,6 +12,4 @@ class Auth:
         A dictionary to store any additional custom properties.
         This field is initialized with an empty dictionary by default.
     """
-
-    # Custom dictionary to hold dynamic or extra properties, initialized as an empty dict
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/database.py

@@ -201,6 +201,4 @@ class Database:
     """
     default: str
     connections: Connections
-
-    # Holds additional custom properties, initialized as an empty dictionary
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/filesystems.py

@@ -13,7 +13,6 @@ class Local:
     """
     path: str
 
-
 @dataclass
 class Public:
     """
@@ -29,7 +28,6 @@ class Public:
     path: str
     slug: str
 
-
 @dataclass
 class AWSS3:
     """
@@ -65,7 +63,6 @@ class AWSS3:
     use_path_style_endpoint: bool = False
     throw: bool = False
 
-
 @dataclass
 class Disks:
     """
@@ -84,7 +81,6 @@ class Disks:
     public: Public
     s3: AWSS3
 
-
 @dataclass
 class Filesystems:
     """
@@ -97,9 +93,6 @@ class Filesystems:
     disks : Disks
         A collection of configured storage disks.
     """
-
     default: str
     disks: Disks
-
-    # Holds additional custom properties, initialized as an empty dictionary
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/logging.py

@@ -19,7 +19,6 @@ class Stack:
     path: str
     level: str
 
-
 @dataclass
 class Hourly:
     """
@@ -38,7 +37,6 @@ class Hourly:
     level: str
     retention_hours: int
 
-
 @dataclass
 class Daily:
     """
@@ -60,7 +58,6 @@ class Daily:
     retention_days: int
     at: time
 
-
 @dataclass
 class Weekly:
     """
@@ -79,7 +76,6 @@ class Weekly:
     level: str
     retention_weeks: int
 
-
 @dataclass
 class Monthly:
     """
@@ -98,7 +94,6 @@ class Monthly:
     level: str
     retention_months: int
 
-
 @dataclass
 class Chunked:
     """
@@ -124,7 +119,6 @@ class Chunked:
     mb_size: Union[int, str]
     files: int
 
-
 @dataclass
 class Channels:
     """
@@ -146,7 +140,6 @@ class Channels:
     monthly : Monthly
     chunked : Chunked
 
-
 @dataclass
 class Logging:
     """
@@ -161,6 +154,4 @@ class Logging:
     """
     default: str
     channels: Channels
-
-    # Holds additional custom properties, initialized as an empty dictionary
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/mail.py

@@ -23,7 +23,6 @@ class Smtp:
     timeout : Optional[int], default=None
         The connection timeout duration in seconds. If None, defaults to the system setting.
     """
-
     url: str
     host: str
     port: int
@@ -32,7 +31,6 @@ class Smtp:
     password: str
     timeout: Optional[int] = None
 
-
 @dataclass
 class File:
     """
@@ -43,7 +41,6 @@ class File:
     path : str
         The file path where outgoing emails are stored instead of being sent.
     """
-
     path: str
 
 
@@ -59,11 +56,9 @@ class Mailers:
     file : File
         The file-based mail transport configuration (used for local development/testing).
     """
-
     smtp: Smtp
     file: File
 
-
 @dataclass
 class Mail:
     """
@@ -76,9 +71,6 @@ class Mail:
     mailers : Mailers
         The available mail transport configurations.
     """
-
     default: str
     mailers: Mailers
-
-    # Holds additional custom properties, initialized as an empty dictionary
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/queue.py

@@ -33,7 +33,6 @@ class Database:
     retry_after: int
     after_commit: bool
 
-
 @dataclass
 class Connections:
     """
@@ -44,7 +43,6 @@ class Connections:
     database : DatabaseQueue
         The configuration for the database-backed queue.
     """
-
     database: Database
 
 @dataclass
@@ -59,9 +57,6 @@ class Queue:
     connections : QueueConnections
         The available queue connection configurations.
     """
-
     default: str
     connections: Connections
-
-    # Holds additional custom properties, initialized as an empty dictionary
     custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/config/session.py

@@ -1,5 +1,6 @@
 from dataclasses import dataclass, field
 from typing import Dict, Optional
+from orionis.framework import NAME
 
 @dataclass
 class Cookie:
@@ -21,15 +22,13 @@ class Cookie:
     same_site : str
         The SameSite policy for the session cookie ('lax', 'strict', or 'none').
     """
-
-    name: str = "orionis_session"
+    name: str = f"{NAME}_session"
     path: str = "/"
     domain: Optional[str] = None
     secure: Optional[bool] = None
     http_only: bool = True
     same_site: str  = "lax"
 
-
 @dataclass
 class Session:
     """
@@ -50,13 +49,10 @@ class Session:
     cookie : SessionCookie
         The configuration settings for the session cookie.
     """
-
     driver: str
     lifetime: int
     expire_on_close: bool
     encrypt: bool
     files: str
     cookie: Cookie
-
-    # Holds additional custom properties, initialized as an empty dictionary
-    custom: Dict[str, any] = field(default_factory=dict)
+    custom: Dict[str, any] = field(default_factory=dict)

orionis/luminate/console/base/command.py

@@ -1,6 +1,7 @@
-from orionis.luminate.contracts.console.base.command import IBaseCommand
+import argparse
 from orionis.luminate.console.output.console import Console
 from orionis.luminate.console.output.progress_bar import ProgressBar
+from orionis.luminate.contracts.console.base.command import IBaseCommand
 
 class BaseCommand(IBaseCommand):
     """
@@ -16,73 +17,73 @@ class BaseCommand(IBaseCommand):
     """
     args = {}
 
-    def success(self, message: str, timestamp: bool = True):
+    def success(self, message: str, timestamp: bool = True) -> None:
         """
         Prints a success message with a green background.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         timestamp : bool, optional
             Whether to include a timestamp (default is True).
         """
         Console.success(message, timestamp)
 
-    def textSuccess(self, message: str):
+    def textSuccess(self, message: str) -> None:
         """
         Prints a success message in green.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textSuccess(message)
 
-    def textSuccessBold(self, message: str):
+    def textSuccessBold(self, message: str) -> None:
         """
         Prints a bold success message in green.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textSuccessBold(message)
 
-    def info(self, message: str, timestamp: bool = True):
+    def info(self, message: str, timestamp: bool = True) -> None:
         """
         Prints an informational message with a blue background.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         timestamp : bool, optional
             Whether to include a timestamp (default is True).
         """
         Console.info(message, timestamp)
 
-    def textInfo(self, message: str):
+    def textInfo(self, message: str) -> None:
         """
         Prints an informational message in blue.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textInfo(message)
 
-    def textInfoBold(self, message: str):
+    def textInfoBold(self, message: str) -> None:
         """
         Prints a bold informational message in blue.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textInfoBold(message)
 
@@ -92,140 +93,135 @@ class BaseCommand(IBaseCommand):
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         timestamp : bool, optional
             Whether to include a timestamp (default is True).
         """
         Console.warning(message, timestamp)
 
-    def textWarning(self, message: str):
+    def textWarning(self, message: str) -> None:
         """
         Prints a warning message in yellow.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textWarning(message)
 
-    def textWarningBold(self, message: str):
+    def textWarningBold(self, message: str) -> None:
         """
         Prints a bold warning message in yellow.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textWarningBold(message)
 
-    def fail(self, message: str, timestamp: bool = True):
+    def fail(self, message: str, timestamp: bool = True) -> None:
         """
         Prints a failure message with a red background.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         timestamp : bool, optional
             Whether to include a timestamp (default is True).
         """
         Console.fail(message, timestamp)
 
-    def error(self, message: str, timestamp: bool = True):
+    def error(self, message: str, timestamp: bool = True) -> None:
         """
         Prints an error message with a red background.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         timestamp : bool, optional
             Whether to include a timestamp (default is True).
         """
         Console.error(message, timestamp)
 
-    def textError(self, message: str):
+    def textError(self, message: str) -> None:
         """
         Prints an error message in red.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textError(message)
 
-    def textErrorBold(self, message: str):
+    def textErrorBold(self, message: str) -> None:
         """
         Prints a bold error message in red.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textErrorBold(message)
 
-    def textMuted(self, message: str):
+    def textMuted(self, message: str) -> None:
         """
         Prints a muted (gray) message.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textMuted(message)
 
-    def textMutedBold(self, message: str):
+    def textMutedBold(self, message: str) -> None:
         """
         Prints a bold muted (gray) message.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textMutedBold(message)
 
-    def textUnderline(self, message: str):
+    def textUnderline(self, message: str) -> None:
         """
         Prints an underlined message.
 
         Parameters
         ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        message : str
+            The message to display.
         """
         Console.textUnderline(message)
 
-    def clear(self):
+    def clear(self) -> None:
         """
         Clears the console screen.
         """
         Console.clear()
 
-    def clearLine(self):
+    def clearLine(self) -> None:
         """
         Clears the current console line.
         """
         Console.clearLine()
 
-    def line(self, message: str):
+    def line(self) -> None:
         """
-        Prints a line of text.
-
-        Parameters
-        ----------
-        message : str, optional
-            The message to display (default is an empty string).
+        Prints a line empty.
         """
-        Console.line(message)
+        Console.line()
 
-    def newLine(self, count: int = 1):
+    def newLine(self, count: int = 1) -> None:
         """
         Prints multiple new lines.
 
@@ -236,18 +232,18 @@ class BaseCommand(IBaseCommand):
         """
         Console.newLine(count)
 
-    def write(self, message: str):
+    def write(self, message: str) -> None:
         """
         Prints a message without moving to the next line.
 
         Parameters
         ----------
         message : str, optional
-            The message to display (default is an empty string).
+            The message to display.
         """
         Console.write(message)
 
-    def writeLine(self, message: str):
+    def writeLine(self, message: str) -> None:
         """
         Prints a message and moves to the next line.
 
@@ -272,7 +268,7 @@ class BaseCommand(IBaseCommand):
         str
             The user's input.
         """
-        return Console.ask(question)
+        return Console.ask(question).strip()
 
     def confirm(self, question: str, default: bool = False) -> bool:
         """
@@ -290,7 +286,7 @@ class BaseCommand(IBaseCommand):
         bool
             The user's response.
         """
-        return Console.ask(question, default)
+        return Console.confirm(question, default)
 
     def secret(self, question: str) -> str:
         """
@@ -397,21 +393,6 @@ class BaseCommand(IBaseCommand):
         """
         return ProgressBar(total=total, width=width)
 
-    def setArgs(self, args):
-        """
-        Define the logic of setting command arguments.
-
-        Parameters
-        ----------
-        args : argparse.Namespace
-            Contain the arguments to be set for the command.
-        """
-        try:
-            self.args = vars(args)
-        except TypeError:
-            self.args = {}
-
-
     def handle(self, **kwargs):
         """
         Abstract method to define the logic of the command.
@@ -425,4 +406,31 @@ class BaseCommand(IBaseCommand):
             NotImplementedError: If the method is not implemented in a subclass. This ensures that all command classes
                                 adhere to the expected structure.
         """
-        raise NotImplementedError("The 'handle' method must be implemented in the child class.")
+        raise NotImplementedError("The 'handle' method must be implemented in the child class.")
+
+    def setArgs(self, args) -> None:
+        """
+        Define the logic of setting command arguments.
+
+        Parameters
+        ----------
+        args : argparse.Namespace or dict
+            Contain the arguments to be set for the command.
+        """
+        if isinstance(args, argparse.Namespace):
+            self.args = vars(args)
+        elif isinstance(args, dict):
+            self.args = args
+        else:
+            raise ValueError("Invalid argument type. Expected 'argparse.Namespace' or 'dict'.")
+
+    def getArgs(self) -> dict:
+        """
+        Get the command arguments.
+
+        Returns
+        -------
+        dict
+            The command arguments.
+        """
+        return self.args

orionis/luminate/console/command_filter.py

@@ -33,5 +33,4 @@ class CommandFilter(ICommandFilter):
             'schedule:work',   # Command to handle scheduled work
             'help',            # Command to show help information
             'version',         # Command to display version information
-            'tests:run'        # Command to run tests
         ]

orionis/luminate/console/commands/cache_clear.py

@@ -1,7 +1,7 @@
 import os
 import shutil
 from orionis.luminate.console.base.command import BaseCommand
-from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
+from orionis.luminate.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
 
 class CacheClearCommand(BaseCommand):
     """
@@ -9,21 +9,29 @@ class CacheClearCommand(BaseCommand):
 
     This command recursively searches for and removes all `__pycache__` directories
     in the project folder to ensure that no stale bytecode files persist.
-
-    Attributes
-    ----------
-    signature : str
-        The unique identifier for the command, used to trigger its execution.
-    description : str
-        A brief summary describing the purpose of the command.
     """
 
-    # The command signature used to execute this command.
     signature = 'cache:clear'
 
-    # A brief description of the command.
     description = 'Clears the project cache by removing all __pycache__ directories.'
 
+    def __init__(self) -> None:
+        """
+        Initializes the command instance, setting the list of directories to exclude from the cache clearing process.
+        """
+        self.exclude_dirs = [
+            'venv',
+            'env',
+            'virtualenv',
+            'venv3',
+            'env3',
+            'venv2',
+            'env2',
+            'vendor',
+            'node_modules',
+            'environment'
+        ]
+
     def handle(self) -> None:
         """
         Executes the cache clearing process.
@@ -45,7 +53,7 @@ class CacheClearCommand(BaseCommand):
             for root, dirs, files in os.walk(base_path, topdown=True):
 
                 # Skip common environment directories (e.g., venv, env, vendor, node_modules)
-                for env_dir in ['venv', 'env', 'virtualenv', 'venv3', 'env3', 'venv2', 'env2', 'vendor', 'node_modules', 'environment']:
+                for env_dir in self.exclude_dirs:
                     if env_dir in dirs:
                         dirs.remove(env_dir)