orionis 0.312.0__py3-none-any.whl → 0.313.0__py3-none-any.whl

orionis/container/container.py

@@ -1,12 +1,29 @@
 from typing import Any, Callable
 from orionis.container.enums.lifetimes import Lifetime
+from orionis.container.exceptions.container_exception import OrionisContainerException
 from orionis.container.exceptions.type_error_exception import OrionisContainerTypeError
 from orionis.services.introspection.abstract.reflection_abstract import ReflectionAbstract
+from orionis.services.introspection.concretes.reflection_concrete import ReflectionConcrete
 
 
 class Container:
 
-    def transient(self, abstract: Callable[..., Any], concrete: Callable[..., Any]) -> None:
+    def bind(self, abstract: Callable[..., Any] = None, concrete: Callable[..., Any] = None, lifetime: str = Lifetime.TRANSIENT) -> None:
+        """
+        Binds an abstract type to a concrete implementation with a specified lifetime.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or alias to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        lifetime : str, optional
+            The lifetime of the service (default is 'transient').
+        """
+        pass
+
+    def transient(self, abstract: Callable[..., Any], concrete: Callable[..., Any]) -> bool:
         """
         Registers a service with a transient lifetime.
 
@@ -17,8 +34,90 @@ class Container:
         concrete : Callable[..., Any]
             The concrete implementation to associate with the abstract type.
         """
+        # Ensure that abstract is an abstract class and concrete is a concrete class
+        try:
+            ReflectionAbstract.ensureIsAbstractClass(abstract)
+            ReflectionConcrete.ensureIsConcreteClass(concrete)
+        except Exception as e:
+            raise OrionisContainerTypeError(
+                f"Unexpected error registering transient service: {e}"
+            ) from e
+
+        # Ensure that concrete does NOT inherit from abstract
+        if issubclass(concrete, abstract):
+            raise OrionisContainerException(
+                "Cannot register a concrete class that is a subclass of the provided abstract class. "
+                "Please ensure that the concrete class does not inherit from the specified abstract class."
+            )
+
+        # Register the service with transient lifetime
+        self.bind(abstract, concrete, Lifetime.TRANSIENT)
+
+        # Return True to indicate successful registration
+        return True
+
+    def singleton(self, abstract: Callable[..., Any], concrete: Callable[..., Any]) -> bool:
+        """
+        Registers a service with a singleton lifetime.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or alias to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        """
+        # Ensure that abstract is an abstract class and concrete is a concrete class
+        try:
+            ReflectionAbstract.ensureIsAbstractClass(abstract)
+            ReflectionConcrete.ensureIsConcreteClass(concrete)
+        except Exception as e:
+            raise OrionisContainerTypeError(
+                f"Unexpected error registering singleton service: {e}"
+            ) from e
+
+        # Ensure that concrete does NOT inherit from abstract
+        if issubclass(concrete, abstract):
+            raise OrionisContainerException(
+                "Cannot register a concrete class that is a subclass of the provided abstract class. "
+                "Please ensure that the concrete class does not inherit from the specified abstract class."
+            )
+
+        # Register the service with singleton lifetime
+        self.bind(abstract, concrete, Lifetime.SINGLETON)
+
+        # Return True to indicate successful registration
+        return True
+
+    def scoped(self, abstract: Callable[..., Any], concrete: Callable[..., Any]) -> bool:
+        """
+        Registers a service with a scoped lifetime.
 
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or alias to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        """
+        # Ensure that abstract is an abstract class and concrete is a concrete class
         try:
             ReflectionAbstract.ensureIsAbstractClass(abstract)
+            ReflectionConcrete.ensureIsConcreteClass(concrete)
         except Exception as e:
-            raise OrionisContainerTypeError(f"Type error while registering service: {e}")
+            raise OrionisContainerTypeError(
+                f"Unexpected error registering scoped service: {e}"
+            ) from e
+
+        # Ensure that concrete does NOT inherit from abstract
+        if issubclass(concrete, abstract):
+            raise OrionisContainerException(
+                "Cannot register a concrete class that is a subclass of the provided abstract class. "
+                "Please ensure that the concrete class does not inherit from the specified abstract class."
+            )
+
+        # Register the service with scoped lifetime
+        self.bind(abstract, concrete, Lifetime.SCOPED)
+
+        # Return True to indicate successful registration
+        return True

orionis/container/exceptions/container_exception.py

@@ -1,17 +1,19 @@
 class OrionisContainerException(Exception):
-    """
-    Excepción personalizada para errores relacionados con el contenedor de inyección de dependencias Orionis.
-    """
 
-    def __init__(self, message: str) -> None:
+    def __init__(self, msg: str):
         """
-        Inicializa la excepción con un mensaje de error.
-
-        Args:
-            message (str): Mensaje descriptivo del error.
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
         """
-        super().__init__(message)
+        super().__init__(msg)
 
     def __str__(self) -> str:
-        """Retorna una representación en cadena de la excepción."""
-        return f"[OrionisContainerException] {self.args[0]}"
+        """
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
+        """
+        return str(self.args[0])

orionis/container/exceptions/type_error_exception.py

@@ -14,6 +14,6 @@ class OrionisContainerTypeError(TypeError):
         Returns
         -------
         str
-            Formatted string describing the exception, including the exception name and error message.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/container/exceptions/value_exception.py

@@ -1,17 +1,19 @@
 class OrionisContainerValueError(ValueError):
-    """
-    Excepción personalizada para errores de tipo ValueError en el contenedor Orionis.
-    """
 
-    def __init__(self, message: str) -> None:
+    def __init__(self, msg: str):
         """
-        Inicializa la excepción con un mensaje de error.
-
-        Args:
-            message (str): Mensaje descriptivo del error.
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
         """
-        super().__init__(message)
+        super().__init__(msg)
 
     def __str__(self) -> str:
-        """Retorna una representación en cadena de la excepción."""
-        return f"[OrionisContainerValueError] {self.args[0]}"
+        """
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
+        """
+        return str(self.args[0])

orionis/metadata/framework.py

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

orionis/services/introspection/abstract/reflection_abstract.py

@@ -13,7 +13,24 @@ from orionis.services.introspection.exceptions.reflection_value_error import Ref
 class ReflectionAbstract(IReflectionAbstract):
 
     @staticmethod
-    def ensureIsAbstractClass(abstract: Type):
+    def isAbstractClass(abstract: Type) -> bool:
+        """
+        Checks if the provided object is an abstract base class (interface).
+
+        Parameters
+        ----------
+        abstract : Type
+            The class to check.
+
+        Returns
+        -------
+        bool
+            True if 'abstract' is an abstract base class, False otherwise.
+        """
+        return isinstance(abstract, type) and bool(getattr(abstract, '__abstractmethods__', False)) and ABC in abstract.__bases__
+
+    @staticmethod
+    def ensureIsAbstractClass(abstract: Type) -> bool:
         """
         Ensures that the provided object is an abstract base class (interface) and directly inherits from ABC.
 
@@ -27,7 +44,6 @@ class ReflectionAbstract(IReflectionAbstract):
         ReflectionTypeError
             If 'abstract' is not a class type, not an abstract base class, or does not directly inherit from ABC.
         """
-
         if not isinstance(abstract, type):
             raise ReflectionTypeError(f"Expected a class type for 'abstract', got {type(abstract).__name__!r}")
         if not bool(getattr(abstract, '__abstractmethods__', False)):

orionis/services/introspection/concretes/reflection_concrete.py

@@ -14,14 +14,35 @@ from orionis.services.introspection.instances.reflection_instance import Reflect
 
 class ReflectionConcrete(IReflectionConcrete):
 
-    def __init__(self, concrete: Type) -> None:
+    @staticmethod
+    def isConcreteClass(concrete: Type) -> bool:
         """
-        Initialize the ReflectionConcrete with the provided class type.
+        Checks if the provided concrete type is a valid ReflectionConcrete type.
 
         Parameters
         ----------
         concrete : Type
-            The class type to be reflected upon.
+            The class type to be validated.
+
+        Returns
+        -------
+        bool
+            True if the class is a valid ReflectionConcrete type, False otherwise.
+        """
+        try:
+            return ReflectionConcrete.ensureIsConcreteClass(concrete)
+        except (ReflectionTypeError, ReflectionValueError):
+            return False
+
+    @staticmethod
+    def ensureIsConcreteClass(concrete: Type) -> bool:
+        """
+        Ensures that the provided concrete type is a valid ReflectionConcrete type.
+
+        Parameters
+        ----------
+        concrete : Type
+            The class type to be validated.
 
         Raises
         ------
@@ -29,35 +50,57 @@ class ReflectionConcrete(IReflectionConcrete):
             If the provided argument is not a class type or is already an instance.
         ReflectionValueError
             If the provided class is a built-in/primitive type, abstract class, or interface.
-
-        Notes
-        -----
-        - Built-in and primitive types (e.g., int, str, list) are not allowed.
-        - Abstract classes and interfaces (classes with abstract methods) are not allowed.
         """
+        # Check if the concrete is a class type
         if not isinstance(concrete, type):
             raise ReflectionTypeError(f"Expected a class, got {type(concrete)}")
 
+        # Define a set of built-in and primitive types
         builtin_types = {
             int, float, str, bool, bytes, type(None), complex,
             list, tuple, dict, set, frozenset
         }
 
+        # Check if the concrete class is a built-in or primitive type
         if concrete in builtin_types:
             raise ReflectionValueError(f"Class '{concrete.__name__}' is a built-in or primitive type and cannot be used.")
 
-        # Check for abstract classes (including interfaces)
-        if hasattr(concrete, '__abstractmethods__') and len(concrete.__abstractmethods__) > 0:
-            raise ReflectionValueError(f"Class '{concrete.__name__}' is abstract or an interface and cannot be used.")
-
         # Prevent instantiating if it's already an instance
         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
-        if isinstance(concrete, abc.ABCMeta) and getattr(concrete, '__abstractmethods__', False):
+        if abc.ABC in concrete.__bases__:
             raise ReflectionValueError(f"Class '{concrete.__name__}' is an interface and cannot be used.")
 
+        return True
+
+    def __init__(self, concrete: Type) -> None:
+        """
+        Initialize the ReflectionConcrete with the provided class type.
+
+        Parameters
+        ----------
+        concrete : Type
+            The class type to be reflected upon.
+
+        Raises
+        ------
+        ReflectionTypeError
+            If the provided argument is not a class type or is already an instance.
+        ReflectionValueError
+            If the provided class is a built-in/primitive type, abstract class, or interface.
+
+        Notes
+        -----
+        - Built-in and primitive types (e.g., int, str, list) are not allowed.
+        - Abstract classes and interfaces (classes with abstract methods) are not allowed.
+        """
+
+        # Ensure the provided concrete type is a valid ReflectionConcrete class
+        ReflectionConcrete.ensureIsConcreteClass(concrete)
+
+        # Set the concrete class in the instance
         self._concrete = concrete
         self.__instance = None
 

{orionis-0.312.0.dist-info → orionis-0.313.0.dist-info}/METADATA

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

{orionis-0.312.0.dist-info → orionis-0.313.0.dist-info}/RECORD

@@ -135,11 +135,11 @@ orionis/console/output/console.py,sha256=TE_Hl720ADd82dbERFSWhkoQRukDQZmETSw4nkw
 orionis/console/output/executor.py,sha256=bdvkzW2-buy0BPpy2r5qUGrRFW2Ay6k-5rSeHb0gQ3o,3352
 orionis/console/output/progress_bar.py,sha256=vFy582z6VJS46LV6tuyrmr9qvdVeTEtw3hyNcEHezeg,3088
 orionis/console/output/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
-orionis/container/container.py,sha256=eP2YEf2UdllDFbfPPB4ILcdVQBd5kgHyWZkdttfsp1s,928
+orionis/container/container.py,sha256=3hqFY--3QFqrvI4M7WhA64qjjmKb4O58Sn6CEZIf0Oc,5331
 orionis/container/enums/lifetimes.py,sha256=RqQmugMIB1Ev_j_vFLcWorndm-to7xg4stQ7yKFDdDw,190
-orionis/container/exceptions/container_exception.py,sha256=cmoiDR2LvQ4AnxxZL-F3JdeI18ux7CzKmsCki98DAEk,585
-orionis/container/exceptions/type_error_exception.py,sha256=M7I64T5wBtHzLRyvrdP4dEzF2N3UzbOAnQmpyKy9aWo,547
-orionis/container/exceptions/value_exception.py,sha256=FSFsoG_piErEs-OOCtDrdDY02bPIOdNy4-rbJ8qPNHg,565
+orionis/container/exceptions/container_exception.py,sha256=goTDEwC70xTMD2qppN8KV-xyR0Nps218OD4D1LZ2-3s,470
+orionis/container/exceptions/type_error_exception.py,sha256=cYuvoXVOgRYj3tZPfK341aUERkf33-buOiI2eXxcrAw,470
+orionis/container/exceptions/value_exception.py,sha256=hjY0YEusoL3DurME1ornxvIv1wyGaf6tBggLFlGHblo,472
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=JKAH2ZRhlAZgkD2w11LR1-TVktfjSH9cHo3PsZXOLrg,8275
@@ -231,7 +231,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=OY1y-roZUBYR9Du8KyC-jHXB-GPu8Sjj9j-gB99J0hQ,4960
+orionis/metadata/framework.py,sha256=4RVjxtYl_4p4lR7ykv4FV8Vzv54BgGrbes_DHokj2C8,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
@@ -256,9 +256,9 @@ orionis/services/environment/exceptions/environment_value_exception.py,sha256=Nn
 orionis/services/introspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/reflection.py,sha256=AI5ZMv9kHCLOQe9lL_G7wAeY3cPLKZ1FMYqIhU0yS-M,2972
 orionis/services/introspection/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/abstract/reflection_abstract.py,sha256=O8fK2a7X82VOK4Pt2Zv6Mt0wsxezLFTyb1JVu9ApCVc,43327
+orionis/services/introspection/abstract/reflection_abstract.py,sha256=SPK2X11VvGORxxPOYloaD6hPAvky--obRU4CO1DE4zM,43865
 orionis/services/introspection/concretes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/concretes/reflection_concrete.py,sha256=dhZHzMcGNXzxinWOf8gdeD1h2bUgqrLgw00qdAcor2U,49755
+orionis/services/introspection/concretes/reflection_concrete.py,sha256=1GxD-y8LPGL6kI4Y3XbeLcFjR5Y8cOqbVEPCtPnsuYA,50982
 orionis/services/introspection/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/contracts/reflect_dependencies.py,sha256=5fdImZarC1ixoFM-1JSBx28RvYbY3GGZhDGjar7cvHc,1771
 orionis/services/introspection/contracts/reflection_abstract.py,sha256=-ugpFcAkGTlk0Md5ft8NrvupnlfVji8QZjGYqWBxqeY,22370
@@ -338,7 +338,7 @@ orionis/test/suite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuF
 orionis/test/suite/test_unit.py,sha256=5UTdCYmD_Yz8asaBF54RHOx0kjwjLjEhkyPDoDIxk-k,57049
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=jXZkbITBknbUwm_mD8bcTiwLDvsFkrO9qrf0ZgPwqxc,4903
-orionis-0.312.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.313.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
@@ -437,8 +437,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=A6QkiOkP7GPC1Szh_GqsrV7GxjWjK8cIwFez6YfrzmM,7683
-orionis-0.312.0.dist-info/METADATA,sha256=9Js6d3O7wPFOdIXfLXomApm1mBjD6r556KQQEejCwZM,4772
-orionis-0.312.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.312.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.312.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.312.0.dist-info/RECORD,,
+orionis-0.313.0.dist-info/METADATA,sha256=CbEMrV-XG3fZ9FB_7ZXl1Mw1xhwQcNeGfcWZ_buHyjI,4772
+orionis-0.313.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.313.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.313.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.313.0.dist-info/RECORD,,