orionis 0.506.0__py3-none-any.whl → 0.508.0__py3-none-any.whl

orionis/app.py

@@ -1,17 +1,28 @@
+from pathlib import Path
 from orionis.foundation.application import Application, IApplication
 
-def Orionis() -> IApplication:
+def Orionis(basePath: str | Path = Path.cwd().resolve()) -> IApplication:
     """
-    Initialize and return the main Orionis application instance.
+    Initializes and returns the main Orionis application instance.
 
-    Initializes the core application object that implements the `IApplication` interface.
-    This function acts as the entry point for creating and accessing the main application instance.
+    This function creates the core application object that implements the `IApplication` interface.
+    It acts as the primary entry point for setting up and accessing the main application instance,
+    ensuring that the application is initialized with the specified base path.
+
+    Parameters
+    ----------
+    basePath : str or Path, optional
+        The base directory path for the application. Defaults to the current working directory.
 
     Returns
     -------
     IApplication
-        The initialized application instance implementing the `IApplication` interface.
+        The initialized `Application` instance implementing the `IApplication` interface,
+        configured with the provided base path.
     """
 
-    # Instantiate and return the main application object
-    return Application()
+    # Instantiate the main application object implementing IApplication
+    app: IApplication = Application()
+
+    # Set the base path for the application and return the configured instance
+    return app.setBasePath(basePath)

orionis/foundation/application.py

@@ -123,6 +123,9 @@ class Application(Container, IApplication):
             # Property to store the exception handler class
             self.__exception_handler: Type[BaseExceptionHandler] = None
 
+            # Base path for the application, used for relative paths
+            self.__bootstrap_base_path: str | Path = None
+
             # Flag to prevent re-initialization
             self.__initialized = True
 
@@ -1377,7 +1380,6 @@ class Application(Container, IApplication):
     def setPaths(
         self,
         *,
-        root: str | Path = Path.cwd().resolve(),
         commands: str | Path = (Path.cwd() / 'app' / 'console' / 'commands').resolve(),
         controllers: str | Path = (Path.cwd() / 'app' / 'http' / 'controllers').resolve(),
         middleware: str | Path = (Path.cwd() / 'app' / 'http' / 'middleware').resolve(),
@@ -1415,8 +1417,6 @@ class Application(Container, IApplication):
 
         Parameters
         ----------
-        root : str or Path, optional
-            Root directory of the application. Defaults to the current working directory.
         commands : str or Path, optional
             Directory for console command classes. Defaults to 'app/console/commands'.
         controllers : str or Path, optional
@@ -1483,7 +1483,7 @@ class Application(Container, IApplication):
         # Prepare and store all resolved paths as strings in the configurators dictionary
         # Ensure 'paths' exists in configurators
         self.__configurators['path'] = {
-            'root' : str(root),
+            'root' : self.__bootstrap_base_path or str(Path.cwd().resolve()),
             'commands' : str(commands),
             'controllers' : str(controllers),
             'middleware' : str(middleware),
@@ -1555,6 +1555,9 @@ class Application(Container, IApplication):
 
         # If paths is a dict, convert it to Paths instance
         if isinstance(paths, dict):
+            paths.update({
+                'root': self.__bootstrap_base_path or str(Path.cwd().resolve())
+            })
             paths = Paths(**paths)
 
         # Store the configuration
@@ -1563,6 +1566,52 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
+    def setBasePath(
+        self,
+        basePath: str | Path
+    ) -> 'Application':
+        """
+        Set the base path for the application.
+
+        This method allows setting the base path of the application, which is
+        used as the root directory for all relative paths in the application.
+        The provided basePath is resolved to an absolute path.
+
+        Parameters
+        ----------
+        basePath : str or Path
+            The base path to set for the application. It can be a string or a Path object.
+
+        Returns
+        -------
+        Application
+            The current application instance to enable method chaining.
+        """
+
+        # Resolve and store the base path as a string
+        self.__bootstrap_base_path = str(Path(basePath).resolve())
+
+        # Return self instance for method chaining
+        return self
+
+    def getBasePath(
+        self
+    ) -> str | Path:
+        """
+        Get the base path of the application.
+
+        This method returns the base path that was previously set using setBasePath().
+        If no base path has been set, it returns None.
+
+        Returns
+        -------
+        str or Path
+            The base path of the application as a string or Path object, or None if not set.
+        """
+
+        # Return the base path if set, otherwise None
+        return self.__bootstrap_base_path if self.__bootstrap_base_path else Path.cwd().resolve()
+
     def setConfigQueue(
         self,
         **queue_config

orionis/foundation/contracts/application.py

@@ -567,11 +567,11 @@ class IApplication(IContainer):
     def setPaths(
         self,
         *,
-        console_scheduler: str | Path = (Path.cwd() / 'app' / 'console' / 'kernel.py').resolve(),
-        console_commands: str | Path = (Path.cwd() / 'app' / 'console' / 'commands').resolve(),
-        http_controllers: str | Path = (Path.cwd() / 'app' / 'http' / 'controllers').resolve(),
-        http_middleware: str | Path = (Path.cwd() / 'app' / 'http' / 'middleware').resolve(),
-        http_requests: str | Path = (Path.cwd() / 'app' / 'http' / 'requests').resolve(),
+        root: str | Path = Path.cwd().resolve(),
+        commands: str | Path = (Path.cwd() / 'app' / 'console' / 'commands').resolve(),
+        controllers: str | Path = (Path.cwd() / 'app' / 'http' / 'controllers').resolve(),
+        middleware: str | Path = (Path.cwd() / 'app' / 'http' / 'middleware').resolve(),
+        requests: str | Path = (Path.cwd() / 'app' / 'http' / 'requests').resolve(),
         models: str | Path = (Path.cwd() / 'app' / 'models').resolve(),
         providers: str | Path = (Path.cwd() / 'app' / 'providers').resolve(),
         events: str | Path = (Path.cwd() / 'app' / 'events').resolve(),
@@ -584,95 +584,90 @@ class IApplication(IContainer):
         views: str | Path = (Path.cwd() / 'resources' / 'views').resolve(),
         lang: str | Path = (Path.cwd() / 'resources' / 'lang').resolve(),
         assets: str | Path = (Path.cwd() / 'resources' / 'assets').resolve(),
-        routes_web: str | Path = (Path.cwd() / 'routes' / 'web.py').resolve(),
-        routes_api: str | Path = (Path.cwd() / 'routes' / 'api.py').resolve(),
-        routes_console: str | Path = (Path.cwd() / 'routes' / 'console.py').resolve(),
-        routes_channels: str | Path = (Path.cwd() / 'routes' / 'channels.py').resolve(),
+        routes: str | Path = (Path.cwd() / 'routes').resolve(),
         config: str | Path = (Path.cwd() / 'config').resolve(),
         migrations: str | Path = (Path.cwd() / 'database' / 'migrations').resolve(),
         seeders: str | Path = (Path.cwd() / 'database' / 'seeders').resolve(),
         factories: str | Path = (Path.cwd() / 'database' / 'factories').resolve(),
-        storage_logs: str | Path = (Path.cwd() / 'storage' / 'logs').resolve(),
-        storage_framework: str | Path = (Path.cwd() / 'storage' / 'framework').resolve(),
-        storage_sessions: str | Path = (Path.cwd() / 'storage' / 'framework' / 'sessions').resolve(),
-        storage_cache: str | Path = (Path.cwd() / 'storage' / 'framework' / 'cache').resolve(),
-        storage_views: str | Path = (Path.cwd() / 'storage' / 'framework' / 'views').resolve(),
+        logs: str | Path = (Path.cwd() / 'storage' / 'logs').resolve(),
+        sessions: str | Path = (Path.cwd() / 'storage' / 'framework' / 'sessions').resolve(),
+        cache: str | Path = (Path.cwd() / 'storage' / 'framework' / 'cache').resolve(),
+        testing: str | Path = (Path.cwd() / 'storage' / 'framework' / 'testing').resolve(),
+        storage: str | Path = (Path.cwd() / 'storage').resolve()
     ) -> 'IApplication':
         """
-        Configure application directory paths using keyword arguments.
-
-        This method allows setting custom paths for various application directories
-        including controllers, models, views, storage locations, and other framework
-        components. All parameters are keyword-only and have sensible defaults based
-        on common MVC framework conventions.
-
-        Parameters
-        ----------
-        console_scheduler : str | Path, optional
-            Path to the console kernel scheduler file.
-        console_commands : str | Path, optional
-            Directory path for console command classes.
-        http_controllers : str | Path, optional
-            Directory path for HTTP controller classes.
-        http_middleware : str | Path, optional
-            Directory path for HTTP middleware classes.
-        http_requests : str | Path, optional
-            Directory path for HTTP request classes.
-        models : str | Path, optional
-            Directory path for model classes.
-        providers : str | Path, optional
-            Directory path for service provider classes.
-        events : str | Path, optional
-            Directory path for event classes.
-        listeners : str | Path, optional
-            Directory path for event listener classes.
-        notifications : str | Path, optional
-            Directory path for notification classes.
-        jobs : str | Path, optional
-            Directory path for job classes.
-        policies : str | Path, optional
-            Directory path for authorization policy classes.
-        exceptions : str | Path, optional
-            Directory path for custom exception classes.
-        services : str | Path, optional
-            Directory path for service classes.
-        views : str | Path, optional
-            Directory path for view templates.
-        lang : str | Path, optional
-            Directory path for language localization files.
-        assets : str | Path, optional
-            Directory path for static assets.
-        routes_web : str | Path, optional
-            File path for web routes definition.
-        routes_api : str | Path, optional
-            File path for API routes definition.
-        routes_console : str | Path, optional
-            File path for console routes definition.
-        routes_channels : str | Path, optional
-            File path for channel routes definition.
-        config : str | Path, optional
-            Directory path for configuration files.
-        migrations : str | Path, optional
-            Directory path for database migration files.
-        seeders : str | Path, optional
-            Directory path for database seeder files.
-        factories : str | Path, optional
-            Directory path for model factory files.
-        storage_logs : str | Path, optional
-            Directory path for log files.
-        storage_framework : str | Path, optional
-            Directory path for framework storage files.
-        storage_sessions : str | Path, optional
-            Directory path for session storage files.
-        storage_cache : str | Path, optional
-            Directory path for cache storage files.
-        storage_views : str | Path, optional
-            Directory path for compiled view cache files.
+        Set and resolve application directory paths using keyword arguments.
+
+        This method allows customization of all major application directory paths, such as
+        console components, HTTP components, application layers, resources, routes,
+        database files, and storage locations. All provided paths are resolved to absolute
+        paths and stored as strings in the configuration dictionary.
+
+        Parameters
+        ----------
+        root : str or Path, optional
+            Root directory of the application. Defaults to the current working directory.
+        commands : str or Path, optional
+            Directory for console command classes. Defaults to 'app/console/commands'.
+        controllers : str or Path, optional
+            Directory for HTTP controller classes. Defaults to 'app/http/controllers'.
+        middleware : str or Path, optional
+            Directory for HTTP middleware classes. Defaults to 'app/http/middleware'.
+        requests : str or Path, optional
+            Directory for HTTP request classes. Defaults to 'app/http/requests'.
+        models : str or Path, optional
+            Directory for data model classes. Defaults to 'app/models'.
+        providers : str or Path, optional
+            Directory for service provider classes. Defaults to 'app/providers'.
+        events : str or Path, optional
+            Directory for event classes. Defaults to 'app/events'.
+        listeners : str or Path, optional
+            Directory for event listener classes. Defaults to 'app/listeners'.
+        notifications : str or Path, optional
+            Directory for notification classes. Defaults to 'app/notifications'.
+        jobs : str or Path, optional
+            Directory for queue job classes. Defaults to 'app/jobs'.
+        policies : str or Path, optional
+            Directory for authorization policy classes. Defaults to 'app/policies'.
+        exceptions : str or Path, optional
+            Directory for custom exception classes. Defaults to 'app/exceptions'.
+        services : str or Path, optional
+            Directory for application service classes. Defaults to 'app/services'.
+        views : str or Path, optional
+            Directory for view templates. Defaults to 'resources/views'.
+        lang : str or Path, optional
+            Directory for language files. Defaults to 'resources/lang'.
+        assets : str or Path, optional
+            Directory for asset files. Defaults to 'resources/assets'.
+        routes : str or Path, optional
+            Directory for route definitions. Defaults to 'routes'.
+        config : str or Path, optional
+            Directory for configuration files. Defaults to 'config'.
+        migrations : str or Path, optional
+            Directory for database migration files. Defaults to 'database/migrations'.
+        seeders : str or Path, optional
+            Directory for database seeder files. Defaults to 'database/seeders'.
+        factories : str or Path, optional
+            Directory for model factory files. Defaults to 'database/factories'.
+        logs : str or Path, optional
+            Directory for log file storage. Defaults to 'storage/logs'.
+        sessions : str or Path, optional
+            Directory for session file storage. Defaults to 'storage/framework/sessions'.
+        cache : str or Path, optional
+            Directory for cache file storage. Defaults to 'storage/framework/cache'.
+        testing : str or Path, optional
+            Directory for testing file storage. Defaults to 'storage/framework/testing'.
 
         Returns
         -------
-        IApplication
-            The application instance to enable method chaining.
+        Application
+            Returns the current Application instance to enable method chaining.
+
+        Notes
+        -----
+        All path parameters accept either string or Path objects and are automatically
+        resolved to absolute paths relative to the current working directory. The
+        resolved paths are stored as strings in the internal configuration dictionary.
         """
         pass
 
@@ -694,6 +689,47 @@ class IApplication(IContainer):
         """
         pass
 
+    @abstractmethod
+    def setBasePath(
+        self,
+        basePath: str | Path
+    ) -> 'IApplication':
+        """
+        Set the base path for the application.
+
+        This method allows setting the base path of the application, which is
+        used as the root directory for all relative paths in the application.
+        The provided basePath is resolved to an absolute path.
+
+        Parameters
+        ----------
+        basePath : str or Path
+            The base path to set for the application. It can be a string or a Path object.
+
+        Returns
+        -------
+        Application
+            The current application instance to enable method chaining.
+        """
+        pass
+
+    @abstractmethod
+    def getBasePath(
+        self
+    ) -> str | Path:
+        """
+        Get the base path of the application.
+
+        This method returns the base path that was previously set using setBasePath().
+        If no base path has been set, it returns None.
+
+        Returns
+        -------
+        str or Path
+            The base path of the application as a string or Path object, or None if not set.
+        """
+        pass
+
     @abstractmethod
     def setConfigQueue(self, **queue_config) -> 'IApplication':
         """

orionis/metadata/framework.py

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

{orionis-0.506.0.dist-info → orionis-0.508.0.dist-info}/METADATA

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

{orionis-0.506.0.dist-info → orionis-0.508.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/app.py,sha256=b69fOzj2J8Aw5g0IldWZXixUDeeTO9vcHc_Njses9HU,603
+orionis/app.py,sha256=foCcJAfebeZD69wsAiNvPUx_7UMK6w8ow5WpVjzwDDk,1131
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/kernel.py,sha256=m4RoulZB3nkl6-O250UDN4ZoXqfTF4F5gbAYt7TAnQo,3054
 orionis/console/args/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -103,7 +103,7 @@ orionis/failure/contracts/handler.py,sha256=4N9yMkMgdhtHbRGAyCtuTx3GmkPP74vhqdRL
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=ogys062uhim5QMYU62ezlnumRAnYQlUf_vZvQY47S3U,1227
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=tcOqqw49TNIKh7CJGWT2wghPeRPmYcY20KtOSMX89LU,82200
+orionis/foundation/application.py,sha256=4fkbnb2r7rfyn0_0JIX-wG-hRZzRVLQySWO7v4a_4e0,83797
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=vbzduprRCNyYeR2nnMaqc1uKXw6PTzAY2jVfXNQKN8I,9691
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -197,7 +197,7 @@ orionis/foundation/config/testing/enums/drivers.py,sha256=mwv47FcKDXEOxydQXAGtkd
 orionis/foundation/config/testing/enums/mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/foundation/config/testing/enums/verbosity.py,sha256=Z-FQ6C3rxbRwP8HoVibbgRMGcsen2SwTuEy3wnjdIhc,486
 orionis/foundation/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/contracts/application.py,sha256=vLf7ozmdBY3F6pPQipecwo_JbvHshq3jTD4D8YqPy7c,31407
+orionis/foundation/contracts/application.py,sha256=lkNaToQgQzYC3lBYac5XWUdHkQ4JjLFJziLyVd0-0Os,32799
 orionis/foundation/contracts/config.py,sha256=mCyA43f0n_e-CEL0f-sWWgE-M7GicS_aEtC_TNbn_yc,802
 orionis/foundation/exceptions/__init__.py,sha256=q6we1N8kcd6j6GjUJY30WQhhHnqF9RXA0c6-ksEztlc,294
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
@@ -219,7 +219,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=72SoixFog9IOE9Ve9Xcfw6
 orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
 orionis/foundation/providers/workers_provider.py,sha256=oa_2NIDH6UxZrtuGkkoo_zEoNIMGgJ46vg5CCgAm7wI,3926
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=7GDE1vlKx7t9nOHv-ZfHJT1aRtbeCDfcrHCCN_WVg_Y,4109
+orionis/metadata/framework.py,sha256=GNS8mR9V6h1ZD3jGhE00vpi8iNnnlj9RbnbY5z40m6k,4109
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -395,7 +395,7 @@ orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNu
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
-orionis-0.506.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.508.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/test_manager.py,sha256=wOwXpl9rHNfTTexa9GBKYMwK0_-KSQPbI-AEyGNkmAE,1356
@@ -541,8 +541,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=WPo5GxTP6xE-Dw3X1vZoqOMpb6HhokjNSbgDsDRDvy4,16588
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=tnnMBwS0iKUIbogLvu-7Rii50G6Koddp3XT4wgdFEYM,1050
-orionis-0.506.0.dist-info/METADATA,sha256=92B0xXn_6oSt7vqPcFDegLTan4m-sLF3SAYX9uSi3VY,4801
-orionis-0.506.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.506.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.506.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.506.0.dist-info/RECORD,,
+orionis-0.508.0.dist-info/METADATA,sha256=WL4EpLqD1RIInFU5wamNzYAGOSHdSHE1V1qqXQEBfe8,4801
+orionis-0.508.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.508.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.508.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.508.0.dist-info/RECORD,,