orionis 0.506.0__tar.gz → 0.508.0__tar.gz

{orionis-0.506.0/orionis.egg-info → orionis-0.508.0}/PKG-INFO

@@ -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.508.0/orionis/app.py

@@ -0,0 +1,28 @@
+from pathlib import Path
+from orionis.foundation.application import Application, IApplication
+
+def Orionis(basePath: str | Path = Path.cwd().resolve()) -> IApplication:
+    """
+    Initializes and returns the main Orionis 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,
+        configured with the provided base path.
+    """
+
+    # 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-0.506.0 → orionis-0.508.0}/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-0.506.0 → orionis-0.508.0}/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-0.506.0 → orionis-0.508.0}/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 → orionis-0.508.0/orionis.egg-info}/PKG-INFO

@@ -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 → orionis-0.508.0}/setup.py

@@ -55,6 +55,9 @@ setup(
     packages=find_packages(
         exclude=[
             'app',
+            'bootstrap',
+            'config',
+            'database'
             'storage',
             'tests'
         ]

orionis-0.506.0/orionis/app.py

@@ -1,17 +0,0 @@
-from orionis.foundation.application import Application, IApplication
-
-def Orionis() -> IApplication:
-    """
-    Initialize and return 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.
-
-    Returns
-    -------
-    IApplication
-        The initialized application instance implementing the `IApplication` interface.
-    """
-
-    # Instantiate and return the main application object
-    return Application()