orionis 0.327.0__py3-none-any.whl → 0.329.0__py3-none-any.whl

orionis/container/contracts/service_provider.py

@@ -0,0 +1,30 @@
+from abc import ABC, abstractmethod
+
+class IServiceProvider(ABC):
+
+    @abstractmethod
+    def register(self) -> None:
+        """
+        Register services into the application container.
+
+        This method must be implemented by all concrete service providers.
+        It should bind services, configurations, or other components
+        to the application container.
+
+        Raises
+        ------
+        NotImplementedError
+            If the method is not overridden in a subclass.
+        """
+        pass
+
+    @abstractmethod
+    def boot(self) -> None:
+        """
+        Perform any post-registration bootstrapping or initialization.
+
+        This method is called after all services have been registered.
+        Override this method to initialize services, set up event listeners,
+        or perform other boot-time operations.
+        """
+        pass

orionis/container/providers/service_provider.py

@@ -1,6 +1,7 @@
 from orionis.container.contracts.container import IContainer
+from orionis.container.contracts.service_provider import IServiceProvider
 
-class ServiceProvider:
+class ServiceProvider(IServiceProvider):
     """
     Base service provider class for the Orionis framework.
 

orionis/metadata/framework.py

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

{orionis-0.327.0.dist-info → orionis-0.329.0.dist-info}/METADATA

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

{orionis-0.327.0.dist-info → orionis-0.329.0.dist-info}/RECORD

@@ -60,19 +60,6 @@ orionis/_contracts/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm
 orionis/_contracts/services/log/log_service.py,sha256=1RD3u-a5ZDMbg7AYE8y2SW8QNRybAU3De0mEA0dAeNo,2167
 orionis/_contracts/support/exception_parse.py,sha256=P7yh5Q3KIcRPAZeg6190XbOSvu5XBK-VVt6zHxaiexw,779
 orionis/_contracts/support/reflection.py,sha256=Ht5_FsFbCb-APRXX3HdsfKl3cDZU8DyXGXPWKTn05uQ,8429
-orionis/_facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_facades/app_facade.py,sha256=4oVkGVlNoQ76nCt60CoX5oHDrFV0I5LYBNq2Iu__f9w,877
-orionis/_facades/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_facades/commands/commands_facade.py,sha256=3SgKq_oanNrzcXmIeVkiNcyYHtUaMti0c9XSCS0k74U,1564
-orionis/_facades/commands/scheduler_facade.py,sha256=iQqNQmxgOsOc2GRMs66xlUyukCOqGhHLkAiRmLrb3Q4,1437
-orionis/_facades/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_facades/config/config_facade.py,sha256=C5k9QAi1V8zaJUVkyPkVOlyUDVxlz__EJoSIwcUJMFQ,1358
-orionis/_facades/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_facades/environment/environment_facade.py,sha256=74PFjb2QomfSnAnM6nXXSypxNEd2fZK6HI96zNt7LdU,2096
-orionis/_facades/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_facades/files/path_facade.py,sha256=il10n3UmmHqwwBiRapaBAXjbNEoRwhtpeMogwBtYoss,9202
-orionis/_facades/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_facades/log/log_facade.py,sha256=TjbIoaXvhstj8SXyqmuLL_xm5IN65dBBAvS_UtbgWG0,683
 orionis/_foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_foundation/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_foundation/console/command_bootstrapper.py,sha256=y8gGKzTgbHHzUFFC6jwULx1zmZbNrlOKs8Org6Z1iNY,7039
@@ -85,19 +72,6 @@ orionis/_foundation/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCe
 orionis/_foundation/foundation/config/config_bootstrapper.py,sha256=Xml0S0oqPkUPwtEvs9hZ_A_FsOU5tlFJxUDGuTkD9do,7484
 orionis/_foundation/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_foundation/providers/service_providers_bootstrapper.py,sha256=V7Yd4_GCVW83jLFMsGUGfHNRsgfEnDywgAUkH50T270,4558
-orionis/_providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_providers/service_provider.py,sha256=mrxpzb2hhNTsgTYg2FHBaOStni-nq6CFG_nMkd_mOL4,1119
-orionis/_providers/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_providers/commands/reactor_commands_service_provider.py,sha256=MgYaWVkcm_4Pq9Rrqgw8iTBH2C4O25OAdO2VyNEN-Tw,1310
-orionis/_providers/commands/scheduler_provider.py,sha256=eGxOhR_mn8_Ti5RbtMW7BtNREjStkOIlZ0LmgsMguDg,461
-orionis/_providers/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_providers/config/config_service_provider.py,sha256=avsvHndUmvJrcdWL1j3FAQ_FTdNgMcMy8yRde0onRSk,442
-orionis/_providers/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_providers/environment/environment__service_provider.py,sha256=O9mLSUsWRqkEXCnsKyc9s7d2q7mUoo6IZRZZ11d-M7A,855
-orionis/_providers/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_providers/files/paths_provider.py,sha256=AiRoX0Gw0FKfvy-Sk2FMvx6hU_TnmN13eIg5R__sf2U,785
-orionis/_providers/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_providers/log/log_service_provider.py,sha256=EBJd_t7N1yFR5s3HXsX1B0FH_5uHnYfxaksCjBA0jEY,971
 orionis/_services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_services/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_services/commands/reactor_commands_service.py,sha256=cyARBmLVox8v-YHjo7XtbReJ00wJ4Oi3PMR2yX0duTM,6172
@@ -135,6 +109,7 @@ orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 orionis/container/context/manager.py,sha256=9yODWkHBoJ2kgJZ5ONLqcEcex50vaWuMcxsvmDgnQo4,2437
 orionis/container/context/scope.py,sha256=CWFiLLTAC_IdmeFKWX-jrphdxB0_TMEVBlz6lQVMPC8,937
 orionis/container/contracts/container.py,sha256=hOO3w2yqVhp2nPTeS1uJEYgXSTbM3xwezDCOSNMC_a0,7603
+orionis/container/contracts/service_provider.py,sha256=hXp-l4iP7q0FhsCcQAKoYcJ_zxCzIgTdfmO4F0Bbssg,896
 orionis/container/entities/binding.py,sha256=Qp6Lf4XUDp2NjqXDAC2lzvhOFQWiBDKiGFcKfwb4axw,4342
 orionis/container/enums/lifetimes.py,sha256=RqQmugMIB1Ev_j_vFLcWorndm-to7xg4stQ7yKFDdDw,190
 orionis/container/exceptions/attribute_error.py,sha256=ysYKvXfunH-bywK_e02inY94s8aZ3vUZA6jATbDcQmk,480
@@ -144,7 +119,7 @@ orionis/container/exceptions/value_exception.py,sha256=hjY0YEusoL3DurME1ornxvIv1
 orionis/container/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/facades/facade.py,sha256=vu71_uqXnSpCFyeswPgKIhTPmIBLEK3bsy5sk4vTOEk,3306
 orionis/container/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/providers/service_provider.py,sha256=rkrSxdNEi357aNs6MalOIy7-bNnb8E98fGhnBmE8GDs,1830
+orionis/container/providers/service_provider.py,sha256=9SHDzeuJbktRhrLq0zo2fZhRR4xOaYGOb2wKl7iBR4k,1923
 orionis/container/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/validators/implements.py,sha256=iSoDxxTalQKhyKjvsojFlkROhBFvAjvJxRvPJlmGrSg,2843
 orionis/container/validators/is_abstract_class.py,sha256=Q-Lqyrrps6oj2XWI0KFRp-hDZf4_sgbZlEbfBXj5XT4,1169
@@ -246,7 +221,7 @@ orionis/foundation/contracts/config.py,sha256=Rpz6U6t8OXHO9JJKSTnCimytXE-tfCB-1i
 orionis/foundation/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=3pSdy6bnr8_6wagciqStvz0g2gtRfgoH6E-JRTI5p-8,4960
+orionis/metadata/framework.py,sha256=6IMHwxMeJT3k5KRdt1d8bLgypdJAGfgmqwLUz5qzmGw,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/patterns/singleton/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -358,7 +333,7 @@ orionis/test/suite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuF
 orionis/test/suite/test_unit.py,sha256=MWgW8dRCRyT1XZ5LsbXQ7-KVPReasoXwzEEL1EWWfE4,52190
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=jXZkbITBknbUwm_mD8bcTiwLDvsFkrO9qrf0ZgPwqxc,4903
-orionis-0.327.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.329.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=kvWgiW3ADEZf718dGsMPtDh_rmOSx1ypEInKm7_6ZPQ,601
@@ -459,8 +434,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=yeVwl-VcwkWSQYyxZu
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=MrGK3ZimedL0b5Ydu69Dg8Iul017AzLTm7VPxpXlpfU,4315
 tests/testing/test_testing_unit.py,sha256=DjLBtvVn8B1KlVJNNkstBT8_csA1yeaMqnGrbanN_J4,7438
-orionis-0.327.0.dist-info/METADATA,sha256=GPE066gZMY-Rwse4II2FCF2LFnDbQQX81nenlgnP3DU,4772
-orionis-0.327.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.327.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.327.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.327.0.dist-info/RECORD,,
+orionis-0.329.0.dist-info/METADATA,sha256=XUCnPpXe0vygTWc_kwwC_IUsiWOVP4iXBDHdjlz1e5Y,4772
+orionis-0.329.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.329.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.329.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.329.0.dist-info/RECORD,,

orionis/_facades/app_facade.py

@@ -1,26 +0,0 @@
-from typing import Any
-from orionis._application import Application
-from orionis._container.resolve import Resolve
-
-def app(abstract: Any = None) -> Any:
-    """
-    Retrieve an instance from the application container.
-
-    Parameters
-    ----------
-    abstract : Any, optional
-        The abstract class or interface to resolve. If None, returns the application instance.
-
-    Returns
-    -------
-    Any
-        The resolved instance from the container if an abstract is provided,
-        otherwise the singleton instance of the application.
-    """
-
-    # If an abstract class or interface is provided, attempt to resolve it from the container
-    if abstract is not None:
-        return Resolve(abstract)
-
-    # If no abstract is provided, return the singleton instance of the application container
-    return Application.getInstance().container()

orionis/_facades/commands/commands_facade.py

@@ -1,42 +0,0 @@
-from typing import Any
-from orionis._contracts.facades.commands.commands_facade import ICommand
-from orionis._contracts.services.commands.reactor_commands_service import IReactorCommandsService
-from orionis._facades.app_facade import app
-
-class Command(ICommand):
-    """
-    Command class for managing and executing registered CLI commands.
-
-    This class provides a static method to invoke commands registered in the
-    `CacheCommands` singleton, passing the required signature and any additional
-    parameters.
-
-    Methods
-    -------
-    call(signature: str, vars: dict[str, Any] = {}, *args: Any, **kwargs: Any) -> Any
-        Executes the specified command with the provided arguments.
-    """
-
-    @staticmethod
-    def call(signature: str, vars: dict[str, Any] = {}, *args: Any, **kwargs: Any) -> Any:
-        """
-        Calls a registered command using the `CLIRunner`.
-
-        Parameters
-        ----------
-        signature : str
-            The command signature (name) to execute.
-        vars : dict[str, Any], optional
-            A dictionary containing named arguments for the command (default is `{}`).
-        *args : Any
-            Additional positional arguments.
-        **kwargs : Any
-            Additional keyword arguments.
-
-        Returns
-        -------
-        Any
-            The output of the executed command.
-        """
-        _commands_provider : IReactorCommandsService = app(IReactorCommandsService)
-        return _commands_provider.execute(signature, vars, *args, **kwargs)

orionis/_facades/commands/scheduler_facade.py

@@ -1,38 +0,0 @@
-from typing import Any
-from orionis._contracts.facades.commands.scheduler_facade import ISchedule
-from orionis._contracts.services.commands.schedule_service import IScheduleService
-from orionis._facades.app_facade import app
-
-class Schedule(ISchedule):
-
-    @staticmethod
-    def command(signature: str, vars: dict[str, Any] = {}, *args: Any, **kwargs: Any) -> 'IScheduleService':
-        """
-        Defines a Orionis command to be executed.
-
-        Parameters
-        ----------
-        signature : str
-            The signature of the command to execute.
-        vars : dict, optional
-            A dictionary of variables to pass to the command, by default an empty dictionary.
-        *args : Any
-            Additional positional arguments to pass to the command.
-        **kwargs : Any
-            Additional keyword arguments to pass to the command.
-
-        Returns
-        -------
-        Schedule
-            Returns the Schedule instance itself, allowing method chaining.
-        """
-        _scheduler_provider : IScheduleService = app(IScheduleService)
-        return _scheduler_provider.command(signature, vars, *args, **kwargs)
-
-    @staticmethod
-    def start():
-        """
-        Starts the scheduler and stops automatically when there are no more jobs.
-        """
-        _scheduler_provider : IScheduleService = app(IScheduleService)
-        return _scheduler_provider.start()

orionis/_facades/config/config_facade.py

@@ -1,41 +0,0 @@
-from typing import Any, Optional
-from orionis._contracts.facades.config.config_facade import IConfig
-from orionis._contracts.services.config.config_service import IConfigService
-from orionis._facades.app_facade import app
-
-class Config(IConfig):
-
-    @staticmethod
-    def set(key: str, value: Any) -> None:
-        """
-        Dynamically sets a configuration value using dot notation.
-
-        Parameters
-        ----------
-        key : str
-            The configuration key (e.g., 'app.debug').
-        value : Any
-            The value to set.
-        """
-        _config_service_provider : IConfigService = app(IConfigService)
-        return _config_service_provider.set(key, value)
-
-    @staticmethod
-    def get(key: str, default: Optional[Any] = None) -> Any:
-        """
-        Retrieves a configuration value using dot notation.
-
-        Parameters
-        ----------
-        key : str
-            The configuration key (e.g., 'app.debug').
-        default : Optional[Any]
-            The default value to return if the key is not found.
-
-        Returns
-        -------
-        Any
-            The configuration value or the default value if the key is not found.
-        """
-        _config_service_provider : IConfigService = app(IConfigService)
-        return _config_service_provider.get(key, default)

orionis/_facades/environment/environment_facade.py

@@ -1,68 +0,0 @@
-from orionis._contracts.facades.environment.environment_facade import IEnv
-from orionis._contracts.services.environment.environment_service import IEnvironmentService
-from orionis._facades.app_facade import app
-
-class Env(IEnv):
-
-    @staticmethod
-    def get(key: str, default=None) -> str:
-        """
-        Retrieves the value of an environment variable from the .env file
-        or from system environment variables if not found.
-
-        Parameters
-        ----------
-        key : str
-            The key of the environment variable.
-        default : optional
-            Default value if the key does not exist. Defaults to None.
-
-        Returns
-        -------
-        str
-            The value of the environment variable or the default value.
-        """
-
-        _env_service : IEnvironmentService = app(IEnvironmentService)
-        return _env_service.get(key, default)
-
-    @staticmethod
-    def set(key: str, value: str) -> None:
-        """
-        Sets the value of an environment variable in the .env file.
-
-        Parameters
-        ----------
-        key : str
-            The key of the environment variable.
-        value : str
-            The value to set.
-        """
-        _env_service : IEnvironmentService = app(IEnvironmentService)
-        return _env_service.set(key, value)
-
-    @staticmethod
-    def unset(key: str) -> None:
-        """
-        Removes an environment variable from the .env file.
-
-        Parameters
-        ----------
-        key : str
-            The key of the environment variable to remove.
-        """
-        _env_service : IEnvironmentService = app(IEnvironmentService)
-        return _env_service.unset(key)
-
-    @staticmethod
-    def all() -> dict:
-        """
-        Retrieves all environment variable values from the .env file.
-
-        Returns
-        -------
-        dict
-            A dictionary of all environment variables and their values.
-        """
-        _env_service : IEnvironmentService = app(IEnvironmentService)
-        return _env_service.all()

orionis/_facades/files/path_facade.py

@@ -1,311 +0,0 @@
-import os
-from orionis._contracts.facades.files.path_facade import IPath
-from orionis._contracts.services.files.path_resolver_service import IPathResolverService
-# from orionis._services.files.path_resolver_service import PathResolverService
-
-class Path(IPath):
-    """
-    A facade class for resolving absolute paths to various application directories.
-
-    This class provides static methods to resolve paths to common directories such as
-    'app', 'config', 'database', 'resources', 'routes', 'storage', and 'tests'.
-    It uses the `PathService` to resolve and validate paths.
-
-    Methods
-    -------
-    _resolve_directory(directory: str, file: str = None) -> SkeletonPath
-        Resolves the absolute path for a given directory and optional file.
-    app(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'app' directory.
-    config(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'config' directory.
-    database(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'database' directory.
-    resource(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'resource' directory.
-    routes(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'routes' directory.
-    storage(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'storage' directory.
-    tests(file: str = None) -> SkeletonPath
-        Returns the absolute path for a file inside the 'tests' directory.
-    """
-
-    @staticmethod
-    def _resolve_directory(directory: str, file: str = None):
-        """
-        Resolves the absolute path for a given directory and optional file.
-
-        This method constructs a path by joining the directory and file, normalizes it,
-        and resolves it using the `PathService`.
-
-        Parameters
-        ----------
-        directory : str
-            The base directory to resolve the path from.
-        file : str, optional
-            The relative file path inside the directory (default is None).
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved absolute path wrapped in a SkeletonPath object.
-
-        Raises
-        ------
-        ValueError
-            If the resolved path is invalid or cannot be resolved.
-        """
-        # Default to an empty string if None
-        file = file or ""
-
-        # Construct path safely
-        route = os.path.join(directory, file)
-
-        # Normalize path (removes redundant slashes)
-        route = os.path.normpath(route)
-
-        # Resolve path (Note: The service container is not used here)
-        path_resolver_service : None#IPathResolverService = PathResolverService()
-        return path_resolver_service.resolve(route)
-
-    @staticmethod
-    def app(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'app' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'app' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("app", file)
-
-    @staticmethod
-    def config(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'config' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'config' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("config", file)
-
-    @staticmethod
-    def database(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'database' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'database' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("database", file)
-
-    @staticmethod
-    def resource(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'resource' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'resource' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("resource", file)
-
-    @staticmethod
-    def routes(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'routes' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'routes' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("routes", file)
-
-    @staticmethod
-    def storage(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'storage' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'storage' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("storage", file)
-
-    @staticmethod
-    def tests(file: str = None):
-        """
-        Returns the absolute path for a file inside the 'tests' directory.
-
-        Parameters
-        ----------
-        file : str, optional
-            The relative file path inside the 'tests' directory.
-
-        Returns
-        -------
-        SkeletonPath
-            The resolved path wrapped in a SkeletonPath object.
-        """
-        return Path._resolve_directory("tests", file)
-
-
-# -------------- Functions --------------
-
-
-def app_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'app' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'app' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("app", file)
-
-
-def config_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'config' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'config' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("config", file)
-
-
-def database_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'database' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'database' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("database", file)
-
-
-def resource_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'resource' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'resource' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("resource", file)
-
-
-def routes_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'routes' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'routes' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("routes", file)
-
-
-def storage_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'storage' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'storage' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("storage", file)
-
-
-def tests_path(file: str = None):
-    """
-    Returns the absolute path for a file inside the 'tests' directory.
-
-    Parameters
-    ----------
-    file : str, optional
-        The relative file path inside the 'tests' directory.
-
-    Returns
-    -------
-    SkeletonPath
-        The resolved path wrapped in a SkeletonPath object.
-    """
-    return Path._resolve_directory("tests", file)

orionis/_facades/log/log_facade.py

@@ -1,16 +0,0 @@
-from orionis._contracts.facades.facade import Facade
-from orionis._contracts.services.log.log_service import ILogguerService
-
-class Log(Facade):
-    """
-    Log Facade class. This is the friendly interface for interacting with the logging service.
-    It's like the concierge of your application's logging system—always ready to help!
-    """
-
-    @classmethod
-    def getFacadeAccessor(cls):
-        """
-        Returns the service accessor for the logging system. In this case, it's the `ILogguerService`.
-        This is where the magic of the Facade pattern comes alive—connecting the interface to the actual service.
-        """
-        return ILogguerService

orionis/_providers/commands/reactor_commands_service_provider.py

@@ -1,30 +0,0 @@
-from orionis._contracts.services.commands.reactor_commands_service import IReactorCommandsService
-from orionis._contracts.services.config.config_service import IConfigService
-from orionis._contracts.services.log.log_service import ILogguerService
-from orionis._providers.service_provider import ServiceProvider
-from orionis._services.commands.reactor_commands_service import ReactorCommandsService
-from orionis._services.config.config_service import ConfigService
-from orionis._services.log.log_service import LogguerService
-
-class ReactorCommandsServiceProvider(ServiceProvider):
-
-    def register(self) -> None:
-        """
-        Registers services or bindings into the given container.
-        """
-        if not self.app.bound(IConfigService):
-            self.app.scoped(IConfigService, ConfigService)
-
-        if not self.app.bound(ILogguerService):
-            self.app.singleton(ILogguerService, LogguerService)
-
-        self.app.singleton(IReactorCommandsService, ReactorCommandsService)
-
-    async def boot(self) -> None:
-        """
-        Boot the service provider.
-
-        This method is intended to be overridden by subclasses to perform
-        any necessary bootstrapping or initialization tasks.
-        """
-        await self.app.make(IReactorCommandsService)

orionis/_providers/commands/scheduler_provider.py

@@ -1,11 +0,0 @@
-from orionis._contracts.services.commands.schedule_service import IScheduleService
-from orionis._providers.service_provider import ServiceProvider
-from orionis._services.commands.scheduler_service import ScheduleService
-
-class ScheduleServiceProvider(ServiceProvider):
-
-    def register(self) -> None:
-        """
-        Registers services or bindings into the given container.
-        """
-        self.app.scoped(IScheduleService, ScheduleService)

orionis/_providers/config/config_service_provider.py

@@ -1,11 +0,0 @@
-from orionis._contracts.services.config.config_service import IConfigService
-from orionis._providers.service_provider import ServiceProvider
-from orionis._services.config.config_service import ConfigService
-
-class ConfigServiceProvider(ServiceProvider):
-
-    def register(self) -> None:
-        """
-        Registers services or bindings into the given container.
-        """
-        self.app.scoped(IConfigService, ConfigService)

orionis/_providers/environment/environment__service_provider.py

@@ -1,21 +0,0 @@
-from orionis._contracts.services.environment.environment_service import IEnvironmentService
-from orionis._providers.service_provider import ServiceProvider
-from orionis._services.environment.environment_service import EnvironmentService
-from orionis._services.files.path_resolver_service import PathResolverService
-
-class EnvironmentServiceProvider(ServiceProvider):
-
-    def register(self) -> None:
-        """
-        Registers services or bindings into the given container.
-        """
-        self.app.singleton(IEnvironmentService, EnvironmentService)
-
-    async def boot(self) -> None:
-        """
-        Boot the service provider.
-
-        This method is intended to be overridden by subclasses to perform
-        any necessary bootstrapping or initialization tasks.
-        """
-        await self.app.make(IEnvironmentService)

orionis/_providers/files/paths_provider.py

@@ -1,21 +0,0 @@
-from orionis._contracts.services.files.path_resolver_service import IPathResolverService
-from orionis._providers.service_provider import ServiceProvider
-# from orionis._services.files.path_resolver_service import PathResolverService
-
-class PathResolverProvider(ServiceProvider):
-
-    def register(self) -> None:
-        """
-        Registers services or bindings into the given container.
-        """
-        pass
-        # self.app.singleton(IPathResolverService, PathResolverService)
-
-    async def boot(self) -> None:
-        """
-        Boot the service provider.
-
-        This method is intended to be overridden by subclasses to perform
-        any necessary bootstrapping or initialization tasks.
-        """
-        await self.app.make(IPathResolverService)

orionis/_providers/log/log_service_provider.py

@@ -1,25 +0,0 @@
-from orionis._contracts.services.config.config_service import IConfigService
-from orionis._contracts.services.log.log_service import ILogguerService
-from orionis._providers.service_provider import ServiceProvider
-from orionis._services.config.config_service import ConfigService
-from orionis._services.log.log_service import LogguerService
-
-class LogServiceProvider(ServiceProvider):
-
-    def register(self) -> None:
-        """
-        Registers services or bindings into the given container.
-        """
-        if not self.app.bound(IConfigService):
-            self.app.scoped(IConfigService, ConfigService)
-
-        self.app.singleton(ILogguerService, LogguerService)
-
-    async def boot(self) -> None:
-        """
-        Boot the service provider.
-
-        This method is intended to be overridden by subclasses to perform
-        any necessary bootstrapping or initialization tasks.
-        """
-        await self.app.make(ILogguerService)

orionis/_providers/service_provider.py

@@ -1,37 +0,0 @@
-from orionis._contracts.container.container import IContainer
-from orionis._contracts.providers.service_provider import IServiceProvider
-
-class ServiceProvider(IServiceProvider):
-    """
-    Base class for service providers.
-
-    Parameters
-    ----------
-    container : Container
-        The container instance to be used by the service provider.
-    """
-
-    def __init__(self, app : IContainer) -> None:
-        """
-        Initialize the service provider with the given container.
-
-        Parameters
-        ----------
-        container : Container
-            The container instance to be used by the service provider.
-        """
-        self.app = app
-
-    def register(self) -> None:
-        """
-        Register services in the container.
-
-        This method should be overridden in the subclass to register
-        specific services.
-
-        Parameters
-        ----------
-        container : Container
-            The container instance where services will be registered.
-        """
-        raise NotImplementedError("This method should be overridden in the subclass")