orionis 0.663.0__py3-none-any.whl → 0.664.0__py3-none-any.whl

orionis/metadata/framework.py

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

{orionis-0.663.0.dist-info → orionis-0.664.0.dist-info}/METADATA

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

{orionis-0.663.0.dist-info → orionis-0.664.0.dist-info}/RECORD

@@ -84,16 +84,6 @@ orionis/container/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 orionis/container/facades/facade.py,sha256=c9V4ywJCdux1oluzVc7ph_8-TY2Nc85k3_UeQSBkiQY,3674
 orionis/container/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/providers/service_provider.py,sha256=OlqmBIkZSDZHJ_JZvwhNiMMrn-GzeIoCgR-HdsqGOVM,2385
-orionis/container/validators/__init__.py,sha256=iJ_cY8U0EkpnZOU4_LANGKHFkvHeV0vH5bjbYr1fdSg,609
-orionis/container/validators/implements.py,sha256=6q6abRSXxpByIGGb_C5P3qGkvyX5zogOceFt9DPzUdI,3110
-orionis/container/validators/is_abstract_class.py,sha256=vJqUPn610YZS0sEkV8c_gPZskIgWmFHjg3D3MF2OTs8,1141
-orionis/container/validators/is_callable.py,sha256=ZW-e3ljJGXbD9GUEfPNqVcyBbpVHFlfYaTf9rSmJmBk,824
-orionis/container/validators/is_concrete_class.py,sha256=CLStCMuf40amVLvg1x0utlUz64xJnp9guc8j50J95d8,1187
-orionis/container/validators/is_instance.py,sha256=IkpSyd81jTc3WnmQyrh6TmQb-4suD38h03ckhjfrI90,971
-orionis/container/validators/is_not_subclass.py,sha256=xq2NI-ZJjSAnq2C_tEOyncadY4i9vjj9Pa2MKVow3Ek,1149
-orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYqIVB8zXVN-bYnBI,1117
-orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
-orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/failure/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/catch.py,sha256=O6C_KsSPI-ZZb8upzwGagkJMhQ6FWX7J2q9BWweMgQE,3286
 orionis/failure/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -217,7 +207,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=0SXT6mJPx_cpwHycCwnheRoGpH0odIHXGOk8OeY37jo,4089
+orionis/metadata/framework.py,sha256=H-AkUGADSlKFuauY2U4ZvjGmaIO5KKNP6NpvVciaXfU,4089
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -404,8 +394,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.663.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.663.0.dist-info/METADATA,sha256=7VlP3kWuATRSS3Ideqk4S5ixt_hHwbxaN7kvvpmvyoc,4772
-orionis-0.663.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.663.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.663.0.dist-info/RECORD,,
+orionis-0.664.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.664.0.dist-info/METADATA,sha256=4gQujfxs0AkLeB_GuD6ohahj1ncWIVRTLa9t6aKOKAo,4772
+orionis-0.664.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.664.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.664.0.dist-info/RECORD,,

orionis/container/validators/__init__.py

@@ -1,21 +0,0 @@
-from .implements import ImplementsAbstractMethods
-from .is_abstract_class import IsAbstractClass
-from .is_concrete_class import IsConcreteClass
-from .is_instance import IsInstance
-from .is_callable import IsCallable
-from .is_subclass import IsSubclass
-from .is_not_subclass import IsNotSubclass
-from .is_valid_alias import IsValidAlias
-from .lifetime import LifetimeValidator
-
-__all__ = [
-    "ImplementsAbstractMethods",
-    "IsAbstractClass",
-    "IsConcreteClass",
-    "IsInstance",
-    "IsCallable",
-    "IsSubclass",
-    "IsNotSubclass",
-    "IsValidAlias",
-    "LifetimeValidator",
-]

orionis/container/validators/implements.py

@@ -1,73 +0,0 @@
-from typing import Callable, Any
-from orionis.services.introspection.objects.types import Type
-from orionis.container.exceptions import OrionisContainerException
-
-class __ImplementsAbstractMethods:
-    """
-    Validator that ensures a concrete class or instance implements all abstract methods of an abstract class.
-    """
-
-    def __call__(
-        self,
-        *,
-        abstract: Callable[..., Any] = None,
-        concrete: Callable[..., Any] = None,
-        instance: Any = None
-    ) -> None:
-        """
-        Validates that a concrete class or instance implements all abstract methods defined in an abstract class.
-
-        Parameters
-        ----------
-        abstract : Callable[..., Any]
-            The abstract base class.
-        concrete : Callable[..., Any], optional
-            The class expected to implement the abstract methods.
-        instance : Any, optional
-            The instance expected to implement the abstract methods.
-
-        Raises
-        ------
-        OrionisContainerException
-            If any abstract method is not implemented.
-        """
-
-        # Validate that the abstract class is provided
-        if abstract is None:
-            raise OrionisContainerException("Abstract class must be provided for implementation check.")
-
-        # Check if the abstract class has abstract methods
-        abstract_methods = getattr(abstract, '__abstractmethods__', set())
-        if not abstract_methods:
-            raise OrionisContainerException(
-                f"The abstract class '{abstract.__name__}' does not define any abstract methods. "
-                "An abstract class must have at least one abstract method."
-            )
-
-        # Determine the target class or instance to check
-        target = concrete if concrete is not None else instance
-        if target is None:
-            raise OrionisContainerException("Either concrete class or instance must be provided for implementation check.")
-
-        # Validate that the target is a class or instance
-        target_class = target if Type(target).isClass() else target.__class__
-        target_name = target_class.__name__
-        abstract_name = abstract.__name__
-
-        # Check if the target class implements all abstract methods
-        not_implemented = []
-        for method in abstract_methods:
-            expected_method = str(method).replace(f"_{abstract_name}", f"_{target_name}")
-            if expected_method not in target_class.__dict__:
-                not_implemented.append(method)
-
-        # If any abstract methods are not implemented, raise an exception
-        if not_implemented:
-            formatted = "\n  • " + "\n  • ".join(not_implemented)
-            raise OrionisContainerException(
-                f"'{target_name}' does not implement the following abstract methods defined in '{abstract_name}':{formatted}\n"
-                "Please ensure that all abstract methods are implemented."
-            )
-
-# Exported singleton instance
-ImplementsAbstractMethods = __ImplementsAbstractMethods()

orionis/container/validators/is_abstract_class.py

@@ -1,34 +0,0 @@
-from typing import Callable, Any
-from orionis.services.introspection.abstract.reflection import ReflectionAbstract
-from orionis.container.exceptions import OrionisContainerTypeError
-
-class __IsAbstractClass:
-    """
-    Validator that ensures a class is an abstract class.
-    """
-
-    def __call__(self, abstract: Callable[..., Any], lifetime: str) -> None:
-        """
-        Ensures that the provided class is an abstract class.
-
-        Parameters
-        ----------
-        abstract : Callable[..., Any]
-            The class intended to represent the abstract type.
-        lifetime : str
-            A string indicating the service lifetime, used in error messages.
-
-        Raises
-        ------
-        OrionisContainerTypeError
-            If the class is not abstract.
-        """
-        try:
-            ReflectionAbstract.ensureIsAbstractClass(abstract)
-        except Exception as e:
-            raise OrionisContainerTypeError(
-                f"Unexpected error registering {lifetime} service: {e}"
-            ) from e
-
-# Exported singleton instance
-IsAbstractClass = __IsAbstractClass()

orionis/container/validators/is_callable.py

@@ -1,30 +0,0 @@
-from typing import Any
-from orionis.container.exceptions import OrionisContainerTypeError
-
-class __IsCallable:
-    """
-    Validator that checks if a value is callable.
-    Can be used directly like a function: `IsCallable(value)`
-    """
-
-    def __call__(self, value: Any) -> None:
-        """
-        Ensures that the provided value is callable.
-
-        Parameters
-        ----------
-        value : Any
-            The value to check.
-
-        Raises
-        ------
-        OrionisContainerTypeError
-            If the value is not callable.
-        """
-        if not callable(value):
-            raise OrionisContainerTypeError(
-                f"Expected a callable type, but got {type(value).__name__} instead."
-            )
-
-# Exported singleton instance
-IsCallable = __IsCallable()

orionis/container/validators/is_concrete_class.py

@@ -1,34 +0,0 @@
-from typing import Callable, Any
-from orionis.services.introspection.concretes.reflection import ReflectionConcrete
-from orionis.container.exceptions import OrionisContainerTypeError
-
-class __IsConcreteClass:
-    """
-    Validator that ensures a class is a concrete (non-abstract) class.
-    """
-
-    def __call__(self, concrete: Callable[..., Any], lifetime: str) -> None:
-        """
-        Ensures that the provided class is a concrete (non-abstract) class.
-
-        Parameters
-        ----------
-        concrete : Callable[..., Any]
-            The class intended to represent the concrete implementation.
-        lifetime : str
-            A string indicating the service lifetime, used in error messages.
-
-        Raises
-        ------
-        OrionisContainerTypeError
-            If the class is abstract or invalid.
-        """
-        try:
-            ReflectionConcrete.ensureIsConcreteClass(concrete)
-        except Exception as e:
-            raise OrionisContainerTypeError(
-                f"Unexpected error registering {lifetime} service: {e}"
-            ) from e
-
-# Exported singleton instance
-IsConcreteClass = __IsConcreteClass()

orionis/container/validators/is_instance.py

@@ -1,32 +0,0 @@
-from typing import Any
-from orionis.services.introspection.instances.reflection import ReflectionInstance
-from orionis.container.exceptions import OrionisContainerTypeError
-
-class __IsInstance:
-    """
-    Validator that ensures the provided object is a valid instance (not a class or abstract type).
-    """
-
-    def __call__(self, instance: Any) -> None:
-        """
-        Ensures that the provided object is a valid instance.
-
-        Parameters
-        ----------
-        instance : Any
-            The object to be validated.
-
-        Raises
-        ------
-        OrionisContainerTypeError
-            If the object is not a valid instance.
-        """
-        try:
-            ReflectionInstance.ensureIsInstance(instance)
-        except Exception as e:
-            raise OrionisContainerTypeError(
-                f"Error registering instance: {e}"
-            ) from e
-
-# Exported singleton instance
-IsInstance = __IsInstance()

orionis/container/validators/is_not_subclass.py

@@ -1,32 +0,0 @@
-from typing import Callable
-from orionis.container.exceptions import OrionisContainerException
-
-class __IsNotSubclass:
-    """
-    Validator that ensures a class is NOT a subclass of another class.
-    """
-
-    def __call__(self, abstract: Callable[..., any], concrete: Callable[..., any]) -> None:
-        """
-        Validates that the concrete class is NOT a subclass of the abstract class.
-
-        Parameters
-        ----------
-        abstract : Callable[..., Any]
-            The supposed base class or interface.
-        concrete : Callable[..., Any]
-            The implementation class to check.
-
-        Raises
-        ------
-        OrionisContainerException
-            If the concrete class IS a subclass of the abstract class.
-        """
-        if issubclass(concrete, abstract):
-            raise OrionisContainerException(
-                "The concrete class must NOT inherit from the provided abstract class. "
-                "Please ensure that the concrete class is not a subclass of the specified abstract class."
-            )
-
-# Exported singleton instance
-IsNotSubclass = __IsNotSubclass()

orionis/container/validators/is_subclass.py

@@ -1,32 +0,0 @@
-from typing import Callable
-from orionis.container.exceptions import OrionisContainerException
-
-class __IsSubclass:
-    """
-    Validator that ensures a class is a subclass of a given abstract class.
-    """
-
-    def __call__(self, abstract: Callable[..., any], concrete: Callable[..., any]) -> None:
-        """
-        Validates that the concrete class is a subclass of the abstract class.
-
-        Parameters
-        ----------
-        abstract : Callable[..., Any]
-            The base or abstract class.
-        concrete : Callable[..., Any]
-            The class to verify.
-
-        Raises
-        ------
-        OrionisContainerException
-            If the concrete class is NOT a subclass of the abstract class.
-        """
-        if not issubclass(concrete, abstract):
-            raise OrionisContainerException(
-                "The concrete class must inherit from the provided abstract class. "
-                "Please ensure that the concrete class is a subclass of the specified abstract class."
-            )
-
-# Exported singleton instance
-IsSubclass = __IsSubclass()

orionis/container/validators/is_valid_alias.py

@@ -1,42 +0,0 @@
-from typing import Any
-from orionis.container.exceptions import OrionisContainerTypeError
-
-class __IsValidAlias:
-    """
-    Validator that checks if a value is a valid alias string.
-    """
-
-    _INVALID_CHARS = set(' \t\n\r\x0b\x0c!@#$%^&*()[]{};:,/<>?\\|`~"\'')
-
-    def __call__(self, value: Any) -> None:
-        """
-        Ensures that the provided value is a valid alias of type str and does not contain invalid characters.
-
-        Parameters
-        ----------
-        value : Any
-            The value to check.
-
-        Raises
-        ------
-        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."
-            )
-
-        if any(char in self._INVALID_CHARS for char in value):
-            raise OrionisContainerTypeError(
-                f"Alias '{value}' contains invalid characters. "
-                "Aliases must not contain whitespace or special symbols."
-            )
-
-# Exported singleton instance
-IsValidAlias = __IsValidAlias()

orionis/container/validators/lifetime.py

@@ -1,53 +0,0 @@
-from typing import Any, Union
-from orionis.container.enums.lifetimes import Lifetime
-from orionis.container.exceptions import OrionisContainerTypeError
-
-class __LifetimeValidator:
-    """
-    Validator that checks if a value is a valid lifetime and converts string representations
-    to Lifetime enum values.
-    """
-
-    def __call__(self, lifetime: Union[str, Lifetime, Any]) -> Lifetime:
-        """
-        Validates and normalizes the provided lifetime value.
-
-        Parameters
-        ----------
-        lifetime : Union[str, Lifetime, Any]
-            The lifetime value to validate. Can be a Lifetime enum or a string
-            representing a valid lifetime.
-
-        Returns
-        -------
-        Lifetime
-            The validated Lifetime enum value.
-
-        Raises
-        ------
-        OrionisContainerTypeError
-            If the value is not a valid Lifetime enum or string representation,
-            or if the string doesn't match any valid Lifetime value.
-        """
-        # Already a Lifetime enum
-        if isinstance(lifetime, Lifetime):
-            return lifetime
-
-        # String that might represent a Lifetime
-        if isinstance(lifetime, str):
-            lifetime_key = lifetime.strip().upper()
-            if lifetime_key in Lifetime.__members__:
-                return Lifetime[lifetime_key]
-
-            valid_options = ', '.join(Lifetime.__members__.keys())
-            raise OrionisContainerTypeError(
-                f"Invalid lifetime '{lifetime}'. Valid options are: {valid_options}."
-            )
-
-        # Invalid type
-        raise OrionisContainerTypeError(
-            f"Lifetime must be of type str or Lifetime enum, got {type(lifetime).__name__}."
-        )
-
-# Exported singleton instance
-LifetimeValidator = __LifetimeValidator()