orionis 0.392.0__py3-none-any.whl → 0.394.0__py3-none-any.whl

orionis/foundation/application.py

@@ -1,9 +1,8 @@
-from typing import Any, Type, List
+from pathlib import Path
+from typing import Any, List, Type
 from orionis.container.container import Container
 from orionis.container.contracts.service_provider import IServiceProvider
 from orionis.foundation.config.app.entities.app import App
-from orionis.foundation.config.app.enums.ciphers import Cipher
-from orionis.foundation.config.app.enums.environments import Environments
 from orionis.foundation.config.auth.entities.auth import Auth
 from orionis.foundation.config.cache.entities.cache import Cache
 from orionis.foundation.config.cors.entities.cors import Cors
@@ -160,9 +159,12 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Add each provider class
         for provider_cls in providers:
             self.addProvider(provider_cls)
+
+        # Return self instance for method chaining
         return self
 
     def addProvider(
@@ -187,6 +189,7 @@ class Application(Container, IApplication):
         TypeError
             If provider is not a subclass of IServiceProvider
         """
+
         # Validate provider type
         if not isinstance(provider, type) or not issubclass(provider, IServiceProvider):
             raise TypeError(f"Expected IServiceProvider class, got {type(provider).__name__}")
@@ -212,7 +215,42 @@ class Application(Container, IApplication):
         session : Session = None,
         testing : Testing = None,
     ) -> 'Application':
+        """
+        Configure the application with various service configurators.
+        This method allows you to set up different aspects of the application by providing
+        configurator instances for various services like authentication, caching, database,
+        etc. If no configurator is provided for a service, a default instance will be created.
+        Parameters
+        ----------
+        app : App, optional
+            Application configurator instance. If None, creates a default App() instance.
+        auth : Auth, optional
+            Authentication configurator instance. If None, creates a default Auth() instance.
+        cache : Cache, optional
+            Cache configurator instance. If None, creates a default Cache() instance.
+        cors : Cors, optional
+            CORS configurator instance. If None, creates a default Cors() instance.
+        database : Database, optional
+            Database configurator instance. If None, creates a default Database() instance.
+        filesystems : Filesystems, optional
+            Filesystems configurator instance. If None, creates a default Filesystems() instance.
+        logging : Logging, optional
+            Logging configurator instance. If None, creates a default Logging() instance.
+        mail : Mail, optional
+            Mail configurator instance. If None, creates a default Mail() instance.
+        queue : Queue, optional
+            Queue configurator instance. If None, creates a default Queue() instance.
+        session : Session, optional
+            Session configurator instance. If None, creates a default Session() instance.
+        testing : Testing, optional
+            Testing configurator instance. If None, creates a default Testing() instance.
+        Returns
+        -------
+        Application
+            Returns self to allow method chaining.
+        """
 
+        # Load each configurator with default or provided instances
         self.loadConfigApp(app or App())
         self.loadConfigAuth(auth or Auth())
         self.loadConfigCache(cache or Cache())
@@ -225,77 +263,29 @@ class Application(Container, IApplication):
         self.loadConfigSession(session or Session())
         self.loadConfigTesting(testing or Testing())
 
+        # Return self instance for method chaining
         return self
 
-    def configApp(
-        self,
-        *,
-        name: str = None,
-        env: str | Environments = None,
-        debug: bool = None,
-        url: str = None,
-        port: int = None,
-        workers: int = None,
-        reload: bool = None,
-        timezone: str = None,
-        locale: str = None,
-        fallback_locale: str = None,
-        cipher: str | Cipher = None,
-        key: str = None,
-        maintenance: str = None
-    ) -> 'Application':
+    def configApp(self, **app_config) -> 'Application':
         """
         Configure the application with various settings.
 
         Parameters
         ----------
-        name : str, optional
-            The name of the application
-        env : str | Environments, optional
-            The environment of the application (e.g., 'development', 'production')
-        debug : bool, optional
-            Whether to enable debug mode
-        url : str, optional
-            The base URL of the application
-        port : int, optional
-            The port on which the application runs
-        workers : int, optional
-            Number of worker processes for handling requests
-        reload : bool, optional
-            Whether to enable auto-reloading of the application
-        timezone : str, optional
-            The timezone for the application
-        locale : str, optional
-            The default locale for the application
-        fallback_locale : str, optional
-            The fallback locale if the default is not available
-        cipher : str | Cipher, optional
-            The encryption cipher used by the application
-        key : str, optional
-            The encryption key used by the application
-        maintenance : str, optional
-            The maintenance route for the application
+        **app_config : dict
+            Configuration parameters for the application. Must match the fields
+            expected by the App dataclass (orionis.foundation.config.app.entities.app.App).
 
         Returns
         -------
         Application
             The application instance for method chaining
-
-        Raises
-        ------
-        TypeError
-            If any parameter is of an incorrect type or value.
         """
-        # Create App instance with provided parameters and validate it.
-        params = {}
-        for _key, _value in locals().items():
-            if _key != 'self' and _value is not None:
-                params[_key] = _value
 
-        # Create App instance with validated parameters
-        app = App(**params)
+        # Create App instance with provided parameters
+        app = App(**app_config)
 
-        # Load configuration using App instance.
+        # Load configuration using App instance
         self.loadConfigApp(app)
 
         # Return the application instance for method chaining
@@ -318,6 +308,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate config type
         if not isinstance(app, App):
             raise TypeError(f"Expected App instance, got {type(app).__name__}")
@@ -328,6 +319,31 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configAuth(self, **auth_config) -> 'Application':
+        """
+        Configure the authentication with various settings.
+
+        Parameters
+        ----------
+        **auth_config : dict
+            Configuration parameters for authentication. Must match the fields
+            expected by the Auth dataclass (orionis.foundation.config.auth.entities.auth.Auth).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Auth instance with provided parameters
+        auth = Auth(**auth_config)
+
+        # Load configuration using Auth instance
+        self.loadConfigAuth(auth)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigAuth(
         self,
         auth: Auth
@@ -345,6 +361,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate auth type
         if not isinstance(auth, Auth):
             raise TypeError(f"Expected Auth instance, got {type(auth).__name__}")
@@ -355,6 +372,31 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configCache(self, **cache_config) -> 'Application':
+        """
+        Configure the cache with various settings.
+
+        Parameters
+        ----------
+        **cache_config : dict
+            Configuration parameters for cache. Must match the fields
+            expected by the Cache dataclass (orionis.foundation.config.cache.entities.cache.Cache).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Cache instance with provided parameters
+        cache = Cache(**cache_config)
+
+        # Load configuration using Cache instance
+        self.loadConfigCache(cache)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigCache(
         self,
         cache: Cache
@@ -372,6 +414,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate cache type
         if not isinstance(cache, Cache):
             raise TypeError(f"Expected Cache instance, got {type(cache).__name__}")
@@ -382,6 +425,31 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configCors(self, **cors_config) -> 'Application':
+        """
+        Configure the CORS with various settings.
+
+        Parameters
+        ----------
+        **cors_config : dict
+            Configuration parameters for CORS. Must match the fields
+            expected by the Cors dataclass (orionis.foundation.config.cors.entities.cors.Cors).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Cors instance with provided parameters
+        cors = Cors(**cors_config)
+
+        # Load configuration using Cors instance
+        self.loadConfigCors(cors)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigCors(
         self,
         cors: Cors
@@ -399,6 +467,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate cors type
         if not isinstance(cors, Cors):
             raise TypeError(f"Expected Cors instance, got {type(cors).__name__}")
@@ -409,6 +478,34 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configDatabase(
+        self,
+        **database_config
+    ) -> 'Application':
+        """
+        Configure the database with various settings.
+
+        Parameters
+        ----------
+        **database_config : dict
+            Configuration parameters for database. Must match the fields
+            expected by the Database dataclass (orionis.foundation.config.database.entities.database.Database).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Database instance with provided parameters
+        database = Database(**database_config)
+
+        # Load configuration using Database instance
+        self.loadConfigDatabase(database)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigDatabase(
         self,
         database: Database
@@ -426,6 +523,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate database type
         if not isinstance(database, Database):
             raise TypeError(f"Expected Database instance, got {type(database).__name__}")
@@ -436,6 +534,34 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configFilesystems(
+        self,
+        **filesystems_config
+    ) -> 'Application':
+        """
+        Configure the filesystems with various settings.
+
+        Parameters
+        ----------
+        **filesystems_config : dict
+            Configuration parameters for filesystems. Must match the fields
+            expected by the Filesystems dataclass (orionis.foundation.config.filesystems.entitites.filesystems.Filesystems).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Filesystems instance with provided parameters
+        filesystems = Filesystems(**filesystems_config)
+
+        # Load configuration using Filesystems instance
+        self.loadConfigFilesystems(filesystems)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigFilesystems(
         self,
         filesystems: Filesystems
@@ -453,6 +579,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate filesystems type
         if not isinstance(filesystems, Filesystems):
             raise TypeError(f"Expected Filesystems instance, got {type(filesystems).__name__}")
@@ -463,6 +590,34 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configLogging(
+        self,
+        **logging_config
+    ) -> 'Application':
+        """
+        Configure the logging system with various channel settings.
+
+        Parameters
+        ----------
+        **logging_config : dict
+            Configuration parameters for logging. Must match the fields
+            expected by the Logging dataclass (orionis.foundation.config.logging.entities.logging.Logging).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Logging instance with provided parameters
+        logging = Logging(**logging_config)
+
+        # Load configuration using Logging instance
+        self.loadConfigLogging(logging)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigLogging(
         self,
         logging: Logging
@@ -480,6 +635,7 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate logging type
         if not isinstance(logging, Logging):
             raise TypeError(f"Expected Logging instance, got {type(logging).__name__}")
@@ -490,6 +646,34 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def configMail(
+        self,
+        **mail_config
+    ) -> 'Application':
+        """
+        Configure the mail system with various settings.
+
+        Parameters
+        ----------
+        **mail_config : dict
+            Configuration parameters for mail. Must match the fields
+            expected by the Mail dataclass (orionis.foundation.config.mail.entities.mail.Mail).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Mail instance with provided parameters
+        mail = Mail(**mail_config)
+
+        # Load configuration using Mail instance
+        self.loadConfigMail(mail)
+
+        # Return the application instance for method chaining
+        return self
+
     def loadConfigMail(
         self,
         mail: Mail
@@ -507,14 +691,41 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate mail type
         if not isinstance(mail, Mail):
             raise TypeError(f"Expected Mail instance, got {type(mail).__name__}")
 
         # Store the configuration
-        self.__configurators.append({
-            'mail' : mail
-        })
+        self.__configurators['mail'] = mail
+
+        # Return the application instance for method chaining
+        return self
+
+    def configQueue(
+        self,
+        **queue_config
+    ) -> 'Application':
+        """
+        Configure the queue system with various settings.
+
+        Parameters
+        ----------
+        **queue_config : dict
+            Configuration parameters for queue. Must match the fields
+            expected by the Queue dataclass (orionis.foundation.config.queue.entities.queue.Queue).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Queue instance with provided parameters
+        queue = Queue(**queue_config)
+
+        # Load configuration using Queue instance
+        self.loadConfigQueue(queue)
 
         # Return the application instance for method chaining
         return self
@@ -536,14 +747,41 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate queue type
         if not isinstance(queue, Queue):
             raise TypeError(f"Expected Queue instance, got {type(queue).__name__}")
 
         # Store the configuration
-        self.__configurators.append({
-            'queue' : queue
-        })
+        self.__configurators['queue'] = queue
+
+        # Return the application instance for method chaining
+        return self
+
+    def configSession(
+        self,
+        **session_config
+    ) -> 'Application':
+        """
+        Configure the session with various settings.
+
+        Parameters
+        ----------
+        **session_config : dict
+            Configuration parameters for session. Must match the fields
+            expected by the Session dataclass (orionis.foundation.config.session.entities.session.Session).
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+
+        # Create Session instance with provided parameters
+        session = Session(**session_config)
+
+        # Load configuration using Session instance
+        self.loadConfigSession(session)
 
         # Return the application instance for method chaining
         return self
@@ -565,75 +803,71 @@ class Application(Container, IApplication):
         Application
             The application instance for method chaining
         """
+
         # Validate session type
         if not isinstance(session, Session):
             raise TypeError(f"Expected Session instance, got {type(session).__name__}")
 
         # Store the configuration
-        self.__configurators.append({
-            'session' : session
-        })
+        self.__configurators['session'] = session
 
         # Return the application instance for method chaining
         return self
 
-    def loadConfigTesting(
+    def configTesting(
         self,
-        testing: Testing
+        **testing_config
     ) -> 'Application':
         """
-        Load the application testing configuration from a Testing instance.
+        Configure the testing with various settings.
 
         Parameters
         ----------
-        testing : Testing
-            The Testing instance containing testing configuration
+        **testing_config : dict
+            Configuration parameters for testing. Must match the fields
+            expected by the Testing dataclass (orionis.foundation.config.testing.entities.testing.Testing).
 
         Returns
         -------
         Application
             The application instance for method chaining
         """
-        # Validate testing type
-        if not isinstance(testing, Testing):
-            raise TypeError(f"Expected Testing instance, got {type(testing).__name__}")
 
-        # Store the configuration
-        self.__configurators.append({
-            'testing' : testing
-        })
+        # Create Testing instance with provided parameters
+        testing = Testing(**testing_config)
+
+        # Load configuration using Testing instance
+        self.loadConfigTesting(testing)
 
         # Return the application instance for method chaining
         return self
 
-    def create(
-        self
+    def loadConfigTesting(
+        self,
+        testing: Testing
     ) -> 'Application':
         """
-        Bootstrap the application by loading providers and kernels.
+        Load the application testing configuration from a Testing instance.
+
+        Parameters
+        ----------
+        testing : Testing
+            The Testing instance containing testing configuration
 
         Returns
         -------
         Application
             The application instance for method chaining
         """
-        # Check if already booted
-        if not self.__booted:
-
-            # Load core framework components
-            self.__loadFrameworkProviders()
-            self.__loadFrameworksKernel()
 
-            # Register and boot all providers
-            self.__registerProviders()
-            self.__bootProviders()
-
-            # Load configuration if not already set
-            self.__loadConfig()
+        # Validate testing type
+        if not isinstance(testing, Testing):
+            raise TypeError(f"Expected Testing instance, got {type(testing).__name__}")
 
-            # Mark as booted
-            self.__booted = True
+        # Store the configuration
+        self.__configurators['testing'] = testing
 
+        # Return the application instance for method chaining
         return self
 
     def __loadConfig(
@@ -657,6 +891,8 @@ class Application(Container, IApplication):
                 # Initialize with default configuration
                 if not self.__configurators:
                     self.__config = Configuration().toDict()
+
+                # If configurators are provided, use them to create the configuration
                 else:
                     self.__config = Configuration(**self.__configurators).toDict()
 
@@ -665,6 +901,36 @@ class Application(Container, IApplication):
             # Handle any exceptions during configuration loading
             raise RuntimeError(f"Failed to load application configuration: {str(e)}")
 
+    def create(
+        self
+    ) -> 'Application':
+        """
+        Bootstrap the application by loading providers and kernels.
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
+        """
+        # Check if already booted
+        if not self.__booted:
+
+            # Load core framework components
+            self.__loadFrameworkProviders()
+            self.__loadFrameworksKernel()
+
+            # Register and boot all providers
+            self.__registerProviders()
+            self.__bootProviders()
+
+            # Load configuration if not already set
+            self.__loadConfig()
+
+            # Mark as booted
+            self.__booted = True
+
+        return self
+
     def config(
         self,
         key: str,
@@ -685,6 +951,11 @@ class Application(Container, IApplication):
         Any
             The configuration value or the entire configuration if key is None
         """
+
+        # Ensure the application is booted before accessing configuration
+        if not self.__booted:
+            raise RuntimeError("Application must be booted before accessing configuration. Call create() first.")
+
         # If key is None, raise an error to prevent ambiguity
         if key is None:
             raise ValueError("Key cannot be None. Use config() without arguments to get the entire configuration.")
@@ -697,10 +968,56 @@ class Application(Container, IApplication):
 
         # Traverse the config dictionary based on the key parts
         for part in parts:
+
+            # If part is not in config_value, return default
             if isinstance(config_value, dict) and part in config_value:
                 config_value = config_value[part]
+
+            # If part is not found, return default value
             else:
                 return default
 
         # Return the final configuration value
-        return config_value
+        return config_value
+
+    def path(
+        self,
+        key: str,
+        default: str = None
+    ) -> Path:
+        """
+        Retrieve a path configuration value by key.
+
+        Parameters
+        ----------
+        key : str
+            The path key to retrieve using dot notation (e.g. "paths.storage")
+        default : str, optional
+            Default value to return if key is not found
+
+        Returns
+        -------
+        Path
+            The path value as a Path object or None if not found
+        """
+
+        # Ensure the application is booted before accessing configuration
+        if not self.__booted:
+            raise RuntimeError("Application must be booted before accessing configuration. Call create() first.")
+
+        # If key is None, raise an error to prevent ambiguity
+        if key is None:
+            raise ValueError("Key cannot be None. Use path() without arguments to get the entire configuration.")
+
+        # Get the configuration value for the given key
+        original_paths = self.config('paths')
+
+        # If original_paths is not a dictionary, return the default value as Path
+        if not isinstance(original_paths, dict):
+            return Path(default) if default is not None else None
+
+        # Get the path value from the dictionary
+        path_value = original_paths.get(key, default)
+
+        # Return as Path object if value exists, otherwise return None
+        return Path(path_value) if path_value is not None else None

orionis/foundation/contracts/application.py

@@ -1,8 +1,8 @@
 from abc import abstractmethod
+from pathlib import Path
 from typing import Any, List, Type
 from orionis.container.contracts.service_provider import IServiceProvider
 from orionis.container.contracts.container import IContainer
-from orionis.foundation.config.startup import Configuration
 from orionis.foundation.config.app.entities.app import App
 from orionis.foundation.config.auth.entities.auth import Auth
 from orionis.foundation.config.cache.entities.cache import Cache
@@ -14,7 +14,6 @@ from orionis.foundation.config.mail.entities.mail import Mail
 from orionis.foundation.config.queue.entities.queue import Queue
 from orionis.foundation.config.session.entities.session import Session
 from orionis.foundation.config.testing.entities.testing import Testing
-from orionis.support.wrapper.dot_dict import DotDict
 
 class IApplication(IContainer):
     """
@@ -344,4 +343,225 @@ class IApplication(IContainer):
         Any
             The configuration value or the entire configuration if key is None
         """
+        pass
+
+    @abstractmethod
+    def configApp(self, **app_config) -> 'IApplication':
+        """
+        Configure the application with various settings.
+
+        Parameters
+        ----------
+        **app_config : dict
+            Configuration parameters for the application. Must match the fields
+            expected by the App dataclass (orionis.foundation.config.app.entities.app.App).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configAuth(self, **auth_config) -> 'IApplication':
+        """
+        Configure the authentication with various settings.
+
+        Parameters
+        ----------
+        **auth_config : dict
+            Configuration parameters for authentication. Must match the fields
+            expected by the Auth dataclass (orionis.foundation.config.auth.entities.auth.Auth).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configCache(self, **cache_config) -> 'IApplication':
+        """
+        Configure the cache with various settings.
+
+        Parameters
+        ----------
+        **cache_config : dict
+            Configuration parameters for cache. Must match the fields
+            expected by the Cache dataclass (orionis.foundation.config.cache.entities.cache.Cache).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configCors(self, **cors_config) -> 'IApplication':
+        """
+        Configure the CORS with various settings.
+
+        Parameters
+        ----------
+        **cors_config : dict
+            Configuration parameters for CORS. Must match the fields
+            expected by the Cors dataclass (orionis.foundation.config.cors.entities.cors.Cors).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configDatabase(self, **database_config) -> 'IApplication':
+        """
+        Configure the database with various settings.
+
+        Parameters
+        ----------
+        **database_config : dict
+            Configuration parameters for database. Must match the fields
+            expected by the Database dataclass (orionis.foundation.config.database.entities.database.Database).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configFilesystems(self, **filesystems_config) -> 'IApplication':
+        """
+        Configure the filesystems with various settings.
+
+        Parameters
+        ----------
+        **filesystems_config : dict
+            Configuration parameters for filesystems. Must match the fields
+            expected by the Filesystems dataclass (orionis.foundation.config.filesystems.entitites.filesystems.Filesystems).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configLogging(self, **logging_config) -> 'IApplication':
+        """
+        Configure the logging system with various channel settings.
+
+        Parameters
+        ----------
+        **logging_config : dict
+            Configuration parameters for logging. Must match the fields
+            expected by the Logging dataclass (orionis.foundation.config.logging.entities.logging.Logging).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configMail(self, **mail_config) -> 'IApplication':
+        """
+        Configure the mail system with various settings.
+
+        Parameters
+        ----------
+        **mail_config : dict
+            Configuration parameters for mail. Must match the fields
+            expected by the Mail dataclass (orionis.foundation.config.mail.entities.mail.Mail).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configQueue(self, **queue_config) -> 'IApplication':
+        """
+        Configure the queue system with various settings.
+
+        Parameters
+        ----------
+        **queue_config : dict
+            Configuration parameters for queue. Must match the fields
+            expected by the Queue dataclass (orionis.foundation.config.queue.entities.queue.Queue).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configSession(self, **session_config) -> 'IApplication':
+        """
+        Configure the session with various settings.
+
+        Parameters
+        ----------
+        **session_config : dict
+            Configuration parameters for session. Must match the fields
+            expected by the Session dataclass (orionis.foundation.config.session.entities.session.Session).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def configTesting(self, **testing_config) -> 'IApplication':
+        """
+        Configure the testing with various settings.
+
+        Parameters
+        ----------
+        **testing_config : dict
+            Configuration parameters for testing. Must match the fields
+            expected by the Testing dataclass (orionis.foundation.config.testing.entities.testing.Testing).
+
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
+
+    @abstractmethod
+    def path(
+        self,
+        key: str,
+        default: str = None
+    ) -> Path:
+        """
+        Retrieve a path configuration value by key.
+
+        Parameters
+        ----------
+        key : str
+            The path key to retrieve using dot notation (e.g. "paths.storage")
+        default : str, optional
+            Default value to return if key is not found
+
+        Returns
+        -------
+        Path
+            The path value as a Path object, or None if not found and no default is provided
+        """
         pass

orionis/metadata/framework.py

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

orionis/test/kernel.py

@@ -92,10 +92,19 @@ class TestKernel(ITestKernel):
         """
         # Check if config is None and kwargs are provided
         if config is None:
+
+            # Try to create a Configuration instance with provided kwargs or default values
             try:
-                # Attempt to create a Configuration instance with provided keyword arguments
-                config = Configuration(**kwargs)
+                # If no kwargs are provided, create a default Configuration instance
+                if not kwargs:
+                    config = Configuration(**self.__app.config('testing'))
+
+                # If kwargs are provided, create a Configuration instance with them
+                else:
+                    config = Configuration(**kwargs)
+
             except TypeError:
+
                 # If a TypeError occurs, it indicates that the provided arguments do not match the Configuration class
                 required_fields = []
                 for field in Configuration().getFields():

{orionis-0.392.0.dist-info → orionis-0.394.0.dist-info}/METADATA

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

{orionis-0.392.0.dist-info → orionis-0.394.0.dist-info}/RECORD

@@ -148,7 +148,7 @@ orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYq
 orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
 orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=KzwTNRNKTyFk60zM2YzX908OWpX2tZV49LWG-Ll73vQ,21962
+orionis/foundation/application.py,sha256=lYj2m2B9vbvSjBZtm44CJaM_xtIPEPiV2U_5HL4eonU,32208
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=zutF-34DkW68bpiTxH9xrmIe1iJdXCF9Y6wueXS6qys,8265
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -237,7 +237,7 @@ orionis/foundation/config/testing/entities/testing.py,sha256=keU7dSuRv0rgaG-T4Vo
 orionis/foundation/config/testing/enums/__init__.py,sha256=tCHed6wBzqHx8o3kWBGm8tZYkYOKdSAx8TvgC-Eauv0,75
 orionis/foundation/config/testing/enums/test_mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/foundation/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/contracts/application.py,sha256=rbR6sHgjcooIZGNYXtUGO5RLvG0c4iJxdhJ9PGfvycA,10011
+orionis/foundation/contracts/application.py,sha256=T8BexSV2k8QDcaAO4q_4mJrXaAdY-QIKq8XKGPYMPoI,16585
 orionis/foundation/contracts/config.py,sha256=Rpz6U6t8OXHO9JJKSTnCimytXE-tfCB-1ithP2nG8MQ,628
 orionis/foundation/exceptions/__init__.py,sha256=XtG3MJ_MFNY_dU5mmTyz_N_4QG1jYrcv5RegBso7wuY,163
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
@@ -249,7 +249,7 @@ orionis/foundation/providers/path_resolver_provider.py,sha256=rXvaVc5sSqmDgRzWJo
 orionis/foundation/providers/progress_bar_provider.py,sha256=75Jr4iEgUOUGl8Di1DioeP5_HRQlR-1lVzPmS96sWjA,737
 orionis/foundation/providers/workers_provider.py,sha256=WWlji3C69_-Y0c42aZDbR_bmcE_qZEh2SaA_cNkCivI,702
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=NisdW45j_SD6TAcLF8gMsFcBApFsBQUUIv-dK8eH5yc,4960
+orionis/metadata/framework.py,sha256=Wa85R4xbcnBwSXUKXco065QyqOUcMSzhdyD5-hPkfqk,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -351,7 +351,7 @@ orionis/support/standard/exceptions/value.py,sha256=7xry_TZz3k-BLAZTR_uDiQ0RfXOk
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
 orionis/support/wrapper/dot_dict.py,sha256=VdAUH-DO6y86pl_9N6v-vU9mdLraWh5HjVzI5iC1dMs,5295
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/kernel.py,sha256=_dzms3-5IuDNIE_JjaexwaoZhkHNvU-aAUEwOVtW8sc,13337
+orionis/test/kernel.py,sha256=HJiGGpMVtjVXL7s0LnFNNWHeLgNUWoe8L49KYtzresg,13650
 orionis/test/arguments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/arguments/parser.py,sha256=Oz09NCbQ9JrJgviiPJ92WbRa54rXWCsr6RDzPoh05vE,6019
 orionis/test/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -386,7 +386,7 @@ orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 orionis/test/records/logs.py,sha256=EOQcloMVdhlNl2lU9igQz8H4b-OtKtiwh2pgr_QZWOI,13186
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=zd7xDvVfmQ2HxZamDTzL2-z2PpyL99EaolbbM7wTah4,5014
-orionis-0.392.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.394.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/test_example.py,sha256=8G7kp74PZZ0Tdnw8WkheZ7lvZVFpdx_9ShOZBN9GEF0,25582
@@ -487,8 +487,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=nTNrvJkMSPx_aopEQ9
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=fnH7hjumNSErAFGITJgq2LHxSzvPF2tdtmHL9kyAv-Y,4409
 tests/testing/test_testing_unit.py,sha256=d3CRGo6608fMzYcZKIKapjx_af2aigqWiKSiuK9euIY,7600
-orionis-0.392.0.dist-info/METADATA,sha256=L0ZAamDSA8QCzLav3v6ap9XqDINAFWIC0Y0TTS7HLQk,4772
-orionis-0.392.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.392.0.dist-info/top_level.txt,sha256=udNmZ4TdfoC-7CBFJO7HLpWggpCM71okNNgNVzgpjt4,21
-orionis-0.392.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.392.0.dist-info/RECORD,,
+orionis-0.394.0.dist-info/METADATA,sha256=-oHteCguDB1_xuZQNBOPuDD2_22iUEUSLz85CBzevjg,4772
+orionis-0.394.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.394.0.dist-info/top_level.txt,sha256=udNmZ4TdfoC-7CBFJO7HLpWggpCM71okNNgNVzgpjt4,21
+orionis-0.394.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.394.0.dist-info/RECORD,,