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

orionis/app.py

@@ -1,19 +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:
     """
-    Creates and returns the main Orionis application instance.
+    Initializes and returns the main Orionis application instance.
 
-    This function initializes the core application object that implements the `IApplication` interface.
-    It serves as the primary entry point for creating and accessing the main application instance,
-    ensuring that the application is properly set up before use.
+    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
-        An instance of `Application` that implements the `IApplication` interface, representing
-        the main Orionis application.
+        The initialized `Application` instance implementing the `IApplication` interface,
+        configured with the provided base path.
     """
 
     # Instantiate the main application object implementing IApplication
-    return Application()
+    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

@@ -689,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.507.0"
+VERSION = "0.508.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.507.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.507.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=bRZo4WbTXf9UidNc09Pm-kn1pIO9Hj86xCEJ-rpz2wQ,742
+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=SyO8m9qw5P8E60zJ1WCitc9llvEaWkT2CLPrkDIBIq0,31610
+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=fFR8Cs3ZS8FjoV9AhPPcw-3A_6DGHTpumC7OCWp-mGo,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.507.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.507.0.dist-info/METADATA,sha256=jTF7G9c5k9OZectyJLiq480nITd4_ccGQwDRRet0dnQ,4801
-orionis-0.507.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.507.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.507.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.507.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,,