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

orionis/framework.py

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

orionis/luminate/support/inspection/reflexion_abstract.py

@@ -1,7 +1,8 @@
-from typing import Any, Type, Dict, List, Tuple, Callable, Optional, TypeVar, Set
-import inspect
 import abc
-from functools import wraps
+import ast
+import inspect
+import types
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type, TypeVar
 
 ABC = TypeVar('ABC', bound=abc.ABC)
 
@@ -51,7 +52,26 @@ class ReflexionAbstract:
         Set[str]
             Set of abstract method names
         """
-        return {name for name, _ in self._abstract.__abstractmethods__}
+        methods = []
+        for method in self._abstract.__abstractmethods__:
+            if not isinstance(getattr(self._abstract, method), property):
+                methods.append(method)
+        return set(methods)
+
+    def getAbstractProperties(self) -> Set[str]:
+        """Get all abstract property names required by the class.
+
+        Returns
+        -------
+        Set[str]
+            Set of abstract property names
+        """
+        properties = []
+        for name in getattr(self._abstract, '__abstractmethods__', set()):
+            attr = getattr(self._abstract, name, None)
+            if isinstance(attr, property):
+                properties.append(name)
+        return set(properties)
 
     def getConcreteMethods(self) -> Dict[str, Callable]:
         """Get all concrete methods implemented in the abstract class.
@@ -88,13 +108,32 @@ class ReflexionAbstract:
         Returns
         -------
         List[str]
-            List of class method names
+            List of class method names, excluding private/protected methods (starting with '_')
+
+        Notes
+        -----
+        - Uses inspect.getattr_static to avoid method binding
+        - Properly handles both @classmethod decorator and classmethod instances
+        - Filters out private/protected methods (starting with '_')
+
+        Examples
+        --------
+        >>> class MyAbstract(ABC):
+        ...     @classmethod
+        ...     def factory(cls): pass
+        ...     @classmethod
+        ...     def _protected_factory(cls): pass
+        >>> reflex = ReflexionAbstract(MyAbstract)
+        >>> reflex.getClassMethods()
+        ['factory']
         """
         return [
-            name for name, member in inspect.getmembers(
-                self._abstract,
-                predicate=lambda x: isinstance(x, classmethod))
-            if not name.startswith('_')
+            name for name in dir(self._abstract)
+            if not name.startswith('_') and
+            isinstance(
+                inspect.getattr_static(self._abstract, name),
+                (classmethod, types.MethodType)
+            )
         ]
 
     def getProperties(self) -> List[str]:
@@ -131,7 +170,31 @@ class ReflexionAbstract:
             If the method doesn't exist
         """
         method = getattr(self._abstract, methodName)
-        return inspect.signature(method)
+        if callable(method):
+            return inspect.signature(method)
+
+    def getPropertySignature(self, propertyName: str) -> inspect.Signature:
+        """Get the signature of an abstract property's getter.
+
+        Parameters
+        ----------
+        propertyName : str
+            Name of the abstract property
+
+        Returns
+        -------
+        inspect.Signature
+            The getter signature of the abstract property
+
+        Raises
+        ------
+        AttributeError
+            If the property doesn't exist or is not an abstract property
+        """
+        attr = getattr(self._abstract, propertyName, None)
+        if isinstance(attr, property) and attr.fget is not None:
+            return inspect.signature(attr.fget)
+        raise AttributeError(f"{propertyName} is not an abstract property or doesn't have a getter.")
 
     def getDocstring(self) -> Optional[str]:
         """Get the docstring of the abstract class.
@@ -153,7 +216,7 @@ class ReflexionAbstract:
         """
         return tuple(
             base for base in self._abstract.__bases__
-            if inspect.isabstract(base)
+            if inspect.isabstract(base) or issubclass(base, abc.ABC) or isinstance(base, abc.ABCMeta)
         )
 
     def getInterfaceMethods(self) -> Dict[str, inspect.Signature]:
@@ -220,29 +283,48 @@ class ReflexionAbstract:
         """
         return self._abstract.__annotations__
 
-    def getDecorators(self, method_name: str) -> List[Callable]:
-        """Get decorators applied to a method.
+    def getDecorators(self, method_name: str) -> List[str]:
+        """
+        Get decorators applied to a method.
 
         Parameters
         ----------
         method_name : str
-            Name of the method
-
-        Returns
-        -------
-        List[Callable]
-            List of decorator functions
+            Name of the method to inspect
         """
-        method = getattr(self._abstract, method_name)
-        decorators = []
+        method = getattr(self._abstract, method_name, None)
+        if method is None:
+            return []
 
-        if hasattr(method, '__wrapped__'):
-            # Unwrap decorated functions
-            while hasattr(method, '__wrapped__'):
-                decorators.append(method)
-                method = method.__wrapped__
-
-        return decorators
+        try:
+            source = inspect.getsource(self._abstract)
+        except (OSError, TypeError):
+            return []
+
+        tree = ast.parse(source)
+
+        class DecoratorVisitor(ast.NodeVisitor):
+            def __init__(self):
+                self.decorators = []
+
+            def visit_FunctionDef(self, node):
+                if node.name == method_name:
+                    for deco in node.decorator_list:
+                        if isinstance(deco, ast.Name):
+                            self.decorators.append(deco.id)
+                        elif isinstance(deco, ast.Call):
+                            # handles decorators with arguments like @deco(arg)
+                            if isinstance(deco.func, ast.Name):
+                                self.decorators.append(deco.func.id)
+                        elif isinstance(deco, ast.Attribute):
+                            self.decorators.append(deco.attr)
+                    # No need to visit deeper
+                    return
+
+        visitor = DecoratorVisitor()
+        visitor.visit(tree)
+
+        return visitor.decorators
 
     def isProtocol(self) -> bool:
         """Check if the abstract class is a Protocol.

orionis/luminate/support/inspection/reflexion_instance.py

@@ -198,7 +198,37 @@ class ReflexionInstance:
         '(x, y)'
         """
         method = getattr(self._instance, methodName)
-        return inspect.signature(method)
+        if callable(method):
+            return inspect.signature(method)
+
+    def getPropertySignature(self, propertyName: str) -> inspect.Signature:
+        """Get the signature of a property getter.
+
+        Parameters
+        ----------
+        propertyName : str
+            Name of the property
+
+        Returns
+        -------
+        inspect.Signature
+            The property's getter method signature
+
+        Raises
+        ------
+        AttributeError
+            If the property doesn't exist or is not a property
+
+        Examples
+        --------
+        >>> sig = reflex.getPropertySignature('config')
+        >>> str(sig)
+        '(self)'
+        """
+        attr = getattr(type(self._instance), propertyName, None)
+        if isinstance(attr, property) and attr.fget is not None:
+            return inspect.signature(attr.fget)
+        raise AttributeError(f"{propertyName} is not a property or doesn't have a getter.")
 
     def getDocstring(self) -> Optional[str]:
         """Get the docstring of the instance's class.