orionis 0.603.0__py3-none-any.whl → 0.605.0__py3-none-any.whl

orionis/metadata/framework.py

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

orionis/support/wrapper/dataclass.py

@@ -0,0 +1,233 @@
+from dataclasses import MISSING, asdict, fields, is_dataclass
+from enum import Enum
+
+from orionis.support.standard.std import StdClass
+
+class DataClass:
+
+    def __init__(self, dataclass_cls: type):
+        """
+        Initialize the DataClass wrapper with a dataclass type.
+
+        Parameters
+        ----------
+        dataclass_cls : type
+            The class to be wrapped. Must be a dataclass type.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        ValueError
+            If the provided class is not a dataclass type or is an instance.
+
+        Notes
+        -----
+        This constructor validates that the input is a dataclass type (not an instance).
+        If valid, it stores the class for further operations and initializes internal
+        dictionaries for property management. Raises an error if the input is not a valid
+        dataclass type.
+        """
+
+        # Ensure the provided class is a dataclass and not an instance
+        if not (is_dataclass(dataclass_cls) and isinstance(dataclass_cls, type)):
+            raise ValueError(
+                f"The provided class '{getattr(dataclass_cls, '__name__', type(dataclass_cls).__name__)}' must be a dataclass type, not an instance."
+            )
+
+        # Store the dataclass type for use in other methods
+        self.__cls = dataclass_cls
+
+        # Initialize dictionaries to manage strict and extra properties
+        self.__strict_properties = {}
+        self.__extra_properties = {}
+
+    def getOriginalProperties(self) -> set:
+        """
+        Get the set of original field names defined in the wrapped dataclass type.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        set of str
+            Set containing the names of all original fields defined in the dataclass type.
+
+        Raises
+        ------
+        AttributeError
+            If the wrapped class does not have dataclass fields.
+
+        Notes
+        -----
+        This method retrieves the field names from the dataclass type stored in `self.__cls`.
+        If the internal reference is an instance, its type is used to access the field definitions.
+        The returned set includes only the names of fields originally declared in the dataclass,
+        excluding any dynamically added attributes.
+        """
+
+        # Use the class stored in self.__cls; if it's an instance, get its type
+        cls = self.__cls
+        if not isinstance(cls, type):
+            cls = type(cls)
+
+        # Return the set of field names defined in the dataclass
+        return set(cls.__dataclass_fields__.keys())
+
+    def fromDict(self, props: dict) -> 'DataClass':
+        """
+        Populate the wrapped dataclass instance with properties from a dictionary.
+
+        Parameters
+        ----------
+        props : dict
+            Dictionary containing property names and values to assign to the dataclass instance.
+
+        Returns
+        -------
+        DataClass
+            The current instance of the DataClass wrapper, with the dataclass instance populated
+            according to the provided dictionary. The internal reference (`self.__cls`) is updated
+            to the new dataclass instance created with the provided properties.
+
+        Raises
+        ------
+        ValueError
+            If the `props` parameter is not a dictionary.
+
+        Notes
+        -----
+        - Properties matching the original dataclass fields are assigned as strict properties.
+        - Properties not matching the original fields are assigned as extra properties and set as attributes.
+        - The method creates a new instance of the dataclass using only the strict properties, then sets extra properties as attributes.
+        - The dataclass type itself is not modified; only the instance managed by this wrapper is updated.
+        """
+
+        # Ensure the input is a dictionary
+        if not isinstance(props, dict):
+            raise ValueError("The 'props' parameter must be a dictionary.")
+
+        # Get the set of original field names from the dataclass
+        original_fields = self.getOriginalProperties()
+
+        # Separate strict (original) and extra properties
+        for key, value in props.items():
+            if key in original_fields:
+                self.__strict_properties[key] = value  # Assign to strict properties
+            else:
+                self.__extra_properties[key] = value   # Assign to extra properties
+
+        # Create a new instance of the dataclass with strict properties only
+        instance = self.__cls(**self.__strict_properties)
+
+        # Set extra properties as attributes on the instance
+        for key, value in self.__extra_properties.items():
+            instance.__setattr__(key, value)
+
+        # Update the internal reference to the new instance
+        self.__cls = instance
+
+        # Return self to allow method chaining
+        return self
+
+    def fromDataclass(self, instance) -> 'DataClass':
+        """
+        Populate the wrapped dataclass instance with properties from another dataclass instance.
+
+        Parameters
+        ----------
+        instance : object
+            An instance of a dataclass from which properties will be extracted and assigned to the wrapped dataclass.
+
+        Returns
+        -------
+        DataClass
+            Returns the current instance of the DataClass wrapper after populating its internal dataclass instance
+            with the properties extracted from the provided dataclass instance.
+
+        Raises
+        ------
+        ValueError
+            If the provided `instance` is not a dataclass.
+
+        Notes
+        -----
+        This method extracts all properties from the provided dataclass instance using `asdict` if it is already
+        initialized (i.e., not a class). If the input is a dataclass type, it extracts properties from its `__dict__`.
+        The extracted properties are then delegated to `fromDict`, which handles property validation and assignment,
+        including strict property checking if enabled.
+        """
+
+        # Ensure the provided instance is a dataclass
+        if not is_dataclass(instance):
+            raise ValueError("The provided instance is not a dataclass.")
+
+        # Extract properties from the dataclass instance using asdict if it's an instance,
+        # otherwise use __dict__ for class-level attributes
+        if is_dataclass(instance) and not isinstance(instance, type):
+            props = asdict(instance)
+        else:
+            props = {k: v for k, v in instance.__dict__.items() if not k.startswith("__")}
+
+        # Delegate property assignment to fromDict, which handles validation and assignment
+        return self.fromDict(props)
+
+    def get(self) -> type:
+        """
+        Retrieve the dataclass type or instance currently managed by this wrapper.
+
+        Returns
+        -------
+        type or object
+            Returns the dataclass type if no instance has been set, or the dataclass instance if one has been created and assigned.
+            The returned value reflects the current state of the wrapper: either the original dataclass type or the most recently set instance.
+
+        Notes
+        -----
+        This method provides direct access to the underlying dataclass type or instance managed by the wrapper.
+        It is useful for introspection, further manipulation, or integration with other components.
+        The returned value is determined by the internal state of the wrapper (`self.__cls`), which may be either a class or an instance.
+        """
+
+        # Return the current dataclass type or instance managed by the wrapper
+        return self.__cls
+
+    def toDict(self) -> dict:
+        """
+        Convert the managed dataclass instance to a dictionary representation, including both original fields and any extra properties.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        dict
+            Dictionary containing all original dataclass fields and any extra properties added to the instance.
+            - If the internal reference is an instance, original fields are recursively converted using `dataclasses.asdict`.
+            - Extra properties (not defined in the dataclass) are merged into the result.
+            - If the internal reference is still a class (not an instance), only strict properties are returned.
+
+        Notes
+        -----
+        - Original dataclass fields are obtained using `dataclasses.asdict` for instances.
+        - Extra properties are those added to the instance that are not part of the original dataclass definition.
+        - The returned dictionary represents the complete state of the managed dataclass instance, including dynamic attributes.
+        """
+
+        # If self.__cls is an instance, use asdict to get original (strict) properties
+        if not isinstance(self.__cls, type):
+            result = asdict(self.__cls)
+        else:
+            # If it's still a class, just return the strict properties dictionary
+            result = dict(self.__strict_properties)
+
+        # Merge extra properties (not defined in the dataclass) into the result
+        result.update(self.__extra_properties)
+
+        # Return the combined dictionary
+        return result

{orionis-0.603.0.dist-info → orionis-0.605.0.dist-info}/METADATA

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

{orionis-0.603.0.dist-info → orionis-0.605.0.dist-info}/RECORD

@@ -103,7 +103,7 @@ orionis/failure/contracts/handler.py,sha256=AeJfkJfD3hTkOIYAtADq6GnQfq-qWgDfUc7b
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=1zD-awcuAyEtlR-L7V7ZIfPSF4GpXkf-neL5sXul7dc,1240
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=_pws-r2QSTTvIonmt9bEBUwOpDvPQkAMNi3IsUpNY8E,82664
+orionis/foundation/application.py,sha256=kSSR6uxaElgkh2fzR3EPBM1XCbnJLLE8l4FpttzsEPk,88193
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=btqvryeIf9lLNQ9fBff7bJMrfraEY8qrWi4y_5YAR0Q,9681
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -217,7 +217,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=irwkjMiq-HpsbJxAOnhjji
 orionis/foundation/providers/testing_provider.py,sha256=2akFnabtH_cV_7z_2cCL7u8cPCGvCJAmlhMcnlCrc4c,3742
 orionis/foundation/providers/workers_provider.py,sha256=P_YtJuPNrdJAQJkAqI11KI0c6GSB9NqIuuCKpRytE0g,3937
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=hxzdtDuk8fEhzryzkVy_FirXfQNZt0n9Qzqb-960y0E,4109
+orionis/metadata/framework.py,sha256=110OVacTpVP1vOd_IzObZbki4RXx9TVLY4wF9srLw_M,4109
 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
@@ -270,8 +270,6 @@ orionis/services/introspection/concretes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5
 orionis/services/introspection/concretes/reflection.py,sha256=ZOScKOATUNA-gOJIG_8Z2Q5XXI2kAmDRCg8fg2SFklg,55872
 orionis/services/introspection/concretes/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/concretes/contracts/reflection.py,sha256=LwEAgdN_WLCfS9b8pnFRVfN0PTRK4Br9qngu5km5aIk,24955
-orionis/services/introspection/dataclass/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/dataclass/extractor.py,sha256=8nDoZYnyWTA4o8DTCM6rFNpOKnQR5O0aZk5oC5domXs,1700
 orionis/services/introspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/dependencies/reflection.py,sha256=3aQl541JkohRcoZFxQGiGPz3CnBMK8gmcRwO9XiLSY0,13906
 orionis/services/introspection/dependencies/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -357,6 +355,7 @@ orionis/support/standard/contracts/std.py,sha256=SJ44qIFDCp4jHL18k4sji5Mt_MN16lp
 orionis/support/standard/exceptions/__init__.py,sha256=GovJ24C8fCOlnU5_TrMJKngYNcJ1rvJnF9WFTA8ktyw,96
 orionis/support/standard/exceptions/standard.py,sha256=BM0VHLRYD7SzoMJkaA7BxY5280v81hlj1Xslu0UaFag,788
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
+orionis/support/wrapper/dataclass.py,sha256=uNihcPLxUYQZ_ZFWM_SaJ8xqpZ66KceE18xNBwL7r18,9525
 orionis/support/wrapper/dot_dict.py,sha256=T8xWwwOhBZHNeXRwE_CxvOwG9UFxsLqNmOJjV2CNIrc,7284
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/kernel.py,sha256=gZARnbvdz193WE-gdOiZvtUsuwHCGHHAw07conCNWMo,4019
@@ -405,8 +404,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.603.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.603.0.dist-info/METADATA,sha256=8hi5AZgoNofNT1vP7LzZGA6R6Rbue7G9q7Ws0ghhunk,4801
-orionis-0.603.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.603.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.603.0.dist-info/RECORD,,
+orionis-0.605.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.605.0.dist-info/METADATA,sha256=6c_7Q48WCF7aakbfOg4zyfjC-ORNJf7VqD2mIyutUZo,4801
+orionis-0.605.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.605.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.605.0.dist-info/RECORD,,

orionis/services/introspection/dataclass/extractor.py

@@ -1,45 +0,0 @@
-class DataclassInspector:
-
-    def __call__(self, dataclass_type: type) -> dict:
-        """
-        Extract attributes and their values from a given dataclass type.
-
-        This method retrieves all attributes defined in the provided dataclass type,
-        excluding special attributes (those whose names start with '__'). It returns
-        a dictionary where the keys are the attribute names and the values are the
-        corresponding attribute values.
-
-        Parameters
-        ----------
-        dataclass_type : type
-            The dataclass type from which to extract attributes. This must be a valid
-            Python class type.
-
-        Returns
-        -------
-        dict
-            A dictionary where:
-            - Keys are the names of the attributes defined in the dataclass type.
-            - Values are the corresponding attribute values.
-            Special attributes (those starting with '__') are excluded.
-
-        Raises
-        ------
-        TypeError
-            If the provided argument is not a valid Python class type.
-        """
-
-        # Ensure the input is a valid class type
-        if isinstance(dataclass_type, type):
-
-            # Extract attributes and their values, excluding special attributes
-            values = {k: v for k, v in dataclass_type.__dict__.items() if not k.startswith("__")}
-
-            # Return the extracted attributes and their values
-            return values
-
-        # Raise an error if the input is not a valid class type
-        raise TypeError("The provided argument is not a valid dataclass type.")
-
-# Instantiate the DataclassValues callable
-extractor = DataclassInspector()