orionis 0.568.0__tar.gz → 0.570.0__tar.gz

{orionis-0.568.0/orionis.egg-info → orionis-0.570.0}/PKG-INFO

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

{orionis-0.568.0 → orionis-0.570.0}/orionis/console/args/argument.py

@@ -2,7 +2,7 @@ import argparse
 from dataclasses import dataclass, field
 from typing import Any, Optional, List, Type, Union, Dict
 from orionis.console.enums.actions import ArgumentAction
-from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+from orionis.console.exceptions import CLIOrionisValueError
 
 @dataclass(kw_only=True, frozen=True, slots=True)
 class CLIArgument:

{orionis-0.568.0 → orionis-0.570.0}/orionis/console/core/reactor.py

@@ -10,9 +10,9 @@ from orionis.console.contracts.cli_request import ICLIRequest
 from orionis.console.contracts.command import ICommand
 from orionis.console.contracts.reactor import IReactor
 from orionis.console.entities.command import Command
-from orionis.console.exceptions import CLIOrionisValueError
-from orionis.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
+from orionis.console.exceptions import CLIOrionisValueError, CLIOrionisRuntimeError
 from orionis.console.contracts.executor import IExecutor
+from orionis.console.exceptions import CLIOrionisTypeError
 from orionis.console.request.cli_request import CLIRequest
 from orionis.foundation.contracts.application import IApplication
 from orionis.services.introspection.modules.reflection import ReflectionModule
@@ -107,6 +107,7 @@ class Reactor(IReactor):
         - The internal `__load_commands` flag tracks whether commands have been loaded
         - Both loading methods handle their own error handling and validation
         """
+
         # Check if commands have already been loaded to prevent duplicate loading
         if not self.__load_commands:
 
@@ -210,39 +211,47 @@ class Reactor(IReactor):
                             f"Failed to read file '{file_path}' for fluent command loading: {e}"
                         ) from e
 
+        # Import Command entity here to avoid circular imports
+        from orionis.console.entities.command import Command as CommandEntity
+
         # Iterate through all fluent command definitions
         for f_command in self.__fluent_commands:
 
-            # Validate and extract required command attributes
-            signature, command_entity = f_command.get()
-
-            # Build the arguments dictionary from the CLIArgument instances
-            required_args: List[CLIArgument] = command_entity.args
-
-            # Create an ArgumentParser instance to handle the command arguments
-            arg_parser = argparse.ArgumentParser(
-                usage=f"python -B reactor {signature} [options]",
-                description=f"Command [{signature}] : {command_entity.description}",
-                formatter_class=argparse.RawTextHelpFormatter,
-                add_help=True,
-                allow_abbrev=False,
-                exit_on_error=True,
-                prog=signature
-            )
-
-            # Iterate through each CLIArgument and add it to the ArgumentParser
-            for arg in required_args:
-                arg.addToParser(arg_parser)
+            # If the fluent command has a get method, retrieve its signature and command entity
+            if hasattr(f_command, 'get') and callable(getattr(f_command, 'get')):
+
+                # Get the signature and command entity from the fluent command
+                values = f_command.get()
+                signature: str = values[0]
+                command_entity: CommandEntity = values[1]
+
+                # Build the arguments dictionary from the CLIArgument instances
+                required_args: List[CLIArgument] = command_entity.args
+
+                # Create an ArgumentParser instance to handle the command arguments
+                arg_parser = argparse.ArgumentParser(
+                    usage=f"python -B reactor {signature} [options]",
+                    description=f"Command [{signature}] : {command_entity.description}",
+                    formatter_class=argparse.RawTextHelpFormatter,
+                    add_help=True,
+                    allow_abbrev=False,
+                    exit_on_error=True,
+                    prog=signature
+                )
 
-            # Register the command in the internal registry with all its metadata
-            self.__commands[signature] = Command(
-                obj=command_entity.obj,
-                method=command_entity.method,
-                timestamps=command_entity.timestamps,
-                signature=signature,
-                description=command_entity.description,
-                args=arg_parser
-            )
+                # Iterate through each CLIArgument and add it to the ArgumentParser
+                for arg in required_args:
+                    arg.addToParser(arg_parser)
+
+                # Register the command in the internal registry with all its metadata
+                self.__commands[signature] = Command(
+                    obj=command_entity.obj,
+                    method=command_entity.method,
+                    timestamps=command_entity.timestamps,
+                    signature=signature,
+                    description=command_entity.description,
+                    args=arg_parser
+                )
 
     def __loadCoreCommands(self) -> None:
         """
@@ -293,9 +302,15 @@ class Reactor(IReactor):
         # Iterate through the core command classes and register them
         for obj in core_commands:
 
+            # Get the signature attribute from the command class
+            signature = getattr(obj, 'signature', None)
+
+            # Skip if signature is not defined
+            if signature is None:
+                continue
+
             # Validate and extract required command attributes
             timestamp = self.__ensureTimestamps(obj)
-            signature = getattr(obj, 'signature', None)
             description = self.__ensureDescription(obj)
             args = self.__ensureArguments(obj)
 
@@ -338,6 +353,8 @@ class Reactor(IReactor):
 
         # Iterate through the command path and load command modules
         for current_directory, _, files in os.walk(commands_path):
+
+            # Iterate through each file in the current directory
             for file in files:
 
                 # Only process Python files
@@ -418,7 +435,7 @@ class Reactor(IReactor):
 
         # Ensure the timestamps attribute is a boolean type
         if not isinstance(obj.timestamps, bool):
-            raise TypeError(f"Command class {obj.__name__} 'timestamps' must be a boolean.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'timestamps' must be a boolean.")
 
         # Return timestamps value
         return obj.timestamps
@@ -444,24 +461,24 @@ class Reactor(IReactor):
 
         Raises
         ------
-        ValueError
+        CLIOrionisValueError
             If the command class lacks a 'signature' attribute, if the signature
             is an empty string, or if the signature doesn't match the required pattern.
-        TypeError
+        CLIOrionisTypeError
             If the 'signature' attribute is not a string.
         """
 
         # Check if the command class has a signature attribute
         if not hasattr(obj, 'signature'):
-            raise ValueError(f"Command class {obj.__name__} must have a 'signature' attribute.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} must have a 'signature' attribute.")
 
         # Ensure the signature attribute is a string type
         if not isinstance(obj.signature, str):
-            raise TypeError(f"Command class {obj.__name__} 'signature' must be a string.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'signature' must be a string.")
 
         # Validate that the signature is not empty after stripping whitespace
         if obj.signature.strip() == '':
-            raise ValueError(f"Command class {obj.__name__} 'signature' cannot be an empty string.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} 'signature' cannot be an empty string.")
 
         # Define the regex pattern for valid signature format
         # Pattern allows: alphanumeric chars, underscores, colons
@@ -470,7 +487,7 @@ class Reactor(IReactor):
 
         # Validate the signature against the required pattern
         if not re.match(pattern, obj.signature):
-            raise ValueError(f"Command class {obj.__name__} 'signature' must contain only alphanumeric characters, underscores (_) and colons (:), cannot start or end with underscore or colon, and cannot start with a number.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} 'signature' must contain only alphanumeric characters, underscores (_) and colons (:), cannot start or end with underscore or colon, and cannot start with a number.")
 
         # Return signature
         return obj.signature.strip()
@@ -496,24 +513,24 @@ class Reactor(IReactor):
 
         Raises
         ------
-        ValueError
+        CLIOrionisValueError
             If the command class lacks a 'description' attribute or if the description
             is an empty string after stripping whitespace.
-        TypeError
+        CLIOrionisTypeError
             If the 'description' attribute is not a string type.
         """
 
         # Check if the command class has a description attribute
         if not hasattr(obj, 'description'):
-            raise ValueError(f"Command class {obj.__name__} must have a 'description' attribute.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} must have a 'description' attribute.")
 
         # Ensure the description attribute is a string type
         if not isinstance(obj.description, str):
-            raise TypeError(f"Command class {obj.__name__} 'description' must be a string.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'description' must be a string.")
 
         # Validate that the description is not empty after stripping whitespace
         if obj.description.strip() == '':
-            raise ValueError(f"Command class {obj.__name__} 'description' cannot be an empty string.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} 'description' cannot be an empty string.")
 
         # Return description
         return obj.description.strip()
@@ -538,7 +555,7 @@ class Reactor(IReactor):
 
         Raises
         ------
-        TypeError
+        CLIOrionisTypeError
             If the 'arguments' attribute is not a list or contains non-CLIArgument instances.
         """
 
@@ -548,7 +565,7 @@ class Reactor(IReactor):
 
         # Ensure the arguments attribute is a list type
         if not isinstance(obj.arguments, list):
-            raise TypeError(f"Command class {obj.__name__} 'arguments' must be a list.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'arguments' must be a list.")
 
         # If arguments is empty, return None
         if len(obj.arguments) == 0:
@@ -557,7 +574,7 @@ class Reactor(IReactor):
         # Validate that all items in the arguments list are CLIArgument instances
         for index, value in enumerate(obj.arguments):
             if not isinstance(value, CLIArgument):
-                raise TypeError(f"Command class {obj.__name__} 'arguments' must contain only CLIArgument instances, found '{type(value).__name__}' at index {index}.")
+                raise CLIOrionisTypeError(f"Command class {obj.__name__} 'arguments' must contain only CLIArgument instances, found '{type(value).__name__}' at index {index}.")
 
         # Build the arguments dictionary from the CLIArgument instances
         required_args: List[CLIArgument] = obj.arguments
@@ -669,7 +686,7 @@ class Reactor(IReactor):
 
         Raises
         ------
-        TypeError
+        CLIOrionisTypeError
             If the signature is not a string or if the handler is not a valid list.
         ValueError
             If the signature does not meet the required naming conventions.
@@ -680,11 +697,11 @@ class Reactor(IReactor):
 
         # Validate the handler parameter
         if len(handler) < 1 or not isinstance(handler, list):
-            raise TypeError("Handler must be a list with at least one element (the callable).")
+            raise CLIOrionisValueError("Handler must be a list with at least one element (the callable).")
 
         # Ensure the first element is a class
         if not hasattr(handler[0], '__call__') or not hasattr(handler[0], '__name__'):
-            raise TypeError("The first element of handler must be a class.")
+            raise CLIOrionisTypeError("The first element of handler must be a class.")
 
         # Create a new FluentCommand instance with the provided signature and handler
         f_command = FluentCommand(

orionis-0.570.0/orionis/console/exceptions/__init__.py

@@ -0,0 +1,15 @@
+from .cli_exception import (
+    CLIOrionisException,
+    CLIOrionisRuntimeError,
+    CLIOrionisScheduleException,
+    CLIOrionisValueError,
+    CLIOrionisTypeError
+)
+
+__all__ = [
+    'CLIOrionisException',
+    'CLIOrionisRuntimeError',
+    'CLIOrionisScheduleException',
+    'CLIOrionisValueError',
+    'CLIOrionisTypeError',
+]

orionis-0.570.0/orionis/console/exceptions/cli_exception.py

@@ -0,0 +1,118 @@
+class CLIOrionisException(Exception):
+    """
+    Base exception for Orionis CLI errors.
+
+    This exception is raised for errors that are specific to the Orionis command-line interface (CLI)
+    operations. It serves as the base class for all CLI-related exceptions within the Orionis framework,
+    allowing for consistent error handling and identification of CLI-specific issues.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the exception.
+
+    Returns
+    -------
+    CLIOrionisException
+        An instance of the CLIOrionisException class.
+
+    Notes
+    -----
+    Subclass this exception to create more specific CLI-related exceptions as needed.
+    """
+    pass  # No additional implementation; serves as a base exception class.
+
+
+class CLIOrionisValueError(ValueError):
+    """
+    Exception for invalid CLI input values in Orionis.
+
+    Raised when a function receives an argument of the correct type but an inappropriate value
+    during CLI operations within the Orionis framework.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the value error.
+
+    Returns
+    -------
+    CLIOrionisValueError
+        An instance of the CLIOrionisValueError class.
+
+    Notes
+    -----
+    Use this exception to signal invalid or inappropriate values encountered during CLI operations.
+    """
+    pass  # Inherits from ValueError to indicate value-related errors.
+
+
+class CLIOrionisRuntimeError(RuntimeError):
+    """
+    Exception for runtime errors in Orionis CLI.
+
+    Raised when a runtime error occurs during the execution of CLI commands within the Orionis framework,
+    distinguishing these errors from other runtime errors.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the runtime error.
+
+    Returns
+    -------
+    CLIOrionisRuntimeError
+        An instance of the CLIOrionisRuntimeError class.
+
+    Notes
+    -----
+    Use this exception to handle runtime errors specific to CLI contexts.
+    """
+    pass  # Inherits from RuntimeError for CLI-specific runtime issues.
+
+
+class CLIOrionisScheduleException(Exception):
+    """
+    Exception for scheduling errors in Orionis CLI.
+
+    Raised when issues are encountered during scheduling tasks within the Orionis command-line interface.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the scheduling exception.
+
+    Returns
+    -------
+    CLIOrionisScheduleException
+        An instance of the CLIOrionisScheduleException class.
+
+    Notes
+    -----
+    Use this exception to signal errors related to scheduling operations in the CLI.
+    """
+    pass  # Used for errors related to scheduling operations.
+
+
+class CLIOrionisTypeError(TypeError):
+    """
+    Exception for invalid types in Orionis CLI.
+
+    Raised when an invalid type is encountered during command-line interface operations in the Orionis framework,
+    providing clearer context than the built-in TypeError.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the type error.
+
+    Returns
+    -------
+    CLIOrionisTypeError
+        An instance of the CLIOrionisTypeError class.
+
+    Notes
+    -----
+    Use this exception to handle type-related errors specific to CLI operations.
+    """
+    pass  # Inherits from TypeError for CLI-specific type errors.

{orionis-0.568.0 → orionis-0.570.0}/orionis/console/request/cli_request.py

@@ -1,6 +1,6 @@
 from typing import Any, List
 from orionis.console.contracts.cli_request import ICLIRequest
-from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+from orionis.console.exceptions import CLIOrionisValueError
 
 class CLIRequest(ICLIRequest):
 

{orionis-0.568.0 → orionis-0.570.0}/orionis/console/stub/command.stub

@@ -1,6 +1,6 @@
 from orionis.console.base.command import BaseCommand
 from orionis.console.args.argument import CLIArgument
-from orionis.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
+from orionis.console.exceptions import CLIOrionisRuntimeError
 
 class {{class_name}}(BaseCommand):
     """

{orionis-0.568.0 → orionis-0.570.0}/orionis/console/tasks/schedule.py

@@ -33,7 +33,7 @@ from orionis.console.entities.scheduler_started import SchedulerStarted
 from orionis.console.entities.event import Event as EventEntity
 from orionis.console.enums.listener import ListeningEvent
 from orionis.console.exceptions import CLIOrionisRuntimeError
-from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+from orionis.console.exceptions import CLIOrionisValueError
 from orionis.console.request.cli_request import CLIRequest
 from orionis.failure.contracts.catch import ICatch
 from orionis.foundation.contracts.application import IApplication

{orionis-0.568.0 → orionis-0.570.0}/orionis/metadata/framework.py

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

{orionis-0.568.0 → orionis-0.570.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.568.0 → orionis-0.570.0}/orionis.egg-info/SOURCES.txt

@@ -64,9 +64,6 @@ orionis/console/enums/listener.py
 orionis/console/enums/styles.py
 orionis/console/exceptions/__init__.py
 orionis/console/exceptions/cli_exception.py
-orionis/console/exceptions/cli_orionis_value_error.py
-orionis/console/exceptions/cli_runtime_error.py
-orionis/console/exceptions/cli_schedule_exception.py
 orionis/console/fluent/__init__.py
 orionis/console/fluent/command.py
 orionis/console/fluent/event.py

orionis-0.568.0/orionis/console/exceptions/__init__.py

@@ -1,11 +0,0 @@
-from .cli_exception import CLIOrionisException
-from .cli_runtime_error import CLIOrionisRuntimeError
-from .cli_schedule_exception import CLIOrionisScheduleException
-from .cli_orionis_value_error import CLIOrionisValueError
-
-__all__ = [
-    'CLIOrionisException',
-    'CLIOrionisRuntimeError',
-    'CLIOrionisScheduleException',
-    'CLIOrionisValueError'
-]

orionis-0.568.0/orionis/console/exceptions/cli_exception.py

@@ -1,41 +0,0 @@
-class CLIOrionisException(Exception):
-    """
-    Custom exception raised when there is an issue with dumping the Orionis data.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisException with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisException: {self.args[0]}"

orionis-0.568.0/orionis/console/exceptions/cli_orionis_value_error.py

@@ -1,41 +0,0 @@
-class CLIOrionisValueError(ValueError):
-    """
-    Custom exception raised when there is a value error in Orionis data processing.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisValueError with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisValueError: {self.args[0]}"

orionis-0.568.0/orionis/console/exceptions/cli_runtime_error.py

@@ -1,41 +0,0 @@
-class CLIOrionisRuntimeError(RuntimeError):
-    """
-    Custom exception raised when there is a runtime issue with Orionis processing.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisRuntimeError with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisRuntimeError: {self.args[0]}"

orionis-0.568.0/orionis/console/exceptions/cli_schedule_exception.py

@@ -1,41 +0,0 @@
-class CLIOrionisScheduleException(Exception):
-    """
-    Custom exception raised when there is an issue with the Orionis schedule.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisScheduleException with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisScheduleException: {self.args[0]}"