orionis 0.497.0__tar.gz → 0.498.0__tar.gz

{orionis-0.497.0/orionis.egg-info → orionis-0.498.0}/PKG-INFO

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

{orionis-0.497.0 → orionis-0.498.0}/orionis/foundation/application.py

@@ -193,6 +193,7 @@ class Application(Container, IApplication):
         from orionis.foundation.providers.performance_counter_provider import PerformanceCounterProvider
         from orionis.foundation.providers.scheduler_provider import ScheduleProvider
         from orionis.foundation.providers.catch_provider import CathcProvider
+        from orionis.foundation.providers.directory_provider import DirectoryProvider
 
         # Core framework providers
         core_providers = [
@@ -207,7 +208,8 @@ class Application(Container, IApplication):
             ReactorProvider,
             PerformanceCounterProvider,
             ScheduleProvider,
-            CathcProvider
+            CathcProvider,
+            DirectoryProvider
         ]
 
         # Register each core provider
@@ -1401,6 +1403,7 @@ class Application(Container, IApplication):
         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()
     ) -> 'Application':
         """
         Set and resolve application directory paths using keyword arguments.
@@ -1505,7 +1508,8 @@ class Application(Container, IApplication):
             'logs' : str(logs),
             'sessions' : str(sessions),
             'cache' : str(cache),
-            'testing' : str(testing)
+            'testing' : str(testing),
+            'storage' : str(storage)
         }
 
         # Return self instance for method chaining

{orionis-0.497.0 → orionis-0.498.0}/orionis/foundation/config/roots/paths.py

@@ -230,6 +230,14 @@ class Paths(BaseEntity):
         }
     )
 
+    storage: str = field(
+        default_factory = lambda: str((Path.cwd() / 'storage').resolve()),
+        metadata = {
+            'description': 'Directory for application storage files.',
+            'default': lambda: str((Path.cwd() / 'storage').resolve())
+        }
+    )
+
     def __post_init__(self) -> None:
         """
         Post-initialization hook to validate path attributes.

orionis-0.498.0/orionis/foundation/providers/directory_provider.py

@@ -0,0 +1,55 @@
+from orionis.container.providers.service_provider import ServiceProvider
+from orionis.services.file.contracts.directory import IDirectory
+from orionis.services.file.directory import Directory
+
+class DirectoryProvider(ServiceProvider):
+    """
+    Service provider for registering the directory service in the application container.
+
+    This provider binds the `IDirectory` interface to its concrete implementation (`Directory`)
+    as a singleton. This ensures that a single shared instance of the directory service is
+    available for dependency injection throughout the application.
+
+    Attributes
+    ----------
+    app : Application
+        The application container instance where services are registered.
+
+    Methods
+    -------
+    register()
+        Registers the directory service as a singleton in the application container.
+    boot()
+        Performs post-registration actions if necessary.
+    """
+
+    def register(self) -> None:
+        """
+        Register the directory service as a singleton in the application container.
+
+        This method binds the `IDirectory` interface to the `Directory` implementation with
+        a specific alias. Only one instance of `Directory` will be created and shared
+        throughout the application's lifecycle.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        # Bind IDirectory to Directory as a singleton with a specific alias
+        self.app.singleton(IDirectory, Directory, alias="x-orionis.services.file.contracts.directory")
+
+    def boot(self) -> None:
+        """
+        Perform actions required after all providers have been registered.
+
+        This method is called after the `register` phase. It can be used for additional
+        initialization if needed. No additional boot logic is required for this provider.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+        # No additional boot logic required for this provider
+        pass

{orionis-0.497.0 → orionis-0.498.0}/orionis/metadata/framework.py

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

orionis-0.498.0/orionis/services/file/contracts/directory.py

@@ -0,0 +1,329 @@
+from abc import ABC, abstractmethod
+from pathlib import Path
+from orionis.foundation.contracts.application import IApplication
+
+class IDirectory(ABC):
+
+    @abstractmethod
+    def root(self) -> Path:
+        """
+        Get the root directory path of the application.
+
+        Returns
+        -------
+        Path
+            The path to the application's root directory.
+        """
+        pass
+
+    @abstractmethod
+    def commands(self) -> Path:
+        """
+        Get the commands directory path.
+
+        Returns
+        -------
+        Path
+            The path to the commands directory.
+        """
+        pass
+
+    @abstractmethod
+    def controllers(self) -> Path:
+        """
+        Get the controllers directory path.
+
+        Returns
+        -------
+        Path
+            The path to the controllers directory.
+        """
+        pass
+
+    @abstractmethod
+    def middleware(self) -> Path:
+        """
+        Get the middleware directory path.
+
+        Returns
+        -------
+        Path
+            The path to the middleware directory.
+        """
+        pass
+
+    @abstractmethod
+    def requests(self) -> Path:
+        """
+        Get the requests directory path.
+
+        Returns
+        -------
+        Path
+            The path to the requests directory.
+        """
+        pass
+
+    @abstractmethod
+    def models(self) -> Path:
+        """
+        Get the models directory path.
+
+        Returns
+        -------
+        Path
+            The path to the models directory.
+        """
+        pass
+
+    @abstractmethod
+    def providers(self) -> Path:
+        """
+        Get the providers directory path.
+
+        Returns
+        -------
+        Path
+            The path to the providers directory.
+        """
+        pass
+
+    @abstractmethod
+    def events(self) -> Path:
+        """
+        Get the events directory path.
+
+        Returns
+        -------
+        Path
+            The path to the events directory.
+        """
+        pass
+
+    @abstractmethod
+    def listeners(self) -> Path:
+        """
+        Get the listeners directory path.
+
+        Returns
+        -------
+        Path
+            The path to the listeners directory.
+        """
+        pass
+
+    @abstractmethod
+    def notifications(self) -> Path:
+        """
+        Get the notifications directory path.
+
+        Returns
+        -------
+        Path
+            The path to the notifications directory.
+        """
+        pass
+
+    @abstractmethod
+    def jobs(self) -> Path:
+        """
+        Get the jobs directory path.
+
+        Returns
+        -------
+        Path
+            The path to the jobs directory.
+        """
+        pass
+
+    @abstractmethod
+    def policies(self) -> Path:
+        """
+        Get the policies directory path.
+
+        Returns
+        -------
+        Path
+            The path to the policies directory.
+        """
+        pass
+
+    @abstractmethod
+    def exceptions(self) -> Path:
+        """
+        Get the exceptions directory path.
+
+        Returns
+        -------
+        Path
+            The path to the exceptions directory.
+        """
+        pass
+
+    @abstractmethod
+    def services(self) -> Path:
+        """
+        Get the services directory path.
+
+        Returns
+        -------
+        Path
+            The path to the services directory.
+        """
+        pass
+
+    @abstractmethod
+    def views(self) -> Path:
+        """
+        Get the views directory path.
+
+        Returns
+        -------
+        Path
+            The path to the views directory.
+        """
+        pass
+
+    @abstractmethod
+    def lang(self) -> Path:
+        """
+        Get the language files directory path.
+
+        Returns
+        -------
+        Path
+            The path to the language files directory.
+        """
+        pass
+
+    @abstractmethod
+    def assets(self) -> Path:
+        """
+        Get the assets directory path.
+
+        Returns
+        -------
+        Path
+            The path to the assets directory.
+        """
+        pass
+
+    @abstractmethod
+    def routes(self) -> Path:
+        """
+        Get the routes directory path.
+
+        Returns
+        -------
+        Path
+            The path to the routes directory.
+        """
+        pass
+
+    @abstractmethod
+    def config(self) -> Path:
+        """
+        Get the configuration directory path.
+
+        Returns
+        -------
+        Path
+            The path to the configuration directory.
+        """
+        pass
+
+    @abstractmethod
+    def migrations(self) -> Path:
+        """
+        Get the migrations directory path.
+
+        Returns
+        -------
+        Path
+            The path to the migrations directory.
+        """
+        pass
+
+    @abstractmethod
+    def seeders(self) -> Path:
+        """
+        Get the seeders directory path.
+
+        Returns
+        -------
+        Path
+            The path to the seeders directory.
+        """
+        pass
+
+    @abstractmethod
+    def factories(self) -> Path:
+        """
+        Get the factories directory path.
+
+        Returns
+        -------
+        Path
+            The path to the factories directory.
+        """
+        pass
+
+    @abstractmethod
+    def logs(self) -> Path:
+        """
+        Get the logs directory path.
+
+        Returns
+        -------
+        Path
+            The path to the logs directory.
+        """
+        pass
+
+    @abstractmethod
+    def sessions(self) -> Path:
+        """
+        Get the sessions directory path.
+
+        Returns
+        -------
+        Path
+            The path to the sessions directory.
+        """
+        pass
+
+    @abstractmethod
+    def cache(self) -> Path:
+        """
+        Get the cache directory path.
+
+        Returns
+        -------
+        Path
+            The path to the cache directory.
+        """
+        pass
+
+    @abstractmethod
+    def testing(self) -> Path:
+        """
+        Get the testing directory path.
+
+        Returns
+        -------
+        Path
+            The path to the testing directory.
+        """
+        pass
+
+    @abstractmethod
+    def storage(self) -> Path:
+        """
+        Get the storage directory path.
+
+        Returns
+        -------
+        Path
+            The path to the storage directory.
+        """
+        pass

{orionis-0.497.0 → orionis-0.498.0}/orionis/services/file/directory.py

@@ -1,7 +1,8 @@
 from pathlib import Path
 from orionis.foundation.contracts.application import IApplication
+from orionis.services.file.contracts.directory import IDirectory
 
-class Directory:
+class Directory(IDirectory):
     """
     Provides convenient access to various application directories.
 
@@ -309,4 +310,15 @@ class Directory:
         Path
             The path to the testing directory.
         """
-        return Path(self.__app.path('testing'))
+        return Path(self.__app.path('testing'))
+
+    def storage(self) -> Path:
+        """
+        Get the storage directory path.
+
+        Returns
+        -------
+        Path
+            The path to the storage directory.
+        """
+        return Path(self.__app.path('storage'))

{orionis-0.497.0 → orionis-0.498.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.497.0 → orionis-0.498.0}/orionis.egg-info/SOURCES.txt

@@ -216,6 +216,7 @@ orionis/foundation/exceptions/value.py
 orionis/foundation/providers/__init__.py
 orionis/foundation/providers/catch_provider.py
 orionis/foundation/providers/console_provider.py
+orionis/foundation/providers/directory_provider.py
 orionis/foundation/providers/dumper_provider.py
 orionis/foundation/providers/executor_provider.py
 orionis/foundation/providers/inspirational_provider.py
@@ -259,6 +260,8 @@ orionis/services/environment/validators/key_name.py
 orionis/services/environment/validators/types.py
 orionis/services/file/__init__.py
 orionis/services/file/directory.py
+orionis/services/file/contracts/__init__.py
+orionis/services/file/contracts/directory.py
 orionis/services/inspirational/__init__.py
 orionis/services/inspirational/inspire.py
 orionis/services/inspirational/quotes.py