orionis 0.332.0__tar.gz → 0.334.0__tar.gz

{orionis-0.332.0/orionis.egg-info → orionis-0.334.0}/PKG-INFO

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

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/implements.py

@@ -1,8 +1,8 @@
 from typing import Callable, Any
-from orionis.services.introspection.reflection import Reflection
+from orionis.services.introspection.inspection import Inspection
 from orionis.container.exceptions.container_exception import OrionisContainerException
 
-class _ImplementsAbstractMethods:
+class __ImplementsAbstractMethods:
     """
     Validator that ensures a concrete class or instance implements all abstract methods of an abstract class.
     """
@@ -45,7 +45,7 @@ class _ImplementsAbstractMethods:
         if target is None:
             raise OrionisContainerException("Either concrete class or instance must be provided for implementation check.")
 
-        target_class = target if Reflection.isClass(target) else target.__class__
+        target_class = target if Inspection(target).isClass() else target.__class__
         target_name = target_class.__name__
         abstract_name = abstract.__name__
 
@@ -63,4 +63,4 @@ class _ImplementsAbstractMethods:
             )
 
 # Exported singleton instance
-ImplementsAbstractMethods = _ImplementsAbstractMethods()
+ImplementsAbstractMethods = __ImplementsAbstractMethods()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_abstract_class.py

@@ -2,7 +2,7 @@ from typing import Callable, Any
 from orionis.services.introspection.abstract.reflection_abstract import ReflectionAbstract
 from orionis.container.exceptions.type_error_exception import OrionisContainerTypeError
 
-class _IsAbstractClass:
+class __IsAbstractClass:
     """
     Validator that ensures a class is an abstract class.
     """
@@ -31,4 +31,4 @@ class _IsAbstractClass:
             ) from e
 
 # Exported singleton instance
-IsAbstractClass = _IsAbstractClass()
+IsAbstractClass = __IsAbstractClass()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_callable.py

@@ -1,7 +1,7 @@
 from typing import Any
 from orionis.container.exceptions.type_error_exception import OrionisContainerTypeError
 
-class _IsCallable:
+class __IsCallable:
     """
     Validator that checks if a value is callable.
     Can be used directly like a function: `IsCallable(value)`
@@ -27,4 +27,4 @@ class _IsCallable:
             )
 
 # Exported singleton instance
-IsCallable = _IsCallable()
+IsCallable = __IsCallable()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_concrete_class.py

@@ -2,7 +2,7 @@ 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:
+class __IsConcreteClass:
     """
     Validator that ensures a class is a concrete (non-abstract) class.
     """
@@ -31,4 +31,4 @@ class _IsConcreteClass:
             ) from e
 
 # Exported singleton instance
-IsConcreteClass = _IsConcreteClass()
+IsConcreteClass = __IsConcreteClass()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_instance.py

@@ -2,7 +2,7 @@ from typing import Any
 from orionis.services.introspection.instances.reflection_instance import ReflectionInstance
 from orionis.container.exceptions.type_error_exception import OrionisContainerTypeError
 
-class _IsInstance:
+class __IsInstance:
     """
     Validator that ensures the provided object is a valid instance (not a class or abstract type).
     """
@@ -29,4 +29,4 @@ class _IsInstance:
             ) from e
 
 # Exported singleton instance
-IsInstance = _IsInstance()
+IsInstance = __IsInstance()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_not_subclass.py

@@ -1,7 +1,7 @@
 from typing import Callable
 from orionis.container.exceptions.container_exception import OrionisContainerException
 
-class _IsNotSubclass:
+class __IsNotSubclass:
     """
     Validator that ensures a class is NOT a subclass of another class.
     """
@@ -29,4 +29,4 @@ class _IsNotSubclass:
             )
 
 # Exported singleton instance
-IsNotSubclass = _IsNotSubclass()
+IsNotSubclass = __IsNotSubclass()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_subclass.py

@@ -1,7 +1,7 @@
 from typing import Callable
 from orionis.container.exceptions.container_exception import OrionisContainerException
 
-class _IsSubclass:
+class __IsSubclass:
     """
     Validator that ensures a class is a subclass of a given abstract class.
     """
@@ -29,4 +29,4 @@ class _IsSubclass:
             )
 
 # Exported singleton instance
-IsSubclass = _IsSubclass()
+IsSubclass = __IsSubclass()

{orionis-0.332.0 → orionis-0.334.0}/orionis/container/validators/is_valid_alias.py

@@ -1,7 +1,7 @@
 from typing import Any
 from orionis.container.exceptions.type_error_exception import OrionisContainerTypeError
 
-class _IsValidAlias:
+class __IsValidAlias:
     """
     Validator that checks if a value is a valid alias string.
     """
@@ -39,4 +39,4 @@ class _IsValidAlias:
             )
 
 # Exported singleton instance
-IsValidAlias = _IsValidAlias()
+IsValidAlias = __IsValidAlias()

{orionis-0.332.0 → orionis-0.334.0}/orionis/metadata/framework.py

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

{orionis-0.332.0 → orionis-0.334.0}/orionis/services/asynchrony/coroutines.py

@@ -1,8 +1,8 @@
 import asyncio
-from inspect import iscoroutine
 from typing import Any, Coroutine as TypingCoroutine, TypeVar, Union
 from orionis.services.asynchrony.contracts.coroutines import ICoroutine
 from orionis.services.asynchrony.exceptions.coroutine_exception import OrionisCoroutineException
+from orionis.services.introspection.inspection import Inspection
 
 T = TypeVar("T")
 
@@ -36,10 +36,12 @@ class Coroutine(ICoroutine):
         OrionisCoroutineException
             If the provided object is not a coroutine.
         """
-        if not iscoroutine(func):
+        if not Inspection(func).isCoroutine():
             raise OrionisCoroutineException(
                 f"Expected a coroutine object, but got {type(func).__name__}."
             )
+
+        # Store the coroutine function
         self.__func = func
 
     def run(self) -> Union[T, asyncio.Future]:
@@ -57,15 +59,21 @@ class Coroutine(ICoroutine):
         - If called from within an event loop, it will schedule the coroutine and return a Future.
         """
         try:
+
             # Get the current event loop
             loop = asyncio.get_running_loop()
+
         except RuntimeError:
+
             # No running event loop, run synchronously
             return asyncio.run(self.__func)
 
         if loop.is_running():
+
             # Inside an event loop, schedule as a Future
             return asyncio.ensure_future(self.__func)
+
         else:
+
             # No running loop, run synchronously
             return loop.run_until_complete(self.__func)

{orionis-0.332.0 → orionis-0.334.0}/orionis/services/environment/dot_env.py

@@ -45,45 +45,6 @@ class DotEnv(metaclass=Singleton):
         except OSError as e:
             raise OSError(f"Failed to create or access the .env file at {self._resolved_path}: {e}")
 
-    def get(self, key: str, default: Optional[Any] = None) -> Any:
-        """
-        Get the value of an environment variable.
-
-        Parameters
-        ----------
-        key : str
-            Name of the environment variable to retrieve.
-        default : Any, optional
-            Value to return if the key is not found. Default is None.
-
-        Returns
-        -------
-        Any
-            Parsed value of the environment variable, or `default` if not found.
-
-        Raises
-        ------
-        OrionisEnvironmentValueError
-            If `key` is not a string.
-        """
-        with self._lock:
-
-            # Ensure the key is a string.
-            if not isinstance(key, str):
-                raise OrionisEnvironmentValueError(
-                    f"Key must be a string, got {type(key).__name__}."
-                )
-
-            # Get the value from the .env file or the current environment.
-            value = dotenv_values(self._resolved_path).get(key)
-
-            # If the value is not found in the .env file, check the current environment variables.
-            if value is None:
-                value = os.getenv(key)
-
-            # Parse the value using the internal __parseValue method and return it
-            return self.__parseValue(value) if value is not None else default
-
     def __parseValue(self, value: Any) -> Any:
         """
         Parse and convert the input value to an appropriate Python data type with enhanced features.
@@ -142,6 +103,85 @@ class DotEnv(metaclass=Singleton):
         except (ValueError, SyntaxError):
             return value_str
 
+    def __serializeValue(self, value: Any, type_hint: str = None) -> str:
+        """
+        Parameters
+        ----------
+        value : Any
+            The value to serialize.
+        type_hint : str, optional
+            An optional type hint to guide serialization.
+        Returns
+        -------
+        str
+            The serialized string representation of the value.
+        Notes
+        -----
+        - If `value` is None, returns "null".
+        - If `type_hint` is provided, uses `EnvTypes` to serialize.
+        - Uses `repr()` for lists, dicts, tuples, and sets.
+        - Falls back to `str()` for other types.
+        """
+
+        if value is None:
+            return "null"
+
+        if type_hint:
+            return EnvTypes(value).to(type_hint)
+
+        if isinstance(value, str):
+            return value.strip()
+
+        if isinstance(value, bool):
+            return str(value).lower()
+
+        if isinstance(value, int, float):
+            return str(value)
+
+        if isinstance(value, (list, dict, tuple, set)):
+            return repr(value)
+
+        return str(value)
+
+    def get(self, key: str, default: Optional[Any] = None) -> Any:
+        """
+        Get the value of an environment variable.
+
+        Parameters
+        ----------
+        key : str
+            Name of the environment variable to retrieve.
+        default : Any, optional
+            Value to return if the key is not found. Default is None.
+
+        Returns
+        -------
+        Any
+            Parsed value of the environment variable, or `default` if not found.
+
+        Raises
+        ------
+        OrionisEnvironmentValueError
+            If `key` is not a string.
+        """
+        with self._lock:
+
+            # Ensure the key is a string.
+            if not isinstance(key, str):
+                raise OrionisEnvironmentValueError(
+                    f"Key must be a string, got {type(key).__name__}."
+                )
+
+            # Get the value from the .env file or the current environment.
+            value = dotenv_values(self._resolved_path).get(key)
+
+            # If the value is not found in the .env file, check the current environment variables.
+            if value is None:
+                value = os.getenv(key)
+
+            # Parse the value using the internal __parseValue method and return it
+            return self.__parseValue(value) if value is not None else default
+
     def set(self, key: str, value: Union[str, int, float, bool, list, dict, tuple, set], type_hint: str = None) -> bool:
         """
         Set an environment variable with the specified key and value.
@@ -195,46 +235,6 @@ class DotEnv(metaclass=Singleton):
             # Return True to indicate success.
             return True
 
-    def __serializeValue(self, value: Any, type_hint: str = None) -> str:
-        """
-        Parameters
-        ----------
-        value : Any
-            The value to serialize.
-        type_hint : str, optional
-            An optional type hint to guide serialization.
-        Returns
-        -------
-        str
-            The serialized string representation of the value.
-        Notes
-        -----
-        - If `value` is None, returns "null".
-        - If `type_hint` is provided, uses `EnvTypes` to serialize.
-        - Uses `repr()` for lists, dicts, tuples, and sets.
-        - Falls back to `str()` for other types.
-        """
-
-        if value is None:
-            return "null"
-
-        if type_hint:
-            return EnvTypes(value).to(type_hint)
-
-        if isinstance(value, str):
-            return value.strip()
-
-        if isinstance(value, bool):
-            return str(value).lower()
-
-        if isinstance(value, int, float):
-            return str(value)
-
-        if isinstance(value, (list, dict, tuple, set)):
-            return repr(value)
-
-        return str(value)
-
     def unset(self, key: str) -> bool:
         """
         Remove the specified environment variable from both the .env file and the current process environment.

{orionis-0.332.0 → orionis-0.334.0}/orionis/services/environment/types.py

@@ -73,6 +73,55 @@ class EnvTypes(IEnvTypes):
             # If raw is not a string, treat it as a value with no type hint
             self.__value_raw = raw
 
+    def get(self):
+        """
+        Returns the value corresponding to the specified type hint.
+
+        Checks if the provided type hint is valid and then dispatches the call to the appropriate
+        method for handling the type.
+
+        Supported type hints include: 'path:', 'str:', 'int:', 'float:', 'bool:', 'list:', 'dict:', 'tuple:', and 'set:'.
+
+        Returns
+        -------
+        Any
+            The value converted or processed according to the specified type hint.
+
+        Raises
+        ------
+        OrionisEnvironmentValueError
+            If the type hint is not one of the supported options.
+        """
+        if not self.__type_hint in self.OPTIONS:
+            raise OrionisEnvironmentValueError(f"Invalid type hint: {self.__type_hint}. Must be one of {self.OPTIONS}.")
+
+        if self.__type_hint == 'path':
+            return self.__parsePath()
+
+        if self.__type_hint == 'str':
+            return self.__parseStr()
+
+        if self.__type_hint == 'int':
+            return self.__parseInt()
+
+        if self.__type_hint == 'float':
+            return self.__parseFloat()
+
+        if self.__type_hint == 'bool':
+            return self.__parseBool()
+
+        if self.__type_hint == 'list':
+            return self.__parseList()
+
+        if self.__type_hint == 'dict':
+            return self.__parseDict()
+
+        if self.__type_hint == 'tuple':
+            return self.__parseTuple()
+
+        if self.__type_hint == 'set':
+            return self.__parseSet()
+
     def to(self, type_hint: str):
         """
         Set the type hint for the Type instance.
@@ -527,52 +576,3 @@ class EnvTypes(IEnvTypes):
         if not isinstance(self.__value_raw, set):
             raise OrionisEnvironmentValueError(f"Value must be a set to convert to set, got {type(self.__value_raw).__name__} instead.")
         return f"{self.__type_hint}:{repr(self.__value_raw)}"
-
-    def get(self):
-        """
-        Returns the value corresponding to the specified type hint.
-
-        Checks if the provided type hint is valid and then dispatches the call to the appropriate
-        method for handling the type.
-
-        Supported type hints include: 'path:', 'str:', 'int:', 'float:', 'bool:', 'list:', 'dict:', 'tuple:', and 'set:'.
-
-        Returns
-        -------
-        Any
-            The value converted or processed according to the specified type hint.
-
-        Raises
-        ------
-        OrionisEnvironmentValueError
-            If the type hint is not one of the supported options.
-        """
-        if not self.__type_hint in self.OPTIONS:
-            raise OrionisEnvironmentValueError(f"Invalid type hint: {self.__type_hint}. Must be one of {self.OPTIONS}.")
-
-        if self.__type_hint == 'path':
-            return self.__parsePath()
-
-        if self.__type_hint == 'str':
-            return self.__parseStr()
-
-        if self.__type_hint == 'int':
-            return self.__parseInt()
-
-        if self.__type_hint == 'float':
-            return self.__parseFloat()
-
-        if self.__type_hint == 'bool':
-            return self.__parseBool()
-
-        if self.__type_hint == 'list':
-            return self.__parseList()
-
-        if self.__type_hint == 'dict':
-            return self.__parseDict()
-
-        if self.__type_hint == 'tuple':
-            return self.__parseTuple()
-
-        if self.__type_hint == 'set':
-            return self.__parseSet()