orionis 0.326.0__tar.gz → 0.328.0__tar.gz

{orionis-0.326.0/orionis.egg-info → orionis-0.328.0}/PKG-INFO

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

orionis-0.328.0/orionis/container/providers/service_provider.py

@@ -0,0 +1,56 @@
+from orionis.container.contracts.container import IContainer
+
+class ServiceProvider:
+    """
+    Base service provider class for the Orionis framework.
+
+    This class serves as a base for all service providers in the application.
+    Service providers are responsible for registering components and services
+    into the application container, and initializing them when needed.
+
+    Parameters
+    ----------
+    app : IContainer
+        The application container instance to which services will be registered.
+
+    Notes
+    -----
+    All concrete service providers should inherit from this class and implement
+    the `register` method at minimum.
+    """
+
+    def __init__(self, app: IContainer) -> None:
+        """
+        Initialize the service provider with the application container.
+
+        Parameters
+        ----------
+        app : IContainer
+            The application container instance.
+        """
+        self.app = app
+
+    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.
+        """
+        raise NotImplementedError("This method should be overridden in the subclass")
+
+    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-0.326.0 → orionis-0.328.0}/orionis/metadata/framework.py

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

{orionis-0.326.0 → orionis-0.328.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.326.0 → orionis-0.328.0}/orionis.egg-info/SOURCES.txt

@@ -70,19 +70,6 @@ orionis/_contracts/services/log/__init__.py
 orionis/_contracts/services/log/log_service.py
 orionis/_contracts/support/exception_parse.py
 orionis/_contracts/support/reflection.py
-orionis/_facades/__init__.py
-orionis/_facades/app_facade.py
-orionis/_facades/commands/__init__.py
-orionis/_facades/commands/commands_facade.py
-orionis/_facades/commands/scheduler_facade.py
-orionis/_facades/config/__init__.py
-orionis/_facades/config/config_facade.py
-orionis/_facades/environment/__init__.py
-orionis/_facades/environment/environment_facade.py
-orionis/_facades/files/__init__.py
-orionis/_facades/files/path_facade.py
-orionis/_facades/log/__init__.py
-orionis/_facades/log/log_facade.py
 orionis/_foundation/__init__.py
 orionis/_foundation/console/__init__.py
 orionis/_foundation/console/command_bootstrapper.py
@@ -95,19 +82,6 @@ orionis/_foundation/foundation/config/__init__.py
 orionis/_foundation/foundation/config/config_bootstrapper.py
 orionis/_foundation/providers/__init__.py
 orionis/_foundation/providers/service_providers_bootstrapper.py
-orionis/_providers/__init__.py
-orionis/_providers/service_provider.py
-orionis/_providers/commands/__init__.py
-orionis/_providers/commands/reactor_commands_service_provider.py
-orionis/_providers/commands/scheduler_provider.py
-orionis/_providers/config/__init__.py
-orionis/_providers/config/config_service_provider.py
-orionis/_providers/environment/__init__.py
-orionis/_providers/environment/environment__service_provider.py
-orionis/_providers/files/__init__.py
-orionis/_providers/files/paths_provider.py
-orionis/_providers/log/__init__.py
-orionis/_providers/log/log_service_provider.py
 orionis/_services/__init__.py
 orionis/_services/commands/__init__.py
 orionis/_services/commands/reactor_commands_service.py
@@ -153,6 +127,8 @@ orionis/container/exceptions/type_error_exception.py
 orionis/container/exceptions/value_exception.py
 orionis/container/facades/__init__.py
 orionis/container/facades/facade.py
+orionis/container/providers/__init__.py
+orionis/container/providers/service_provider.py
 orionis/container/validators/__init__.py
 orionis/container/validators/implements.py
 orionis/container/validators/is_abstract_class.py

orionis-0.326.0/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-0.326.0/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-0.326.0/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-0.326.0/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-0.326.0/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-0.326.0/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-0.326.0/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