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

orionis/foundation/config/startup.py

@@ -1,10 +1,10 @@
-from dataclasses import asdict, dataclass, field
+from dataclasses import asdict, dataclass, field, fields
 from orionis.foundation.config.app.entities.app import App
 from orionis.foundation.config.auth.entities.auth import Auth
 from orionis.foundation.config.cache.entities.cache import Cache
 from orionis.foundation.config.cors.entities.cors import Cors
 from orionis.foundation.config.database.entities.database import Database
-from orionis.foundation.config.exceptions.integrity import OrionisIntegrityException
+from orionis.foundation.exceptions.integrity import OrionisIntegrityException
 from orionis.foundation.config.filesystems.entitites.filesystems import Filesystems
 from orionis.foundation.config.logging.entities.logging import Logging
 from orionis.foundation.config.mail.entities.mail import Mail
@@ -200,4 +200,26 @@ class Configuration:
         Returns:
             dict: A dictionary representation of the Dataclass object.
         """
-        return asdict(self)
+        return asdict(self)
+
+    def getFields(self):
+        """
+        Retrieves a list of field information for the current dataclass instance.
+
+        Returns:
+            list: A list of dictionaries, each containing details about a field:
+                - name (str): The name of the field.
+                - type (type): The type of the field.
+                - default: The default value of the field, if specified; otherwise, the value from metadata or None.
+                - metadata (mapping): The metadata associated with the field.
+        """
+        __fields = []
+        for field in fields(self):
+            __metadata = dict(field.metadata) or {}
+            __fields.append({
+                "name": field.name,
+                "type": field.type.__name__ if hasattr(field.type, '__name__') else str(field.type),
+                "default": field.default if (field.default is not None and '_MISSING_TYPE' not in str(field.default)) else __metadata.get('default', None),
+                "metadata": __metadata
+            })
+        return __fields

orionis/foundation/config/testing/entities/testing.py

@@ -1,6 +1,6 @@
 from dataclasses import asdict, dataclass, field, fields
 from typing import List
-from orionis.foundation.config.exceptions.integrity import OrionisIntegrityException
+from orionis.foundation.exceptions.integrity import OrionisIntegrityException
 from orionis.services.system.workers import Workers
 from orionis.test.enums.test_mode import ExecutionMode
 

orionis/foundation/exceptions/integrity.py

@@ -0,0 +1,19 @@
+class OrionisIntegrityException(Exception):
+
+    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/metadata/framework.py

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

orionis/services/asynchrony/exceptions/coroutine_exception.py

@@ -5,7 +5,7 @@ class OrionisCoroutineException(Exception):
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
@@ -14,6 +14,6 @@ class OrionisCoroutineException(Exception):
         Returns
         -------
         str
-            A formatted string with the exception class name and its first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/environment/exceptions/environment_value_error.py

@@ -2,17 +2,18 @@ class OrionisEnvironmentValueError(Exception):
 
     def __init__(self, msg: str):
         """
-        Initializes the exception with a custom error message.
-        Args:
-            msg (str): The error message describing the exception.
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception, including the class name and the first argument.
-
-        Returns:
-            str: A formatted string with the exception class name and its first argument.
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/environment/exceptions/environment_value_exception.py

@@ -2,22 +2,18 @@ class OrionisEnvironmentValueException(Exception):
 
     def __init__(self, msg: str):
         """
-        Exception raised for errors related to environment values.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Returns a string representation of the exception.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and its first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/introspection/abstract/reflection_abstract.py

@@ -1,7 +1,8 @@
 import inspect
 import keyword
+from abc import ABC
 from typing import List, Type
-from orionis.services.introspection.abstract.contracts.reflection_abstract import IReflectionAbstract
+from orionis.services.introspection.contracts.reflection_abstract import IReflectionAbstract
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
@@ -14,7 +15,7 @@ class ReflectionAbstract(IReflectionAbstract):
     @staticmethod
     def ensureIsAbstractClass(abstract: Type):
         """
-        Ensures that the provided object is an abstract base class (interface).
+        Ensures that the provided object is an abstract base class (interface) and directly inherits from ABC.
 
         Parameters
         ----------
@@ -24,12 +25,15 @@ class ReflectionAbstract(IReflectionAbstract):
         Raises
         ------
         ReflectionTypeError
-            If 'abstract' is not a class type or not an abstract base class.
+            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)):
             raise ReflectionTypeError(f"Provided class '{abstract.__name__}' is not an interface (abstract base class)")
+        if ABC not in abstract.__bases__:
+            raise ReflectionTypeError(f"Provided class '{abstract.__name__}' must directly inherit from abc.ABC")
         return True
 
     def __init__(self, abstract: Type) -> None:

orionis/services/introspection/concretes/reflection_concrete.py

@@ -3,7 +3,7 @@ import inspect
 import keyword
 from typing import Any, Callable, List, Type
 from orionis.services.asynchrony.coroutines import Coroutine
-from orionis.services.introspection.concretes.contracts.reflection_concrete import IReflectionConcrete
+from orionis.services.introspection.contracts.reflection_concrete import IReflectionConcrete
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies

orionis/services/introspection/dependencies/reflect_dependencies.py

@@ -1,6 +1,6 @@
 import inspect
 from typing import Any, Dict, List
-from orionis.services.introspection.dependencies.contracts.reflect_dependencies import IReflectDependencies
+from orionis.services.introspection.contracts.reflect_dependencies import IReflectDependencies
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency

orionis/services/introspection/exceptions/reflection_attribute_error.py

@@ -1,26 +1,20 @@
 class ReflectionAttributeError(Exception):
-    """
-    Base class for all reflection-related exceptions.
-    """
 
     def __init__(self, msg: str):
         """
-        Initialize the exception with a custom error message.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception, including the class name and the first argument.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])
+

orionis/services/introspection/exceptions/reflection_type_error.py

@@ -1,26 +1,19 @@
 class ReflectionTypeError(Exception):
-    """
-    Base class for all reflection-related exceptions.
-    """
 
     def __init__(self, msg: str):
         """
-        Initialize the exception with a custom error message.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception, including the class name and the first argument.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/introspection/exceptions/reflection_value_error.py

@@ -1,26 +1,19 @@
 class ReflectionValueError(Exception):
-    """
-    Base class for all reflection-related exceptions.
-    """
 
     def __init__(self, msg: str):
         """
-        Initialize the exception with a custom error message.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception, including the class name and the first argument.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/introspection/instances/reflection_instance.py

@@ -8,7 +8,7 @@ from orionis.services.introspection.dependencies.reflect_dependencies import Ref
 from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
 from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
 from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
-from orionis.services.introspection.instances.contracts.reflection_instance import IReflectionInstance
+from orionis.services.introspection.contracts.reflection_instance import IReflectionInstance
 
 class ReflectionInstance(IReflectionInstance):
 

orionis/services/introspection/modules/reflection_module.py

@@ -3,7 +3,7 @@ import inspect
 import keyword
 from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
 from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
-from orionis.services.introspection.modules.contracts.reflection_module import IReflectionModule
+from orionis.services.introspection.contracts.reflection_module import IReflectionModule
 
 class ReflectionModule(IReflectionModule):
 

orionis/services/paths/exceptions/not_found_exceptions.py

@@ -1,31 +1,19 @@
 class OrionisFileNotFoundException(Exception):
-    """
-    Exception raised when a specified file is not found.
-
-    Parameters
-    ----------
-    msg : str
-        The error message describing the exception.
-    """
 
     def __init__(self, msg: str):
         """
-        Initialize the exception with a custom error message.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/paths/exceptions/path_value_exceptions.py

@@ -1,31 +1,19 @@
 class OrionisPathValueException(Exception):
-    """
-    Exception raised when a file is not found in the Orionis framework.
-
-    Parameters
-    ----------
-    msg : str
-        A detailed message describing the missing file.
-    """
 
     def __init__(self, msg: str):
         """
-        Initialize the exception with a custom error message.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception, including the class name and the first argument.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/services/system/workers.py

@@ -17,6 +17,23 @@ class Workers(IWorkers):
     """
 
     def __init__(self, ram_per_worker: float = 0.5):
+        """
+        Initialize the worker system with resource constraints.
+
+        Parameters
+        ----------
+        ram_per_worker : float, optional
+            Amount of RAM (in GB) allocated per worker. Default is 0.5.
+
+        Attributes
+        ----------
+        _cpu_count : int
+            Number of CPU cores available on the system.
+        _ram_total_gb : float
+            Total system RAM in gigabytes.
+        _ram_per_worker : float
+            RAM allocated per worker in gigabytes.
+        """
         self._cpu_count = multiprocessing.cpu_count()
         self._ram_total_gb = psutil.virtual_memory().total / (1024 ** 3)
         self._ram_per_worker = ram_per_worker

orionis/support/standard/exceptions/std_value_exception.py

@@ -2,22 +2,18 @@ class OrionisStdValueException(Exception):
 
     def __init__(self, msg: str):
         """
-        Initialize the exception with a custom error message.
-
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception, including the class name and the first argument.
-
         Returns
         -------
         str
-            A formatted string with the exception class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/test/exceptions/test_config_exception.py

@@ -14,6 +14,6 @@ class OrionisTestConfigException(Exception):
         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/test/exceptions/test_failure_exception.py

@@ -42,11 +42,9 @@ class OrionisTestFailureException(Exception):
 
     def __str__(self) -> str:
         """
-        Return a string representation of the exception.
-
         Returns
         -------
         str
-            A formatted string describing the exception, including the exception name and the message.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/test/exceptions/test_persistence_error.py

@@ -2,8 +2,6 @@ class OrionisTestPersistenceError(Exception):
 
     def __init__(self, msg: str):
         """
-        Initialize the OrionisTestPersistenceError with a specific error message.
-
         Parameters
         ----------
         msg : str
@@ -13,12 +11,9 @@ class OrionisTestPersistenceError(Exception):
 
     def __str__(self) -> str:
         """
-        Returns a formatted string representation of the exception.
-
         Returns
         -------
         str
-            A formatted string describing the exception, including the exception
-            name and the error message.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/test/exceptions/test_runtime_error.py

@@ -5,7 +5,7 @@ class OrionisTestRuntimeError(Exception):
         Parameters
         ----------
         msg : str
-            The error message describing the runtime error.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
@@ -14,6 +14,6 @@ class OrionisTestRuntimeError(Exception):
         Returns
         -------
         str
-            String representation of the exception in the format '<ClassName>: <first argument>'.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

orionis/test/exceptions/test_value_error.py

@@ -5,7 +5,7 @@ class OrionisTestValueError(Exception):
         Parameters
         ----------
         msg : str
-            The error message describing the exception.
+            Descriptive error message explaining the cause of the exception.
         """
         super().__init__(msg)
 
@@ -14,6 +14,6 @@ class OrionisTestValueError(Exception):
         Returns
         -------
         str
-            A formatted string in the form 'ClassName: message', including the class name and the first argument.
+            Formatted string describing the exception.
         """
-        return f"{self.__class__.__name__}: {self.args[0]}"
+        return str(self.args[0])

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

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