orionis 0.319.0__py3-none-any.whl → 0.321.0__py3-none-any.whl

orionis/container/validators/is_callable.py

@@ -0,0 +1,30 @@
+from typing import Any
+from orionis.container.exceptions.type_error_exception 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

@@ -0,0 +1,34 @@
+from typing import Callable, Any
+from orionis.services.introspection.concretes.reflection_concrete import ReflectionConcrete
+from orionis.container.exceptions.type_error_exception 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

@@ -0,0 +1,32 @@
+from typing import Any
+from orionis.services.introspection.instances.reflection_instance import ReflectionInstance
+from orionis.container.exceptions.type_error_exception 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

@@ -0,0 +1,32 @@
+from typing import Callable
+from orionis.container.exceptions.container_exception 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

@@ -0,0 +1,32 @@
+from typing import Callable
+from orionis.container.exceptions.container_exception 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

@@ -0,0 +1,37 @@
+from typing import Any
+from orionis.container.exceptions.type_error_exception 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 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

@@ -0,0 +1,53 @@
+from typing import Any, Union
+from orionis.container.enums.lifetimes import Lifetime
+from orionis.container.exceptions.type_error_exception 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()

orionis/metadata/framework.py

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

{orionis-0.319.0.dist-info → orionis-0.321.0.dist-info}/METADATA

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

{orionis-0.319.0.dist-info → orionis-0.321.0.dist-info}/RECORD

@@ -135,13 +135,24 @@ 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=ZL3S0HyAt8Hm58dPjltNMCSMNNP30VR61ByslzmCGgs,45066
-orionis/container/contracts/container.py,sha256=LkZ5til_3Um8ctCVTwuO36HkysL59saKwUzXR5cWUBs,5750
+orionis/container/container.py,sha256=eBVQMzfSvXcxrdm-0hq0gmXZzxf3uabIcxbGVvGZmIo,22342
+orionis/container/resolver.py,sha256=iuyTWCnCqWXQCtWvFXPdS9cR_g3Q58_wjHVn0Yg0YNM,16209
+orionis/container/contracts/container.py,sha256=ksMn6ZLnFkIxd9_hbUGz3OpHzaYTA5izcDtH959kOow,7603
 orionis/container/entities/binding.py,sha256=Qp6Lf4XUDp2NjqXDAC2lzvhOFQWiBDKiGFcKfwb4axw,4342
 orionis/container/enums/lifetimes.py,sha256=RqQmugMIB1Ev_j_vFLcWorndm-to7xg4stQ7yKFDdDw,190
 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/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
+orionis/container/validators/is_callable.py,sha256=8Bi5AflNmXhpgtk1ieirE3xgCKzq3mcgyqokCU3GHN8,843
+orionis/container/validators/is_concrete_class.py,sha256=BMhJ7vCQ2ccBA3qrRJPlsYDTSqBpqLZFfrdEGO5mlr4,1215
+orionis/container/validators/is_instance.py,sha256=vUwWIMeG1zLMsGX9GyoOU-LZtCgqBDZ9hUNDj_KyuYo,999
+orionis/container/validators/is_not_subclass.py,sha256=-iZw5ZCYnQtlU-xPO-o7lUj5DxPkN0G67-bLbLVhwtw,1167
+orionis/container/validators/is_subclass.py,sha256=O2aF0KLg5ZnDutKQ1xDvet34kentftlqgEkRNvumCoM,1135
+orionis/container/validators/is_valid_alias.py,sha256=avm6uz-huVi_kRov4BksSToslIHQfz-MLynjkzhdSRM,1246
+orionis/container/validators/lifetime.py,sha256=78o7BHBCRReG8vnF0gW2RUf6m6wwMhr7w4VA6F2B46A,1865
 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
@@ -233,7 +244,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=MyXQ31_zvD5irlN_XvuSicVccDNBPb64XCKc8qujCEc,4960
+orionis/metadata/framework.py,sha256=gv-aVbvyQwRvOTPPCJTIwJffZOEd9Ak6L9jdwT46oOE,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
@@ -345,7 +356,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.319.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.321.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
@@ -446,8 +457,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.319.0.dist-info/METADATA,sha256=426gql1AFezl4n3-_ORGM8wdkUYcEsZr8n3ykl6ruOI,4772
-orionis-0.319.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.319.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.319.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.319.0.dist-info/RECORD,,
+orionis-0.321.0.dist-info/METADATA,sha256=kQ_DamwqrnAqkqPJQZd6mR4u-U_ERbRLwEw8FqTgTwE,4772
+orionis-0.321.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.321.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.321.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.321.0.dist-info/RECORD,,