orionis 0.579.0__py3-none-any.whl → 0.580.0__py3-none-any.whl

orionis/foundation/exceptions/__init__.py

@@ -1,7 +1,9 @@
-from .integrity import OrionisIntegrityException
-from .value import OrionisValueError
-from .type import OrionisTypeError
-from .runtime import OrionisRuntimeError
+from .application import (
+    OrionisIntegrityException,
+    OrionisValueError,
+    OrionisTypeError,
+    OrionisRuntimeError
+)
 
 __all__ = [
     "OrionisIntegrityException",

orionis/foundation/exceptions/application.py

@@ -0,0 +1,11 @@
+class OrionisIntegrityException(Exception):
+    pass
+
+class OrionisRuntimeError(RuntimeError):
+    pass
+
+class OrionisTypeError(TypeError):
+    pass
+
+class OrionisValueError(ValueError):
+    pass

orionis/foundation/providers/catch_provider.py

@@ -30,7 +30,7 @@ class CathcProvider(ServiceProvider):
         """
 
         # Bind ICatch to Catch as a singleton with a specific alias
-        self.app.singleton(ICatch, Catch, alias="x-orionis.failure.catch")
+        self.app.singleton(ICatch, Catch, alias=f"x-{ICatch.__module__}.{ICatch.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/cli_request_provider.py

@@ -25,7 +25,7 @@ class CLRequestProvider(ServiceProvider):
         """
         # Register CLIRequest as a transient service bound to ICLIRequest interface
         # Transient services create a new instance each time they are resolved
-        self.app.transient(ICLIRequest, CLIRequest, alias="x-orionis.console.request.cli_request")
+        self.app.transient(ICLIRequest, CLIRequest, alias=f"x-{ICLIRequest.__module__}.{ICLIRequest.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/console_provider.py

@@ -37,7 +37,7 @@ class ConsoleProvider(ServiceProvider):
             modifying the application's service container.
         """
 
-        self.app.transient(IConsole, Console, alias="x-orionis.console.output.console")
+        self.app.transient(IConsole, Console, alias=f"x-{IConsole.__module__}.{IConsole.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/directory_provider.py

@@ -37,7 +37,7 @@ class DirectoryProvider(ServiceProvider):
             This method does not return any value.
         """
         # Bind IDirectory to Directory as a singleton with a specific alias
-        self.app.singleton(IDirectory, Directory, alias="x-orionis.services.file.contracts.directory")
+        self.app.singleton(IDirectory, Directory, alias=f"x-{IDirectory.__module__}.{IDirectory.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/dumper_provider.py

@@ -54,7 +54,7 @@ class DumperProvider(ServiceProvider):
             modifying the application container's service registry.
         """
 
-        self.app.transient(IDebug, Debug, alias="x-orionis.console.dumper.dump")
+        self.app.transient(IDebug, Debug, alias=f"x-{IDebug.__module__}.{IDebug.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/executor_provider.py

@@ -54,7 +54,7 @@ class ConsoleExecuteProvider(ServiceProvider):
             registering the executor service binding in the application container.
         """
 
-        self.app.transient(IExecutor, Executor, alias="x-orionis.console.output.executor")
+        self.app.transient(IExecutor, Executor, alias=f"x-{IExecutor.__module__}.{IExecutor.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/inspirational_provider.py

@@ -50,7 +50,7 @@ class InspirationalProvider(ServiceProvider):
             return any value.
         """
 
-        self.app.transient(IInspire, Inspire, alias="x-orionis.services.inspirational.inspire")
+        self.app.transient(IInspire, Inspire, alias=f"x-{IInspire.__module__}.{IInspire.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/logger_provider.py

@@ -54,7 +54,7 @@ class LoggerProvider(ServiceProvider):
         logger_service = Logger(logging_config)
 
         # Register the service instance in the container with interface binding and alias
-        self.app.instance(ILogger, logger_service, alias="x-orionis.services.log.log_service")
+        self.app.instance(ILogger, logger_service, alias=f"x-{ILogger.__module__}.{ILogger.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/performance_counter_provider.py

@@ -34,7 +34,7 @@ class PerformanceCounterProvider(ServiceProvider):
 
         # Register the IPerformanceCounter interface to the PerformanceCounter implementation
         # with a transient lifetime and assign an alias for alternative resolution.
-        self.app.transient(IPerformanceCounter, PerformanceCounter, alias="x-orionis.support.performance.counter")
+        self.app.transient(IPerformanceCounter, PerformanceCounter, alias=f"x-{IPerformanceCounter.__module__}.{IPerformanceCounter.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/progress_bar_provider.py

@@ -58,7 +58,7 @@ class ProgressBarProvider(ServiceProvider):
             as a side effect on the application container.
         """
 
-        self.app.transient(IProgressBar, ProgressBar, alias="x-orionis.console.dynamic.progress_bar")
+        self.app.transient(IProgressBar, ProgressBar, alias=f"x-{IProgressBar.__module__}.{IProgressBar.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/reactor_provider.py

@@ -57,8 +57,7 @@ class ReactorProvider(ServiceProvider):
 
         # Register the Reactor service with the application container
         # as a singleton, allowing it to be resolved throughout the application lifecycle
-        self.app.singleton(IReactor, Reactor, alias="x-orionis.console.core.reactor")
-
+        self.app.singleton(IReactor, Reactor, alias=f"x-{IReactor.__module__}.{IReactor.__name__}")
     def boot(self) -> None:
         """
         Perform post-registration initialization for the reactor management service.

orionis/foundation/providers/scheduler_provider.py

@@ -33,7 +33,7 @@ class ScheduleProvider(ServiceProvider):
             This method does not return any value.
         """
         # Bind Scheduler as a singleton to the ISchedule interface with an alias
-        self.app.singleton(ISchedule, Schedule, alias="x-orionis.console.contracts.schedule")
+        self.app.singleton(ISchedule, Schedule, alias=f"x-{ISchedule.__module__}.{ISchedule.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/testing_provider.py

@@ -59,7 +59,7 @@ class TestingProvider(ServiceProvider):
 
         # Register the UnitTest service as a singleton in the application container.
         # The service is bound to the IUnitTest interface and can be resolved using the alias.
-        self.app.singleton(IUnitTest, UnitTest, alias="x-orionis.test.core.unit_test")
+        self.app.singleton(IUnitTest, UnitTest, alias=f"x-{IUnitTest.__module__}.{IUnitTest.__name__}")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/workers_provider.py

@@ -57,7 +57,7 @@ class WorkersProvider(ServiceProvider):
         - Suitable for stateless or short-lived worker operations
         """
 
-        self.app.transient(IWorkers, Workers, alias="x-orionis.services.system.workers")
+        self.app.transient(IWorkers, Workers, alias=f"x-{IWorkers.__module__}.{IWorkers.__name__}")
 
     def boot(self) -> None:
         """

orionis/metadata/framework.py

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

orionis/services/asynchrony/exceptions/__init__.py

@@ -1,4 +1,4 @@
-from .exception import OrionisCoroutineException
+from .asynchrony import OrionisCoroutineException
 
 __all__ = [
     "OrionisCoroutineException"

orionis/services/asynchrony/exceptions/asynchrony.py

@@ -0,0 +1,11 @@
+class OrionisCoroutineException(Exception):
+    """
+    Exception raised for errors that occur within Orionis coroutines.
+
+    This exception serves as a base for coroutine-related errors in the Orionis framework,
+    allowing for more specific exception handling in asynchronous operations.
+
+    Attributes:
+        message (str): Optional error message describing the exception.
+    """
+    pass

orionis/services/environment/core/dot_env.py

@@ -5,6 +5,7 @@ from pathlib import Path
 from typing import Any, Optional, Union
 from dotenv import dotenv_values, load_dotenv, set_key, unset_key
 from orionis.services.environment.enums import EnvironmentValueType
+from orionis.services.environment.exceptions.environment import OrionisEnvironmentException, OrionisOperatingSystemError
 from orionis.services.environment.validators import ValidateKeyName, ValidateTypes
 from orionis.support.patterns.singleton import Singleton
 from orionis.services.environment.dynamic.caster import EnvironmentCaster
@@ -59,12 +60,12 @@ class DotEnv(metaclass=Singleton):
         except OSError as e:
 
             # Raise an error if the .env file cannot be created or accessed
-            raise OSError(f"Failed to create or access the .env file at {self.__resolved_path}: {e}")
+            raise OrionisOperatingSystemError(f"Failed to create or access the .env file at {self.__resolved_path}: {e}")
 
         except Exception as e:
 
             # Raise a general error for any other exceptions during initialization
-            raise Exception(f"An unexpected error occurred while initializing DotEnv: {e}")
+            raise OrionisEnvironmentException(f"An unexpected error occurred while initializing DotEnv: {e}")
 
     def set(
         self,

orionis/services/environment/dynamic/caster.py

@@ -658,12 +658,12 @@ class EnvironmentCaster(IEnvironmentCaster):
 
             # Ensure the evaluated object is a list
             if not isinstance(parsed, list):
-                raise ValueError("Value is not a list")
+                raise OrionisEnvironmentValueError("Value is not a list")
 
             # Return the parsed list if successful
             return parsed
 
-        except (ValueError, SyntaxError) as e:
+        except (OrionisEnvironmentValueError, ValueError, SyntaxError) as e:
 
             # Raise a custom exception if conversion fails
             raise OrionisEnvironmentValueException(f"Cannot convert '{value}' to list: {str(e)}")
@@ -735,12 +735,12 @@ class EnvironmentCaster(IEnvironmentCaster):
 
             # Ensure the evaluated object is a dictionary
             if not isinstance(parsed, dict):
-                raise ValueError("Value is not a dict")
+                raise OrionisEnvironmentValueError("Value is not a dict")
 
             # Return the parsed dictionary if successful
             return parsed
 
-        except (ValueError, SyntaxError) as e:
+        except (OrionisEnvironmentValueError, ValueError, SyntaxError) as e:
 
             # Raise a custom exception if conversion fails
             raise OrionisEnvironmentValueException(f"Cannot convert '{value}' to dict: {str(e)}")
@@ -806,12 +806,12 @@ class EnvironmentCaster(IEnvironmentCaster):
 
             # Ensure the evaluated object is a tuple
             if not isinstance(parsed, tuple):
-                raise ValueError("Value is not a tuple")
+                raise OrionisEnvironmentValueError("Value is not a tuple")
 
             # Return the parsed tuple if successful
             return parsed
 
-        except (ValueError, SyntaxError) as e:
+        except (OrionisEnvironmentValueError, ValueError, SyntaxError) as e:
 
             # Raise a custom exception if conversion fails
             raise OrionisEnvironmentValueException(f"Cannot convert '{value}' to tuple: {str(e)}")
@@ -877,12 +877,12 @@ class EnvironmentCaster(IEnvironmentCaster):
 
             # Ensure the evaluated object is a set
             if not isinstance(parsed, set):
-                raise ValueError("Value is not a set")
+                raise OrionisEnvironmentValueError("Value is not a set")
 
             # Return the parsed set if successful
             return parsed
 
-        except (ValueError, SyntaxError) as e:
+        except (OrionisEnvironmentValueError, ValueError, SyntaxError) as e:
 
             # Raise a custom exception if conversion fails
             raise OrionisEnvironmentValueException(f"Cannot convert '{value}' to set: {str(e)}")

orionis/services/environment/exceptions/__init__.py

@@ -1,7 +1,15 @@
-from .exception import OrionisEnvironmentValueException
-from .value import OrionisEnvironmentValueError
+from .environment import (
+    OrionisEnvironmentValueException,
+    OrionisEnvironmentValueError,
+    OrionisEnvironmentTypeException,
+    OrionisOperatingSystemError,
+    OrionisEnvironmentException
+)
 
 __all__ = [
     "OrionisEnvironmentValueException",
-    "OrionisEnvironmentValueError"
+    "OrionisEnvironmentValueError",
+    "OrionisEnvironmentTypeException",
+    "OrionisOperatingSystemError",
+    "OrionisEnvironmentException"
 ]

orionis/services/environment/exceptions/environment.py

@@ -0,0 +1,125 @@
+class OrionisEnvironmentValueException(Exception):
+    """
+    Exception raised for invalid or unexpected values in the Orionis environment configuration.
+
+    This exception is used to indicate that an environment variable or configuration setting
+    within the Orionis framework does not conform to the expected value constraints.
+
+    Parameters
+    ----------
+    message : str, optional
+        Explanation of the error.
+
+    Returns
+    -------
+    OrionisEnvironmentValueException
+        An instance of this exception is raised when an invalid environment value is encountered.
+
+    Attributes
+    ----------
+    message : str
+        Optional explanation of the error.
+    """
+    # No additional implementation; inherits from Exception
+    pass
+
+class OrionisEnvironmentTypeException(Exception):
+    """
+    Exception raised for invalid or unsupported environment types in the Orionis framework.
+
+    This exception signals that an environment type provided to the framework is not recognized
+    or is not supported according to the framework's requirements.
+
+    Parameters
+    ----------
+    message : str, optional
+        Description of the error.
+
+    Returns
+    -------
+    OrionisEnvironmentTypeException
+        An instance of this exception is raised when an invalid environment type is encountered.
+
+    Attributes
+    ----------
+    message : str
+        Optional error message describing the exception.
+    """
+    # No additional implementation; inherits from Exception
+    pass
+
+class OrionisEnvironmentValueError(Exception):
+    """
+    Exception raised when a value does not meet the required criteria in the Orionis environment configuration.
+
+    This exception is typically used to indicate that a provided value violates constraints or
+    requirements defined by the environment settings in the Orionis framework.
+
+    Parameters
+    ----------
+    message : str, optional
+        Explanation of the error.
+
+    Returns
+    -------
+    OrionisEnvironmentValueError
+        An instance of this exception is raised when a value fails validation.
+
+    Attributes
+    ----------
+    message : str
+        Optional explanation of the error.
+    """
+    # No additional implementation; inherits from Exception
+    pass
+
+class OrionisOperatingSystemError(OSError):
+    """
+    Exception raised when a value or parameter in the Orionis environment configuration has an incorrect type.
+
+    This exception is used to signal that a provided value does not match the expected type as required by
+    the Orionis framework's environment settings, which may lead to misconfiguration or runtime errors.
+
+    Parameters
+    ----------
+    message : str, optional
+        Description of the type mismatch error.
+
+    Returns
+    -------
+    OrionisOperatingSystemError
+        An instance of this exception is raised when a type mismatch is detected in the environment configuration.
+
+    Attributes
+    ----------
+    message : str
+        Optional error message describing the exception.
+    """
+    # No additional implementation; inherits from OSError
+    pass
+
+class OrionisEnvironmentException(Exception):
+    """
+    General exception for errors related to the Orionis environment configuration.
+
+    This exception serves as a base class for more specific environment-related exceptions
+    within the Orionis framework. It can be used to catch all environment-related errors
+    in a single exception handler.
+
+    Parameters
+    ----------
+    message : str, optional
+        Description of the error.
+
+    Returns
+    -------
+    OrionisEnvironmentException
+        An instance of this exception is raised for general environment-related errors.
+
+    Attributes
+    ----------
+    message : str
+        Optional error message describing the exception.
+    """
+    # No additional implementation; inherits from Exception
+    pass

orionis/services/environment/key/key_generator.py

@@ -1,29 +1,25 @@
 import os
 import base64
+from orionis.foundation.config.app.enums.ciphers import Cipher
 
 class SecureKeyGenerator:
-    """
-    Utility class for generating Laravel-compatible APP_KEY values.
-
-    Laravel expects keys in Base64 format, prefixed with 'base64:'.
-    Supported ciphers: AES-128-CBC, AES-256-CBC, AES-128-GCM, AES-256-GCM.
-    """
 
+    # Mapping of cipher modes to their respective key sizes in bytes
     KEY_SIZES = {
-        "AES-128-CBC": 16,
-        "AES-256-CBC": 32,
-        "AES-128-GCM": 16,
-        "AES-256-GCM": 32,
+        Cipher.AES_128_CBC: 16,
+        Cipher.AES_256_CBC: 32,
+        Cipher.AES_128_GCM: 16,
+        Cipher.AES_256_GCM: 32
     }
 
     @staticmethod
-    def generate(cipher: str = "AES-256-CBC") -> str:
+    def generate(cipher: str | Cipher = Cipher.AES_256_CBC) -> str:
         """
         Generate a Laravel-compatible APP_KEY.
 
         Parameters
         ----------
-        cipher : str
+        cipher : str | Cipher
             The cipher algorithm. Options: AES-128-CBC, AES-256-CBC,
             AES-128-GCM, AES-256-GCM. Default is AES-256-CBC.
 
@@ -32,16 +28,24 @@ class SecureKeyGenerator:
         str
             A string formatted like Laravel's APP_KEY (e.g., base64:xxxx).
         """
-        if cipher not in SecureKeyGenerator.KEY_SIZES:
+        # Normalize cipher input to Cipher enum if string is provided
+        if isinstance(cipher, str):
+            try:
+                cipher_enum = Cipher(cipher)
+            except ValueError:
+                raise ValueError(
+                    f"Cipher '{cipher}' is not supported. "
+                    f"Options: {', '.join(c.value for c in SecureKeyGenerator.KEY_SIZES.keys())}"
+                )
+        else:
+            cipher_enum = cipher
+
+        if cipher_enum not in SecureKeyGenerator.KEY_SIZES:
             raise ValueError(
-                f"Cipher '{cipher}' no soportado. "
-                f"Opciones: {', '.join(SecureKeyGenerator.KEY_SIZES.keys())}"
+                f"Cipher '{cipher_enum}' is not supported. "
+                f"Options: {', '.join(c.value for c in SecureKeyGenerator.KEY_SIZES.keys())}"
             )
 
-        key_length = SecureKeyGenerator.KEY_SIZES[cipher]
-
-        # Generate secure random bytes
+        key_length = SecureKeyGenerator.KEY_SIZES[cipher_enum]
         key = os.urandom(key_length)
-
-        # Encode in Base64 and prepend 'base64:'
-        return "base64:" + base64.b64encode(key).decode("utf-8")
+        return f"base64:{base64.b64encode(key).decode('utf-8')}"

orionis/services/environment/validators/key_name.py

@@ -1,5 +1,5 @@
 import re
-from orionis.services.environment.exceptions.value import OrionisEnvironmentValueError
+from orionis.services.environment.exceptions import OrionisEnvironmentValueError
 
 class __ValidateKeyName:
 

orionis/services/environment/validators/types.py

@@ -1,6 +1,6 @@
 from typing import Union
 from orionis.services.environment.enums.value_type import EnvironmentValueType
-from orionis.services.environment.exceptions.value import OrionisEnvironmentValueError
+from orionis.services.environment.exceptions import OrionisEnvironmentValueError
 
 class __ValidateTypes:
 

orionis/services/file/contracts/directory.py

@@ -349,4 +349,16 @@ class IDirectory(ABC):
         Path
             The path to the storage directory.
         """
+        pass
+
+    @abstractmethod
+    def tests(self) -> Path:
+        """
+        Get the tests directory path.
+
+        Returns
+        -------
+        Path
+            The path to the tests directory.
+        """
         pass

orionis/services/file/directory.py

@@ -343,4 +343,15 @@ class Directory(IDirectory):
         Path
             The path to the storage directory.
         """
-        return Path(self.__app.path('storage'))
+        return Path(self.__app.path('storage'))
+
+    def tests(self) -> Path:
+        """
+        Get the tests directory path.
+
+        Returns
+        -------
+        Path
+            The path to the tests directory.
+        """
+        return Path(self.__app.path('tests'))

orionis/services/introspection/dataclass/{attributes.py → extractor.py}

@@ -1,4 +1,4 @@
-class DataclassValues:
+class DataclassInspector:
 
     def __call__(self, dataclass_type: type) -> dict:
         """
@@ -42,4 +42,4 @@ class DataclassValues:
         raise TypeError("The provided argument is not a valid dataclass type.")
 
 # Instantiate the DataclassValues callable
-attributes = DataclassValues()
+extractor = DataclassInspector()

orionis/services/introspection/exceptions/__init__.py

@@ -1,6 +1,8 @@
-from .value import ReflectionValueError
-from .attribute import ReflectionAttributeError
-from .type import ReflectionTypeError
+from .introspection import (
+    ReflectionAttributeError,
+    ReflectionValueError,
+    ReflectionTypeError
+)
 
 __all__ = [
     "ReflectionValueError",

orionis/services/introspection/exceptions/introspection.py

@@ -0,0 +1,76 @@
+class ReflectionAttributeError(Exception):
+    """
+    Exception raised when an attribute cannot be found during reflection or introspection operations.
+
+    This exception is typically raised when attempting to access an attribute that does not exist
+    or is not accessible on the target object during reflection or introspection.
+
+    Parameters
+    ----------
+    *args : tuple
+        Variable length argument list passed to the base Exception.
+    **kwargs : dict
+        Arbitrary keyword arguments passed to the base Exception.
+
+    Returns
+    -------
+    ReflectionAttributeError
+        An instance of the ReflectionAttributeError exception.
+
+    Notes
+    -----
+    This exception does not define additional attributes beyond those provided by Exception.
+    """
+    pass  # Custom exception for attribute errors during reflection
+
+
+class ReflectionTypeError(Exception):
+    """
+    Exception raised when a type-related error occurs during reflection or introspection operations.
+
+    This exception signals issues such as invalid type usage, type mismatches, or unsupported types
+    encountered while performing reflection-based logic.
+
+    Parameters
+    ----------
+    *args : tuple
+        Variable length argument list passed to the base Exception.
+    **kwargs : dict
+        Arbitrary keyword arguments passed to the base Exception.
+
+    Returns
+    -------
+    ReflectionTypeError
+        An instance of the ReflectionTypeError exception.
+
+    Notes
+    -----
+    This exception does not define additional attributes beyond those provided by Exception.
+    """
+    pass  # Custom exception for type errors during reflection
+
+
+class ReflectionValueError(Exception):
+    """
+    Exception raised when a reflection operation encounters an invalid or unexpected value.
+
+    This exception is used within introspection services to indicate that a value obtained or
+    manipulated via reflection does not meet the expected criteria or format.
+
+    Parameters
+    ----------
+    *args : tuple
+        Variable length argument list passed to the base Exception.
+    **kwargs : dict
+        Arbitrary keyword arguments passed to the base Exception.
+
+    Returns
+    -------
+    ReflectionValueError
+        An instance of the ReflectionValueError exception.
+
+    Notes
+    -----
+    This exception does not define additional attributes beyond those provided by Exception.
+    """
+    pass  # Custom exception for value errors during reflection