orionis 0.638.0__tar.gz → 0.640.0__tar.gz

{orionis-0.638.0/orionis.egg-info → orionis-0.640.0}/PKG-INFO

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

{orionis-0.638.0 → orionis-0.640.0}/orionis/console/commands/cache.py

@@ -26,7 +26,7 @@ class CacheClearCommand(BaseCommand):
     """
 
     # Indicates whether timestamps will be shown in the command output
-    timestamps: bool = True
+    timestamps: bool = False
 
     # Command signature and description
     signature: str = "cache:clear"
@@ -64,7 +64,7 @@ class CacheClearCommand(BaseCommand):
                 raise CLIOrionisRuntimeError(f"Cache clearing failed: {error_message}")
 
             # If the command was successful, print the output
-            self.textSuccess("Cache cleared successfully.")
+            self.info("Cache cleared successfully.")
 
             # If the command was successful, return True
             return True  # Cache cleared successfully

orionis-0.640.0/orionis/console/commands/log.py

@@ -0,0 +1,113 @@
+import subprocess
+from orionis.console.base.command import BaseCommand
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from orionis.foundation.contracts.application import IApplication
+import shutil
+import logging
+
+class LogClearCommand(BaseCommand):
+    """
+    Command to clear all existing log files and directories in the application's log storage.
+
+    This command disables all active loggers, locates the application's log directory,
+    and attempts to remove all files, symlinks, and subdirectories within it. If a log
+    file is locked, it will be truncated instead of deleted. Any unexpected errors during
+    the process will raise a CLIOrionisRuntimeError.
+
+    Parameters
+    ----------
+    app : IApplication
+        The application instance providing access to the log storage path.
+
+    Returns
+    -------
+    bool
+        Returns True if all log files and directories are cleared successfully,
+        or if the log directory does not exist. Raises CLIOrionisRuntimeError
+        if an unexpected error occurs during the process.
+
+    Raises
+    ------
+    CLIOrionisRuntimeError
+        If an unexpected error occurs while clearing the log files or directories.
+    """
+
+    # Indicates whether timestamps will be shown in the command output
+    timestamps: bool = False
+
+    # Command signature and description
+    signature: str = "log:clear"
+
+    # Command description
+    description: str = "Eliminar todos los logs existentes de la aplicacion."
+
+    def handle(self, app: IApplication) -> bool:
+        """
+        Clears all existing log files and directories in the application's log storage.
+
+        Parameters
+        ----------
+        app : IApplication
+            The application instance providing access to the log storage path.
+
+        Returns
+        -------
+        bool
+            True if the operation completes without raising an exception,
+            or if the log directory does not exist.
+
+        Raises
+        ------
+        CLIOrionisRuntimeError
+            If an unexpected error occurs during the log clearing process.
+        """
+        try:
+            # Shutdown all active loggers to release file handles
+            logging.shutdown()
+
+            # Get the path to the application's log directory
+            log_path = app.path('storage') / 'logs'
+
+            # Check if the log directory exists and is a directory
+            if log_path.exists() and log_path.is_dir():
+                for entry in log_path.iterdir():
+                    try:
+                        if entry.is_file() or entry.is_symlink():
+
+                            # Attempt to truncate the file if it's in use, then delete it
+                            try:
+
+                                # Truncate file contents
+                                with open(entry, 'w'):
+                                    pass
+
+                                # Attempt to delete the file
+                                entry.unlink()
+
+                            except PermissionError:
+
+                                # If the file is locked, just truncate and skip deletion
+                                pass
+
+                        elif entry.is_dir():
+
+                            # Recursively remove subdirectories and their contents
+                            shutil.rmtree(entry)
+
+                    except Exception as e:
+
+                        # Ignore errors for individual entries to continue processing others
+                        pass
+
+            # Print success message
+            self.info("All log files have been successfully deleted.")
+
+            # Return True if the operation completes successfully
+            return True
+
+        except Exception as exc:
+
+            # Raise a CLIOrionisRuntimeError for any unexpected exception
+            raise CLIOrionisRuntimeError(
+                f"An unexpected error occurred while clearing the cache: {exc}"
+            )

{orionis-0.638.0 → orionis-0.640.0}/orionis/console/commands/make_command.py

@@ -87,9 +87,6 @@ class MakeCommand(BaseCommand):
 
         try:
 
-            # Print a new line to separate output
-            self.newLine()
-
             # Retrieve the 'name' argument (required) and 'signature' argument (optional, with default)
             name: str = self.argument("name")
             signature: str = self.argument("signature", "custom:command")
@@ -133,9 +130,6 @@ class MakeCommand(BaseCommand):
                 file_path = file_path.relative_to(app.path('root'))
                 self.info(f"Console command [{file_path}] created successfully.")
 
-            # Print a new line to separate output
-            self.newLine()
-
         except Exception as e:
 
             # Catch any unexpected exceptions and raise a CLI-specific runtime error

{orionis-0.638.0 → orionis-0.640.0}/orionis/console/commands/workflow.py

@@ -74,6 +74,9 @@ class WorkFlowGithubCommand(BaseCommand):
                     "Test suite failed. Please fix the issues before proceeding with the workflow."
                 )
 
+            # If all tests passed, print a success message
+            self.info("All tests passed successfully. Proceeding with the workflow.")
+
         except Exception as e:
 
             # Raise a custom runtime error if any exception occurs

{orionis-0.638.0 → orionis-0.640.0}/orionis/console/core/reactor.py

@@ -289,6 +289,7 @@ class Reactor(IReactor):
         from orionis.console.commands.scheduler_work import ScheduleWorkCommand
         from orionis.console.commands.scheduler_list import ScheduleListCommand
         from orionis.console.commands.make_command import MakeCommand
+        from orionis.console.commands.log import LogClearCommand
 
         # List of core command classes to load (extend this list as more core commands are added)
         core_commands = [
@@ -300,7 +301,8 @@ class Reactor(IReactor):
             CacheClearCommand,
             ScheduleWorkCommand,
             ScheduleListCommand,
-            MakeCommand
+            MakeCommand,
+            LogClearCommand
         ]
 
         # Iterate through the core command classes and register them

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/application.py

@@ -774,6 +774,10 @@ class Application(Container, IApplication):
         - The method always returns the current `Application` instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(app, type) and issubclass(app, App)):
             _app = DataClass(App).fromDataclass(app).toDict()
@@ -870,6 +874,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(auth, type) and issubclass(auth, Auth)):
             _auth = DataClass(Auth).fromDataclass(auth).toDict()
@@ -966,6 +974,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(cache, type) and issubclass(cache, Cache)):
             _cache = DataClass(Cache).fromDataclass(cache).toDict()
@@ -1062,6 +1074,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(cors, type) and issubclass(cors, Cors)):
             _cors = DataClass(Cors).fromDataclass(cors).toDict()
@@ -1158,6 +1174,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(database, type) and issubclass(database, Database)):
             _database = DataClass(Database).fromDataclass(database).toDict()
@@ -1254,6 +1274,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(filesystems, type) and issubclass(filesystems, Filesystems)):
             _filesystems = DataClass(Filesystems).fromDataclass(filesystems).toDict()
@@ -1350,6 +1374,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(logging, type) and issubclass(logging, Logging)):
             _logging = DataClass(Logging).fromDataclass(logging).toDict()
@@ -1446,6 +1474,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(mail, type) and issubclass(mail, Mail)):
             _mail = DataClass(Mail).fromDataclass(mail).toDict()
@@ -1542,6 +1574,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(queue, type) and issubclass(queue, Queue)):
             _queue = DataClass(Queue).fromDataclass(queue).toDict()
@@ -1638,6 +1674,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(session, type) and issubclass(session, Session)):
             _session = DataClass(Session).fromDataclass(session).toDict()
@@ -1734,6 +1774,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(testing, type) and issubclass(testing, Testing)):
             _testing = DataClass(Testing).fromDataclass(testing).toDict()
@@ -1866,6 +1910,10 @@ class Application(Container, IApplication):
         - The method always returns the current Application instance.
         """
 
+        # Prevent modification if the application has already been booted
+        if self.__booted:
+            raise OrionisValueError("Cannot modify configuration after application has been booted.")
+
         # Convert class type to dict using DataClass wrapper
         if (isinstance(paths, type) and issubclass(paths, Paths)):
             _paths = DataClass(Paths).fromDataclass(paths).toDict()

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/config/logging/entities/chunked.py

@@ -26,10 +26,10 @@ class Chunked(BaseEntity):
     """
 
     path: str = field(
-        default = 'storage/log/chunked.log',
+        default = 'storage/logs/chunked.log',
         metadata = {
             "description": "The file path where the log is stored.",
-            "default": "storage/log/chunked.log"
+            "default": "storage/logs/chunked.log"
         },
     )
 

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/config/logging/entities/daily.py

@@ -18,10 +18,10 @@ class Daily(BaseEntity):
     """
 
     path: str = field(
-        default = 'storage/log/daily.log',
+        default = 'storage/logs/daily.log',
         metadata = {
             "description": "The file path where the log is stored.",
-            "default": "storage/log/daily.log"
+            "default": "storage/logs/daily.log"
         },
     )
 

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/config/logging/entities/hourly.py

@@ -16,10 +16,10 @@ class Hourly(BaseEntity):
     """
 
     path: str = field(
-        default = 'storage/log/hourly.log',
+        default = 'storage/logs/hourly.log',
         metadata = {
             "description": "The file path where the log is stored.",
-            "default": "storage/log/hourly.log"
+            "default": "storage/logs/hourly.log"
         },
     )
 

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/config/logging/entities/monthly.py

@@ -16,10 +16,10 @@ class Monthly(BaseEntity):
     """
 
     path: str = field(
-        default = 'storage/log/monthly.log',
+        default = 'storage/logs/monthly.log',
         metadata = {
             "description": "The file path where the log is stored.",
-            "default": "storage/log/monthly.log"
+            "default": "storage/logs/monthly.log"
         },
     )
 

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/config/logging/entities/stack.py

@@ -10,10 +10,10 @@ class Stack(BaseEntity):
     """
 
     path: str = field(
-        default = 'storage/log/stack.log',
+        default = 'storage/logs/stack.log',
         metadata = {
             "description": "The file path where the log is stored.",
-            "default": "storage/log/stack.log"
+            "default": "storage/logs/stack.log"
         },
     )
 

{orionis-0.638.0 → orionis-0.640.0}/orionis/foundation/config/logging/entities/weekly.py

@@ -16,10 +16,10 @@ class Weekly(BaseEntity):
     """
 
     path: str = field(
-        default = 'storage/log/weekly.log',
+        default = 'storage/logs/weekly.log',
         metadata = {
             "description": "The file path where the log is stored.",
-            "default": "storage/log/weekly.log"
+            "default": "storage/logs/weekly.log"
         },
     )
 

{orionis-0.638.0 → orionis-0.640.0}/orionis/metadata/framework.py

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

{orionis-0.638.0 → orionis-0.640.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.638.0 → orionis-0.640.0}/orionis.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ orionis/console/base/scheduler_event_listener.py
 orionis/console/commands/__init__.py
 orionis/console/commands/cache.py
 orionis/console/commands/help.py
+orionis/console/commands/log.py
 orionis/console/commands/make_command.py
 orionis/console/commands/publisher.py
 orionis/console/commands/scheduler_list.py