orionis 0.329.0__tar.gz → 0.330.0__tar.gz

{orionis-0.329.0/orionis.egg-info → orionis-0.330.0}/PKG-INFO

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

{orionis-0.329.0 → orionis-0.330.0}/orionis/container/validators/implements.py

@@ -51,9 +51,8 @@ class _ImplementsAbstractMethods:
 
         not_implemented = []
         for method in abstract_methods:
-            # Considera métodos renombrados en clases concretas (_Abstract.m → _Concrete.m)
             expected_method = str(method).replace(f"_{abstract_name}", f"_{target_name}")
-            if not hasattr(target, expected_method):
+            if not expected_method in target_class.__dict__:
                 not_implemented.append(method)
 
         if not_implemented:

{orionis-0.329.0 → orionis-0.330.0}/orionis/container/validators/is_valid_alias.py

@@ -22,6 +22,11 @@ class _IsValidAlias:
         OrionisContainerTypeError
             If the value is not of type str or contains invalid characters.
         """
+        if value is None or value == "" or str(value).isspace():
+            raise OrionisContainerTypeError(
+                "Alias cannot be None, empty, or whitespace only."
+            )
+
         if not isinstance(value, str):
             raise OrionisContainerTypeError(
                 f"Expected a string type for alias, but got {type(value).__name__} instead."

orionis-0.330.0/orionis/foundation/application.py

@@ -0,0 +1,145 @@
+from typing import Type, List
+from orionis.container.container import Container
+from orionis.container.contracts.service_provider import IServiceProvider
+
+class App(Container):
+    """
+    Application container that manages service providers.
+
+    This class extends the base Container functionality by adding
+    a service provider registration and boot system.
+
+    Attributes
+    ----------
+    __providers : List[IServiceProvider]
+        List of registered service providers
+    __booted : bool
+        Flag indicating whether providers have been booted
+    """
+    @property
+    def isBooted(self) -> bool:
+        """
+        Check if the application providers have been booted.
+
+        Returns
+        -------
+        bool
+            True if providers are booted, False otherwise
+        """
+        return self.__booted
+
+    def __init__(self) -> None:
+        """
+        Initialize a new App instance.
+
+        Sets up the container and initializes the provider tracking system.
+        """
+        super().__init__()
+        self.__providers: List[IServiceProvider] = []
+        self.__booted: bool = False
+
+    def __registerProvider(
+        self,
+        provider_cls: Type[IServiceProvider]
+    ) -> IServiceProvider:
+        """
+        Register a service provider with the application.
+
+        Parameters
+        ----------
+        provider_cls : Type[IServiceProvider]
+            The service provider class to register
+
+        Returns
+        -------
+        IServiceProvider
+            The instantiated provider
+
+        Raises
+        ------
+        TypeError
+            If the provided class doesn't implement IServiceProvider
+        """
+        if not issubclass(provider_cls, IServiceProvider):
+            raise TypeError(f"Provider must implement IServiceProvider interface: {provider_cls.__name__}")
+
+        provider = provider_cls(self)
+        provider.register()
+        self.__providers.append(provider)
+        return provider
+
+    def __bootProviders(self) -> None:
+        """
+        Boot all registered service providers.
+
+        This method is idempotent - calling it multiple times will only
+        boot the providers once.
+
+        Raises
+        ------
+        TypeError
+            If any registered provider is not an instance of IServiceProvider
+        """
+        if self.__booted:
+            return
+
+        for provider in self.__providers:
+            if not isinstance(provider, IServiceProvider):
+                raise TypeError(f"Expected IServiceProvider, got {type(provider).__name__}")
+            provider.boot()
+
+        self.__booted = True
+
+    def __loadFrameworkProviders(self) -> None:
+        """
+        Load internal framework service providers.
+
+        This method should register core services required by the framework
+        before user-defined providers are loaded.
+        """
+        core_providers = [
+            #...
+        ]
+
+        for provider_cls in core_providers:
+            self.__registerProvider(provider_cls)
+
+
+    def load(self, providers: List[Type[IServiceProvider]]) -> None:
+        """
+        Load and boot a list of service providers.
+
+        This method registers each provider and then boots all providers.
+
+        Parameters
+        ----------
+        providers : List[Type[IServiceProvider]]
+            List of service provider classes to register and boot
+
+        Returns
+        -------
+        None
+        """
+
+        # Load internal framework providers first
+        self.__loadFrameworkProviders()
+
+        # Register and boot each provided service provider
+        for provider_cls in providers:
+            self.__registerProvider(provider_cls)
+
+        # Boot all registered providers
+        self.__bootProviders()
+
+    def getProviders(self) -> List[IServiceProvider]:
+        """
+        Get the list of registered providers.
+
+        Returns
+        -------
+        List[IServiceProvider]
+            The list of registered service providers
+        """
+
+        # Return a copy to prevent external modification
+        return self.__providers.copy()

orionis-0.330.0/orionis/foundation/exceptions/value_error.py

@@ -0,0 +1,19 @@
+class OrionisValueError(ValueError):
+
+    def __init__(self, msg: str):
+        """
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
+        """
+        return str(self.args[0])

{orionis-0.329.0 → orionis-0.330.0}/orionis/metadata/framework.py

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

{orionis-0.329.0 → orionis-0.330.0}/orionis/services/introspection/concretes/reflection_concrete.py

@@ -69,10 +69,14 @@ class ReflectionConcrete(IReflectionConcrete):
         if not isinstance(concrete, type):
             raise ReflectionTypeError(f"Expected a class type, got instance of '{type(concrete).__name__}'.")
 
-        # Optionally, check for ABCMeta to catch interfaces
+        # Check for ABC inheritance to catch interfaces
         if abc.ABC in concrete.__bases__:
             raise ReflectionValueError(f"Class '{concrete.__name__}' is an interface and cannot be used.")
 
+        # Check if the class has any abstract methods
+        if inspect.isabstract(concrete):
+            raise ReflectionValueError(f"Class '{concrete.__name__}' is an abstract class and cannot be used.")
+
         return True
 
     def __init__(self, concrete: Type) -> None:

{orionis-0.329.0 → orionis-0.330.0}/orionis/test/test_suite.py

@@ -1,6 +1,5 @@
 import re
 from os import walk
-from dataclasses import fields
 from orionis.foundation.config.testing.entities.testing import Testing as Configuration
 from orionis.test.exceptions.test_config_exception import OrionisTestConfigException
 from orionis.test.suite.test_unit import UnitTest

{orionis-0.329.0 → orionis-0.330.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.329.0 → orionis-0.330.0}/orionis.egg-info/SOURCES.txt

@@ -3,8 +3,6 @@ MANIFEST.in
 README.md
 setup.py
 orionis/__init__.py
-orionis/_application.py
-orionis/application.py
 orionis/unittesting.py
 orionis.egg-info/PKG-INFO
 orionis.egg-info/SOURCES.txt
@@ -27,8 +25,6 @@ orionis/_contracts/console/output/__init__.py
 orionis/_contracts/console/output/console.py
 orionis/_contracts/console/output/executor.py
 orionis/_contracts/console/output/progress_bar.py
-orionis/_contracts/container/container.py
-orionis/_contracts/container/container_integrity.py
 orionis/_contracts/facades/__init__.py
 orionis/_contracts/facades/facade.py
 orionis/_contracts/facades/commands/__init__.py
@@ -88,8 +84,6 @@ orionis/_services/commands/reactor_commands_service.py
 orionis/_services/commands/scheduler_service.py
 orionis/_services/config/__init__.py
 orionis/_services/config/config_service.py
-orionis/_services/log/__init__.py
-orionis/_services/log/log_service.py
 orionis/console/__init__.py
 orionis/console/command_filter.py
 orionis/console/kernel.py
@@ -141,6 +135,7 @@ orionis/container/validators/is_subclass.py
 orionis/container/validators/is_valid_alias.py
 orionis/container/validators/lifetime.py
 orionis/foundation/__init__.py
+orionis/foundation/application.py
 orionis/foundation/config/__init__.py
 orionis/foundation/config/startup.py
 orionis/foundation/config/app/__init__.py
@@ -230,6 +225,7 @@ orionis/foundation/contracts/__init__.py
 orionis/foundation/contracts/config.py
 orionis/foundation/exceptions/__init__.py
 orionis/foundation/exceptions/integrity.py
+orionis/foundation/exceptions/value_error.py
 orionis/metadata/__init__.py
 orionis/metadata/framework.py
 orionis/metadata/package.py
@@ -282,6 +278,8 @@ orionis/services/introspection/instances/__init__.py
 orionis/services/introspection/instances/reflection_instance.py
 orionis/services/introspection/modules/__init__.py
 orionis/services/introspection/modules/reflection_module.py
+orionis/services/log/__init__.py
+orionis/services/log/log_service.py
 orionis/services/parsers/__init__.py
 orionis/services/parsers/serializer.py
 orionis/services/parsers/contracts/__init__.py

orionis-0.329.0/orionis/_application.py

@@ -1,232 +0,0 @@
-from typing import Dict, List, Type
-from orionis._contracts.application import IApplication
-from orionis._contracts.container.container import IContainer
-from orionis._contracts.foundation.bootstraper import IBootstrapper
-from orionis._contracts.providers.service_provider import IServiceProvider
-from orionis._container.container import Container
-# from orionis._foundation.config.config_bootstrapper import ConfigBootstrapper
-from orionis._foundation.console.command_bootstrapper import CommandsBootstrapper
-from orionis._foundation.environment.environment_bootstrapper import EnvironmentBootstrapper
-from orionis._foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
-from orionis._foundation.providers.service_providers_bootstrapper import ServiceProvidersBootstrapper
-# from orionis.support.patterns.singleton import SingletonMeta
-
-class Application:
-    """
-    Main application class that follows the Singleton pattern.
-
-    This class manages service providers, environment variables, configurations,
-    and commands for the application lifecycle.
-
-    Attributes
-    ----------
-    _booted : bool
-        Indicates whether the application has been booted.
-    _custom_providers : List[Type[IServiceProvider]]
-        Custom service providers defined by the developer.
-    _service_providers : List[Type[IServiceProvider]]
-        Core application service providers.
-    _config : Dict
-        Configuration settings of the application.
-    _commands : Dict
-        Registered console commands.
-    _env : Dict
-        Environment variables.
-    _container : IContainer
-        The service container instance.
-    """
-
-    _booted: bool = False
-
-    def __init__(self):
-        """
-        Initializes the application by setting up the service container and preparing
-        lists for custom service providers, service providers, configuration, commands,
-        and environment variables.
-        Attributes:
-            _custom_providers (List[Type[IServiceProvider]]): List to store custom service providers.
-            _service_providers (List[Type[IServiceProvider]]): List to store service providers.
-            _config (Dict): Dictionary to store configuration settings.
-            _commands (Dict): Dictionary to store commands.
-            _env (Dict): Dictionary to store environment variables.
-            _container (IContainer): The service container instance.
-        Registers the application instance in the service container.
-        """
-        self._custom_providers: List[Type[IServiceProvider]] = []
-        self._service_providers: List[Type[IServiceProvider]] = []
-        self._config: Dict = {}
-        self._commands: Dict = {}
-        self._env: Dict = {}
-        self._container: IContainer = Container()
-
-        # Register the application instance in the service container
-        self._container.instance(IApplication, self)
-
-    @classmethod
-    def boot(cls) -> None:
-        """
-        Marks the application as booted by setting the _booted class attribute to True.
-        """
-        cls._booted = True
-
-    @classmethod
-    def isRunning(cls) -> bool:
-        """
-        Checks if the application has been booted.
-
-        Returns
-        -------
-        bool
-            True if the application has been booted, otherwise False.
-        """
-        return cls._booted
-
-    @classmethod
-    def getInstance(cls) -> "Application":
-        """
-        Retrieves the singleton instance of the Application.
-
-        Returns
-        -------
-        Application
-            The current application instance.
-
-        Raises
-        ------
-        RuntimeError
-            If the application instance does not exist.
-        """
-        pass
-        # if cls not in SingletonMeta._instances:
-        #     raise RuntimeError("Application instance does not exist. Please create an instance first.")
-        # return SingletonMeta._instances[cls]
-
-    @classmethod
-    def destroy(cls) -> None:
-        """
-        Destroys the singleton instance of the application if it exists.
-
-        This method checks if the class has an instance in the SingletonMeta
-        instances dictionary and deletes it if found.
-
-        Returns
-        -------
-        None
-        """
-        pass
-        # if cls in SingletonMeta._instances:
-        #     del SingletonMeta._instances[cls]
-
-    def withProviders(self, providers: List[Type[IServiceProvider]] = None) -> "Application":
-        """
-        This method allows you to specify a list of custom service providers
-        that will be used by the application. If no providers are specified,
-        an empty list will be used by default.
-            A list of service provider classes to be used by the application.
-            If not provided, defaults to an empty list.
-        Returns
-        -------
-        Application
-            The instance of the Application with the custom service providers set.
-        """
-        self._custom_providers = providers or []
-        return self
-
-    def container(self) -> IContainer:
-        """
-        Returns the service container instance.
-
-        Returns
-        -------
-        IContainer
-            The service container.
-        """
-        return self._container
-
-    def create(self) -> None:
-        """
-        Initializes and boots the application.
-        This method performs the following steps:
-        1. Boots the application by calling the `_bootstrapping` method.
-        2. Loads commands and service providers by calling the `_loadCommands` method.
-        3. Boots service providers asynchronously using `AsyncExecutor.run` on the `_bootServiceProviders` method.
-        4. Changes the application status to booted by calling `Application.boot`.
-        Returns
-        -------
-        None
-        """
-        self._bootstrapping()
-        self._loadCommands()
-        # AsyncExecutor.run(self._bootServiceProviders())
-        Application.boot()
-
-    async def _bootServiceProviders(self) -> None:
-        """
-        This method iterates over all registered service providers, registers them,
-        and calls their `boot` method if it exists and is callable.
-        Raises
-        ------
-        RuntimeError
-            If an error occurs while booting a service provider, a RuntimeError is raised
-            with a message indicating which service provider failed and the original exception.
-        """
-        for service in self._service_providers:
-            provider: IServiceProvider = service(app=self._container)
-            provider.register()
-
-            if hasattr(provider, 'boot') and callable(provider.boot):
-                try:
-                    await provider.boot()
-                except Exception as e:
-                    raise RuntimeError(f"Error booting service provider {service.__name__}: {e}") from e
-
-    def _bootstrapping(self) -> None:
-        """
-        Initializes and loads essential components for the application.
-        This method sets up the environment variables, configurations, commands,
-        and service providers by utilizing their respective bootstrappers. It
-        iterates through a list of bootstrappers, updating or extending the
-        corresponding properties with the data provided by each bootstrapper.
-        Raises
-        ------
-        BootstrapRuntimeError
-            If an error occurs during the bootstrapping process, an exception is
-            raised with details about the specific bootstrapper that failed.
-        """
-        bootstrappers = [
-            {'property': self._env, 'instance': EnvironmentBootstrapper()},
-            # {'property': self._config, 'instance': ConfigBootstrapper()},
-            {'property': self._commands, 'instance': CommandsBootstrapper()},
-            {'property': self._service_providers, 'instance': ServiceProvidersBootstrapper(self._custom_providers)},
-        ]
-
-        for bootstrapper in bootstrappers:
-            try:
-                property_ref: Dict = bootstrapper["property"]
-                bootstrapper_instance: IBootstrapper = bootstrapper["instance"]
-                if isinstance(property_ref, dict):
-                    property_ref.update(bootstrapper_instance.get())
-                elif isinstance(property_ref, list):
-                    property_ref.extend(bootstrapper_instance.get())
-                else:
-                    property_ref = bootstrapper_instance.get()
-            except Exception as e:
-                raise BootstrapRuntimeError(f"Error bootstrapping {type(bootstrapper_instance).__name__}: {str(e)}") from e
-
-    def _loadCommands(self) -> None:
-        """
-        This method iterates over the `_commands` dictionary and registers each command
-        in the service container as a transient service. The command's signature and
-        concrete implementation are retrieved from the dictionary and passed to the
-        container's `transient` method.
-
-        Parameters
-        ----------
-        None
-
-        Returns
-        -------
-        None
-        """
-        for command, data_command in self._commands.items():
-            self._container.transient(data_command.get('signature'), data_command.get('concrete'))