orionis 0.206.0__py3-none-any.whl → 0.208.0__py3-none-any.whl

orionis/luminate/support/inspection/reflexion_instance_with_abstract.py

@@ -1,309 +1,230 @@
-from typing import Any, Type, Dict, List, Tuple, Callable, Optional, Set, TypeVar
-import inspect
 import abc
+import inspect
+from typing import Any, Dict, List, Tuple, Type, TypeVar, Union
+from orionis.luminate.support.inspection.reflexion_abstract import ReflexionAbstract
+from orionis.luminate.support.inspection.reflexion_instance import ReflexionInstance
 
 T = TypeVar('T')
 ABC = TypeVar('ABC', bound=abc.ABC)
 
 class ReflexionInstanceWithAbstract:
-    """A reflection object encapsulating a class instance and its abstract parent.
+    """Advanced reflection tool for analyzing concrete implementations against abstract bases.
 
-    This class provides methods to inspect both the concrete instance and its
-    abstract parent class, including their relationships and implementations.
+    Combines inspection of both concrete instances and their abstract parent classes,
+    providing detailed comparison and compatibility analysis.
 
     Parameters
     ----------
     instance : Any
-        The instance being reflected upon
+        The concrete instance to inspect
     abstract : Type[ABC]
-        The abstract parent class
+        The abstract base class/interface being implemented
 
     Attributes
     ----------
     _instance : Any
-        The encapsulated instance
+        The concrete instance being analyzed
     _abstract : Type[ABC]
-        The encapsulated abstract parent class
+        The abstract base class/interface
+    _concrete_reflexion : ReflexionInstance
+        Reflection helper for the concrete instance
+    _abstract_reflexion : ReflexionAbstract
+        Reflection helper for the abstract class
     """
 
     def __init__(self, instance: Any, abstract: Type[ABC]) -> None:
-        """Initialize with the instance and abstract parent."""
         self._instance = instance
         self._abstract = abstract
+        self._concrete_reflexion = ReflexionInstance(instance)
+        self._abstract_reflexion = ReflexionAbstract(abstract)
 
-    def getClassName(self) -> str:
-        """Get the name of the instance's class.
-
-        Returns
-        -------
-        str
-            The name of the concrete class
-        """
-        return self._instance.__class__.__name__
-
-    def getAbstractClassName(self) -> str:
-        """Get the name of the abstract parent class.
-
-        Returns
-        -------
-        str
-            The name of the abstract class
-        """
-        return self._abstract.__name__
-
-    def getImplementationStatus(self) -> Dict[str, bool]:
-        """Check which abstract methods are implemented.
-
-        Returns
-        -------
-        Dict[str, bool]
-            Dictionary mapping abstract method names to implementation status
-        """
-        abstract_methods = getattr(self._abstract, '__abstractmethods__', set())
-        return {
-            method: method in dir(self._instance)
-            for method in abstract_methods
-        }
+    @property
+    def concrete(self) -> ReflexionInstance:
+        """Access the concrete instance reflection helper."""
+        return self._concrete_reflexion
 
-    def getMissingImplementations(self) -> Set[str]:
-        """Get abstract methods not implemented by the concrete class.
+    @property
+    def abstract(self) -> ReflexionAbstract:
+        """Access the abstract class reflection helper."""
+        return self._abstract_reflexion
 
-        Returns
-        -------
-        Set[str]
-            Set of abstract method names not implemented
-        """
-        abstract_methods = getattr(self._abstract, '__abstractmethods__', set())
-        return abstract_methods - set(dir(self._instance))
-
-    def isProperImplementation(self) -> bool:
-        """Check if the instance properly implements all abstract methods.
+    def getImplementationAnalysis(self) -> Dict[str, Dict[str, Union[bool, str, inspect.Signature]]]:
+        """Comprehensive analysis of implementation compliance.
 
         Returns
         -------
-        bool
-            True if all abstract methods are implemented, False otherwise
+        Dict[str, Dict[str, Union[bool, str, inspect.Signature]]]
+            Detailed analysis including:
+            - 'implemented': Whether method is implemented
+            - 'signature_match': Whether signatures match
+            - 'abstract_signature': Signature from abstract class
+            - 'concrete_signature': Signature from concrete class
         """
-        return len(self.getMissingImplementations()) == 0
-
-    def getAbstractMethods(self) -> Set[str]:
-        """Get all abstract methods from the parent class.
-
-        Returns
-        -------
-        Set[str]
-            Set of abstract method names
-        """
-        return getattr(self._abstract, '__abstractmethods__', set())
-
-    def getConcreteMethods(self) -> List[str]:
-        """Get all concrete methods of the instance.
-
-        Returns
-        -------
-        List[str]
-            List of method names implemented by the instance
-        """
-        return [name for name, _ in inspect.getmembers(
-            self._instance,
-            predicate=inspect.ismethod
-        )]
-
-    def getOverriddenMethods(self) -> Dict[str, Tuple[Type, Type]]:
-        """Get methods that override abstract ones with their signatures.
-
-        Returns
-        -------
-        Dict[str, Tuple[Type, Type]]
-            Dictionary mapping method names to tuples of
-            (abstract_signature, concrete_signature)
-        """
-        overridden = {}
-        abstract_methods = self.getAbstractMethods()
-
+        analysis = {}
+        abstract_methods = self._abstract_reflexion.getAbstractMethods()
         for method in abstract_methods:
-            if hasattr(self._instance, method):
-                abstract_sig = inspect.signature(getattr(self._abstract, method))
-                concrete_sig = inspect.signature(getattr(self._instance, method))
-                overridden[method] = (abstract_sig, concrete_sig)
+            entry = {
+                'implemented': False,
+                'abstract_signature': None,
+                'concrete_signature': None,
+                'signature_match': False,
+                'type' : 'method'
+            }
 
-        return overridden
-
-    def checkSignatureCompatibility(self) -> Dict[str, bool]:
-        """Check if implemented methods match abstract signatures.
+            if hasattr(self._instance, method):
+                entry['implemented'] = True
+                abstract_sig = self._abstract_reflexion.getMethodSignature(method)
+                concrete_sig = self._concrete_reflexion.getMethodSignature(method)
+
+                entry.update({
+                    'abstract_signature': abstract_sig,
+                    'concrete_signature': concrete_sig,
+                    'signature_match': (
+                        abstract_sig.parameters == concrete_sig.parameters and
+                        abstract_sig.return_annotation == concrete_sig.return_annotation
+                    )
+                })
+
+            analysis[method] = entry
+
+        abstract_properties = self._abstract_reflexion.getAbstractProperties()
+        for prop in abstract_properties:
+            entry = {
+                'implemented': False,
+                'abstract_signature': None,
+                'concrete_signature': None,
+                'signature_match': False,
+                'type' : 'property'
+            }
+
+            if hasattr(self._instance, prop):
+                entry['implemented'] = True
+                abstract_sig = self._abstract_reflexion.getPropertySignature(prop)
+                concrete_sig = self._concrete_reflexion.getPropertySignature(prop)
+
+                entry.update({
+                    'abstract_signature': abstract_sig,
+                    'concrete_signature': concrete_sig,
+                    'signature_match': (
+                        abstract_sig.parameters == concrete_sig.parameters and
+                        abstract_sig.return_annotation == concrete_sig.return_annotation
+                    )
+                })
+
+            analysis[prop] = entry
+
+        return analysis
+
+    def getNonInheritedImplementation(self) -> Dict[str, Any]:
+        """Get implementation details for methods, properties, and attributes not inherited from other parents.
 
         Returns
         -------
-        Dict[str, bool]
-            Dictionary mapping method names to compatibility status
-        """
-        compatibility = {}
-        overridden = self.getOverriddenMethods()
-
-        for method, (abstract_sig, concrete_sig) in overridden.items():
-            compatibility[method] = (
-                abstract_sig.parameters == concrete_sig.parameters and
-                abstract_sig.return_annotation == concrete_sig.return_annotation
-            )
-
-        return compatibility
-
-    def getAbstractProperties(self) -> Set[str]:
-        """Get all abstract properties from the parent class.
+        Dict[str, Any]
+            Dictionary containing:
+            - 'methods': List of non-inherited method names
+            - 'properties': List of non-inherited property names
+            - 'attributes': Dict of non-inherited attributes
+        """
+        # Get all members from concrete class (non-inherited methods, properties, and attributes)
+        concrete_members = set(dir(self._instance.__class__))
+
+        # Get members from the abstract class (base class)
+        base_members = set(dir(self._abstract))
+
+        # Filter out inherited members (methods, properties, and attributes)
+        non_inherited_methods = [
+            name for name in concrete_members
+            if callable(getattr(self._instance.__class__, name)) and name not in base_members
+        ]
+
+        non_inherited_properties = [
+            name for name in concrete_members
+            if isinstance(getattr(self._instance.__class__, name, None), property) and name not in base_members
+        ]
+
+        non_inherited_attributes = {
+            name: getattr(self._instance.__class__, name)
+            for name in concrete_members
+            if not callable(getattr(self._instance.__class__, name)) and not isinstance(getattr(self._instance.__class__, name, None), property) and name not in base_members
+        }
 
-        Returns
-        -------
-        Set[str]
-            Set of abstract property names
-        """
         return {
-            name for name, member in inspect.getmembers(
-                self._abstract,
-                lambda x: isinstance(x, property) and 
-                name in getattr(self._abstract, '__abstractmethods__', set())
-            )
+            'methods': non_inherited_methods,
+            'properties': non_inherited_properties,
+            'attributes': non_inherited_attributes
         }
 
-    def getInstanceAttributes(self) -> Dict[str, Any]:
-        """Get all attributes of the concrete instance.
+    def validateImplementation(self) -> Tuple[bool, Dict[str, List[str]]]:
+        """Validate the implementation against the abstract base.
 
         Returns
         -------
-        Dict[str, Any]
-            Dictionary of attribute names and their values
+        Tuple[bool, Dict[str, List[str]]]
+            - First element: True if fully valid implementation
+            - Second element: Dictionary of issues by category:
+                * 'missing': Missing required methods
+                * 'signature_mismatch': Methods with signature mismatches
+                * 'type_mismatch': Methods with return type mismatches
         """
-        return vars(self._instance)
-
-    def getAbstractClassDocstring(self) -> Optional[str]:
-        """Get the docstring of the abstract parent class.
-
-        Returns
-        -------
-        Optional[str]
-            The abstract class docstring, or None if not available
-        """
-        return self._abstract.__doc__
-
-    def getConcreteClassDocstring(self) -> Optional[str]:
-        """Get the docstring of the concrete instance's class.
-
-        Returns
-        -------
-        Optional[str]
-            The concrete class docstring, or None if not available
-        """
-        return self._instance.__class__.__doc__
-
-    def getAbstractClassModule(self) -> str:
-        """Get the module name where the abstract class is defined.
-
-        Returns
-        -------
-        str
-            The module name of the abstract class
-        """
-        return self._abstract.__module__
-
-    def getConcreteClassModule(self) -> str:
-        """Get the module name where the concrete class is defined.
-
-        Returns
-        -------
-        str
-            The module name of the concrete class
-        """
-        return self._instance.__class__.__module__
-
-    def isDirectSubclass(self) -> bool:
-        """Check if the concrete class directly inherits from the abstract class.
-
-        Returns
-        -------
-        bool
-            True if direct subclass, False otherwise
-        """
-        return self._abstract in self._instance.__class__.__bases__
+        issues = {
+            'missing': [],
+            'signature_mismatch': [],
+            'type_mismatch': []
+        }
 
-    def getAbstractClassHierarchy(self) -> List[Type]:
-        """Get the inheritance hierarchy of the abstract class.
+        analysis = self.getImplementationAnalysis()
+        for method, data in analysis.items():
+            if not data['implemented']:
+                issues['missing'].append(method)
+            elif not data['signature_match']:
+                issues['signature_mismatch'].append(method)
+                # Check specifically for return type mismatch
+                abstract_return = data['abstract_signature'].return_annotation
+                concrete_return = data['concrete_signature'].return_annotation
+                if abstract_return != concrete_return and abstract_return is not inspect.Parameter.empty:
+                    issues['type_mismatch'].append(method)
 
-        Returns
-        -------
-        List[Type]
-            List of classes in the inheritance hierarchy
-        """
-        return inspect.getmro(self._abstract)
+        is_valid = not any(issues.values())
+        return (is_valid, issues)
 
-    def getConcreteClassHierarchy(self) -> List[Type]:
-        """Get the inheritance hierarchy of the concrete class.
+    def getHierarchyAnalysis(self) -> Dict[str, List[str]]:
+        """Analyze the class hierarchy relationships.
 
         Returns
         -------
-        List[Type]
-            List of classes in the inheritance hierarchy
+        Dict[str, List[str]]
+            Dictionary containing:
+            - 'concrete_hierarchy': List of class names in concrete hierarchy
+            - 'abstract_hierarchy': List of class names in abstract hierarchy
+            - 'common_ancestors': List of common ancestor class names
         """
-        return inspect.getmro(self._instance.__class__)
+        concrete_hierarchy = [cls.__name__ for cls in inspect.getmro(self._instance.__class__)]
+        abstract_hierarchy = [cls.__name__ for cls in inspect.getmro(self._abstract)]
 
-    def getCommonBaseClasses(self) -> List[Type]:
-        """Get base classes common to both abstract and concrete classes.
-
-        Returns
-        -------
-        List[Type]
-            List of common base classes
-        """
-        abstract_bases = set(inspect.getmro(self._abstract))
         concrete_bases = set(inspect.getmro(self._instance.__class__))
-        return list(abstract_bases & concrete_bases - {self._abstract, object})
-
-    def getAbstractClassSource(self) -> Optional[str]:
-        """Get the source code of the abstract class.
-
-        Returns
-        -------
-        Optional[str]
-            The source code if available, None otherwise
-        """
-        try:
-            return inspect.getsource(self._abstract)
-        except (TypeError, OSError):
-            return None
-
-    def getConcreteClassSource(self) -> Optional[str]:
-        """Get the source code of the concrete class.
+        abstract_bases = set(inspect.getmro(self._abstract))
+        common = concrete_bases & abstract_bases - {self._abstract, object}
 
-        Returns
-        -------
-        Optional[str]
-            The source code if available, None otherwise
-        """
-        try:
-            return inspect.getsource(self._instance.__class__)
-        except (TypeError, OSError):
-            return None
+        return {
+            'concrete_hierarchy': concrete_hierarchy,
+            'abstract_hierarchy': abstract_hierarchy,
+            'common_ancestors': [cls.__name__ for cls in common]
+        }
 
-    def getAbstractClassFile(self) -> Optional[str]:
-        """Get the file location of the abstract class definition.
+    def getImplementationCoverage(self) -> float:
+        """Calculate the percentage of abstract methods implemented.
 
         Returns
         -------
-        Optional[str]
-            The file path if available, None otherwise
+        float
+            Implementation coverage percentage (0.0 to 1.0)
         """
-        try:
-            return inspect.getfile(self._abstract)
-        except (TypeError, OSError):
-            return None
-
-    def getConcreteClassFile(self) -> Optional[str]:
-        """Get the file location of the concrete class definition.
+        attr = self.getImplementationAnalysis()
+        attr_len = len(attr) * 2
+        attr_implemented = 0
+        for method in attr.values():
+            if method.get('implemented'):
+                attr_implemented += 2 if method.get('signature_match') else 1
 
-        Returns
-        -------
-        Optional[str]
-            The file path if available, None otherwise
-        """
-        try:
-            return inspect.getfile(self._instance.__class__)
-        except (TypeError, OSError):
-            return None
+        return attr_implemented / attr_len if attr_len > 0 else 0.0

{orionis-0.206.0.dist-info → orionis-0.208.0.dist-info}/METADATA

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

{orionis-0.206.0.dist-info → orionis-0.208.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console.py,sha256=4gYWxf0fWYgJ4RKwARvnTPh06FL3GJ6SAZ7R2NzOICw,1342
-orionis/framework.py,sha256=QxS4x7KjzkvUswd2zt7Ceqeq9NxjSZjDVH7sKtcIvL8,1469
+orionis/framework.py,sha256=f9Ehyig7U1LRiEgdsm4-gGL1bjHiiwYNZJN0A-D3fio,1469
 orionis/installer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/installer/manager.py,sha256=Li4TVziRXWfum02xNG4JHwbnLk-u8xzHjdqKz-D894k,2755
 orionis/installer/output.py,sha256=7O9qa2xtXMB_4ZvVi-Klneom9YazwygAd_4uYAoxhbU,8548
@@ -171,11 +171,11 @@ orionis/luminate/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQ
 orionis/luminate/support/inspection/container_integrity.py,sha256=6d9FsGk-Rm1AXgqBS3Nww49dR7n1ptXTTNyGUuBHgNY,10111
 orionis/luminate/support/inspection/functions.py,sha256=XVDLdygONcfDNlH7CZ6muNdtYHLgNp5RybqC3smL4Y4,6400
 orionis/luminate/support/inspection/reflection.py,sha256=x_UHBY9pBSKgct13-u1WbhoONqLoGG60OpgoCsKE0AI,20368
-orionis/luminate/support/inspection/reflexion_abstract.py,sha256=yZTl_oZACjlXKKPmQimGsfre3qQUO2hbNDf7PJ4gKZE,7661
+orionis/luminate/support/inspection/reflexion_abstract.py,sha256=U_VAGQN0ZDMgjxYPhNrLxFt6F8_-8zXcA_B5djTV4GE,10731
 orionis/luminate/support/inspection/reflexion_concrete.py,sha256=0WOlLeTWLwMeAUReoaJetqlnT1_TxW_jMnbk_yXRR0g,549
 orionis/luminate/support/inspection/reflexion_concrete_with_abstract.py,sha256=ZuAFoSPkgbOFMIbVR0hvlkKsm1dIpY1_bsXxZxvXcmU,801
-orionis/luminate/support/inspection/reflexion_instance.py,sha256=k6bpRYjLeTUDqquluYrDZUtBLpLuGe4wm7PMUM8Sz-E,9914
-orionis/luminate/support/inspection/reflexion_instance_with_abstract.py,sha256=dag6QdVp1CydREWdpQvzAyOPX3q-lSb0_XzB0u3odQE,9629
+orionis/luminate/support/inspection/reflexion_instance.py,sha256=LNAgw4sZvHT7UMiObHTGk7xgqpIeKYHAQRgRpuPfEas,10842
+orionis/luminate/support/inspection/reflexion_instance_with_abstract.py,sha256=PI_VSH8baxjPgheOYc9tQAlLq9mjxGm5zCOr-bLVksg,9406
 orionis/luminate/support/inspection/reflexion_module.py,sha256=OgBXpqNJHkmq-gX4rqFStv-WVNe9R38RsgUgfHpak8k,405
 orionis/luminate/support/inspection/reflexion_module_with_classname.py,sha256=YZHZI0XUZkSWnq9wrGxrIXtI64nY9yVSZoMe7PZXq8Y,620
 orionis/luminate/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -199,12 +199,16 @@ tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/test_example.py,sha256=MNYissCEa0mzx1YA2gTiqXRX8r2v_vfB_Ew0jBFmBag,556
 tests/support/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/support/inspection/test_reflection_instance.py,sha256=aYi4qmuAzQ4-gAUrtc9Lx6gNR4Mw4GcOF_T8iWsWZoQ,7266
+tests/support/inspection/test_reflection_abstract.py,sha256=eralQ9DKyEFEZWl97J4YOTpkYBccMfQpwoPLC1OWapA,9233
+tests/support/inspection/test_reflection_instance.py,sha256=46mO4drWsfKKVPuCjUbKeVmw16uBDk-eVhc0idzCd_w,6978
+tests/support/inspection/test_reflection_instance_with_abstract.py,sha256=HZn7BOtlHtKeIgJ2KATSQq9kjEPqhq5NtoNY7HQU0y0,4096
 tests/support/inspection/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/support/inspection/fakes/fake_reflection.py,sha256=G16rZdJWC3L8SGEQkmwktvw4n7IAusIIx9Tm-ZFLcg4,1419
-orionis-0.206.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.206.0.dist-info/METADATA,sha256=rpiw7sbXAHLEJ6HEEGVgBfG3C4qyEGXiDzH0SAi6Ucg,3003
-orionis-0.206.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.206.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.206.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.206.0.dist-info/RECORD,,
+tests/support/inspection/fakes/fake_reflection_abstract.py,sha256=7qtz44brfFzE4oNYi9kIsvdWP79nP2FnzSz-0bU__pg,5045
+tests/support/inspection/fakes/fake_reflection_instance.py,sha256=G16rZdJWC3L8SGEQkmwktvw4n7IAusIIx9Tm-ZFLcg4,1419
+tests/support/inspection/fakes/fake_reflection_instance_with_abstract.py,sha256=SfL8FuFmr650RlzXTrP4tGMfsPVZLhOxVnBXu_g1POg,1471
+orionis-0.208.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.208.0.dist-info/METADATA,sha256=QTcA2C1AAfSDvSXVYX8W8515ffwiWK5SKavkRrIYoFQ,3003
+orionis-0.208.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.208.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.208.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.208.0.dist-info/RECORD,,