orionis 0.610.0__py3-none-any.whl → 0.612.0__py3-none-any.whl

orionis/metadata/framework.py

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

orionis/services/introspection/concretes/reflection.py

@@ -245,24 +245,56 @@ class ReflectionConcrete(IReflectionConcrete):
         """
         return self._concrete.__bases__
 
-    def getSourceCode(self) -> str:
+    def getSourceCode(self, method: str = None) -> str | None:
         """
-        Get the source code of the reflected class.
+        Retrieve the source code for the reflected class or a specific method.
+
+        Parameters
+        ----------
+        method : str, optional
+            The name of the method whose source code should be retrieved. If not provided,
+            the source code of the entire class is returned. If the method name refers to a
+            private method, Python name mangling is handled automatically.
 
         Returns
         -------
-        str
-            The complete source code of the class definition.
+        str or None
+            The source code as a string if available. Returns None if the source code cannot
+            be found (e.g., for built-in or dynamically generated classes/methods), or if the
+            specified method does not exist.
 
-        Raises
-        ------
-        ReflectionValueError
-            If the source code cannot be retrieved (e.g., built-in classes).
+        Notes
+        -----
+        - If `method` is specified and refers to a private method, name mangling is handled automatically.
+        - If the source code cannot be found (e.g., for built-in or dynamically generated classes/methods), None is returned.
+        - If the specified method does not exist in the class, None is returned.
         """
+
         try:
-            return inspect.getsource(self._concrete)
-        except OSError as e:
-            raise ReflectionValueError(f"Could not retrieve source code for '{self._concrete.__name__}': {e}")
+
+            # Return the source code of the entire class
+            if not method:
+                return inspect.getsource(self._concrete)
+
+            # Handle private method name mangling for methods starting with double underscore
+            else:
+
+                # Handle private method name mangling
+                if method.startswith("__") and not method.endswith("__"):
+                    class_name = self.getClassName()
+                    method = f"_{class_name}{method}"
+
+                # Check if the method exists in the class
+                if not self.hasMethod(method):
+                    return None
+
+                # Return the source code of the specified method
+                return inspect.getsource(getattr(self._concrete, method))
+
+        except (TypeError, OSError):
+
+            # Return None if the source code cannot be retrieved (e.g., built-in or dynamic)
+            return None
 
     def getFile(self) -> str:
         """
@@ -438,25 +470,36 @@ class ReflectionConcrete(IReflectionConcrete):
 
     def getAttributes(self) -> dict:
         """
-        Get all class attributes regardless of visibility.
+        Retrieve all class attributes across all visibility levels.
 
-        Combines public, protected, private, and dunder attributes into a
-        single dictionary for comprehensive attribute access.
+        This method aggregates and returns a dictionary containing all attributes
+        defined on the reflected class, including public, protected, private (with
+        name mangling resolved), and dunder (magic) attributes. Callable members,
+        static methods, class methods, and properties are excluded from the result.
 
         Returns
         -------
         dict
-            A dictionary mapping attribute names to their values, including
-            all visibility levels (public, protected, private, dunder).
+            A dictionary mapping attribute names (as strings) to their corresponding
+            values. The dictionary includes attributes of all visibility levels:
+            public, protected, private (with name mangling removed), and dunder
+            attributes, but excludes methods and properties. The result is cached
+            after the first call for performance.
         """
 
-        # Combine all attribute types into a single dictionary
-        return {
-            **self.getPublicAttributes(),
-            **self.getProtectedAttributes(),
-            **self.getPrivateAttributes(),
-            **self.getDunderAttributes()
-        }
+        # Use cache to avoid recomputation on subsequent calls
+        if not hasattr(self, "_ReflectionConcrete__cacheGetAttributes"):
+
+            # Merge all attribute dictionaries from different visibility levels
+            self.__cacheGetAttributes = {
+                **self.getPublicAttributes(),
+                **self.getProtectedAttributes(),
+                **self.getPrivateAttributes(),
+                **self.getDunderAttributes()
+            }
+
+        # Return the cached dictionary of all attributes
+        return self.__cacheGetAttributes
 
     def getPublicAttributes(self) -> dict:
         """
@@ -769,27 +812,36 @@ class ReflectionConcrete(IReflectionConcrete):
 
     def getMethods(self) -> List[str]:
         """
-        Get all method names from the reflected class.
+        Retrieve all method names defined in the reflected class, including instance, class, and static methods.
 
-        Combines all types of methods including instance methods, class methods,
-        and static methods with different visibility levels.
+        This method aggregates method names from all visibility levels (public, protected, private) and method types
+        (instance, class, static). The result is cached after the first call to improve performance on subsequent calls.
 
         Returns
         -------
         List[str]
-            A comprehensive list of all method names in the class.
-        """
-        return [
-            *self.getPublicMethods(),
-            *self.getProtectedMethods(),
-            *self.getPrivateMethods(),
-            *self.getPublicClassMethods(),
-            *self.getProtectedClassMethods(),
-            *self.getPrivateClassMethods(),
-            *self.getPublicStaticMethods(),
-            *self.getProtectedStaticMethods(),
-            *self.getPrivateStaticMethods(),
-        ]
+            A list containing the names of all methods (instance, class, and static) defined in the class,
+            including public, protected, and private methods. The list is cached for efficiency.
+        """
+
+        # Check if the method names have already been cached
+        if not hasattr(self, "_ReflectionConcrete__cacheGetMethods"):
+
+            # Aggregate all method names from different categories and cache the result
+            self.__cacheGetMethods = [
+                *self.getPublicMethods(),
+                *self.getProtectedMethods(),
+                *self.getPrivateMethods(),
+                *self.getPublicClassMethods(),
+                *self.getProtectedClassMethods(),
+                *self.getPrivateClassMethods(),
+                *self.getPublicStaticMethods(),
+                *self.getProtectedStaticMethods(),
+                *self.getPrivateStaticMethods(),
+            ]
+
+        # Return the cached list of method names
+        return self.__cacheGetMethods
 
     def getPublicMethods(self) -> list:
         """

orionis/services/introspection/instances/reflection.py

@@ -189,18 +189,52 @@ class ReflectionInstance(IReflectionInstance):
         """
         return self._instance.__class__.__bases__
 
-    def getSourceCode(self) -> Optional[str]:
+    def getSourceCode(self, method: str = None) -> Optional[str]:
         """
-        Get the source code of the instance's class.
+        Retrieve the source code of the instance's class or a specific method.
+
+        Parameters
+        ----------
+        method : str, optional
+            The name of the method whose source code should be retrieved. If not provided,
+            the source code of the entire class is returned.
 
         Returns
         -------
         Optional[str]
-            The source code if available, None otherwise
+            The source code as a string if available; otherwise, None.
+
+        Raises
+        ------
+        None
+            This method does not raise exceptions; it returns None if the source code cannot be retrieved.
+
+        Notes
+        -----
+        - If `method` is specified and refers to a private method, name mangling is handled automatically.
+        - If the source code cannot be found (e.g., for built-in or dynamically generated classes/methods), None is returned.
         """
         try:
-            return inspect.getsource(self._instance.__class__)
+            if not method:
+                # Return the source code of the class
+                return inspect.getsource(self._instance.__class__)
+            else:
+
+                # Handle private method name mangling
+                if method.startswith("__") and not method.endswith("__"):
+                    class_name = self.getClassName()
+                    method = f"_{class_name}{method}"
+
+                # Check if the method exists
+                if not self.hasMethod(method):
+                    return None
+
+                # Return the source code of the specified method
+                return inspect.getsource(getattr(self._instance.__class__, method))
+
         except (TypeError, OSError):
+
+            # Return None if the source code cannot be retrieved
             return None
 
     def getFile(self) -> Optional[str]:
@@ -340,19 +374,38 @@ class ReflectionInstance(IReflectionInstance):
 
     def getAttributes(self) -> Dict[str, Any]:
         """
-        Get all attributes of the instance, including public, private, protected, and dunder attributes.
+        Retrieve all attributes of the instance, including public, protected, private, and dunder (magic) attributes.
+
+        This method aggregates attributes from all visibility levels by combining the results of
+        `getPublicAttributes`, `getProtectedAttributes`, `getPrivateAttributes`, and `getDunderAttributes`.
+        The result is cached for subsequent calls to improve performance.
 
         Returns
         -------
         Dict[str, Any]
-            Dictionary of all attribute names and their values
+            A dictionary mapping attribute names (as strings) to their corresponding values for all
+            attributes of the instance, including public, protected, private, and dunder attributes.
+
+        Notes
+        -----
+        - The returned dictionary includes all instance attributes, regardless of their visibility.
+        - Private attribute names are unmangled (class name prefix is removed).
+        - The result is cached in the instance to avoid redundant computation on repeated calls.
         """
-        return {
-            **self.getPublicAttributes(),
-            **self.getProtectedAttributes(),
-            **self.getPrivateAttributes(),
-            **self.getDunderAttributes()
-        }
+
+        # Check if the cache for attributes exists; if not, compute and store it
+        if not hasattr(self, "_ReflectionInstance__cacheGetAttributes"):
+
+            # Merge all attribute dictionaries from different visibility levels
+            self.__cacheGetAttributes = {
+                **self.getPublicAttributes(),
+                **self.getProtectedAttributes(),
+                **self.getPrivateAttributes(),
+                **self.getDunderAttributes()
+            }
+
+        # Return the cached dictionary of attributes
+        return self.__cacheGetAttributes
 
     def getPublicAttributes(self) -> Dict[str, Any]:
         """
@@ -634,24 +687,44 @@ class ReflectionInstance(IReflectionInstance):
 
     def getMethods(self) -> List[str]:
         """
-        Get all method names of the instance.
+        Retrieve all method names associated with the instance, including public, protected, private,
+        class, and static methods.
+
+        This method aggregates method names from various categories (public, protected, private, class,
+        and static) by calling the corresponding getter methods. The result is cached for subsequent calls
+        to improve performance.
 
         Returns
         -------
         List[str]
-            List of method names
-        """
-        return [
-            *self.getPublicMethods(),
-            *self.getProtectedMethods(),
-            *self.getPrivateMethods(),
-            *self.getPublicClassMethods(),
-            *self.getProtectedClassMethods(),
-            *self.getPrivateClassMethods(),
-            *self.getPublicStaticMethods(),
-            *self.getProtectedStaticMethods(),
-            *self.getPrivateStaticMethods(),
-        ]
+            A list containing the names of all methods (instance, class, and static) defined on the instance's class,
+            including public, protected, and private methods.
+
+        Notes
+        -----
+        - The returned list includes method names from all visibility levels (public, protected, private),
+          as well as class and static methods.
+        - The result is cached in the instance to avoid redundant computation on repeated calls.
+        """
+
+        # Check if the cache for method names exists; if not, compute and store it
+        if not hasattr(self, "_ReflectionInstance__cacheGetMethods"):
+
+            # Compute and cache the list of method names
+            self.__cacheGetMethods = [
+                *self.getPublicMethods(),
+                *self.getProtectedMethods(),
+                *self.getPrivateMethods(),
+                *self.getPublicClassMethods(),
+                *self.getProtectedClassMethods(),
+                *self.getPrivateClassMethods(),
+                *self.getPublicStaticMethods(),
+                *self.getProtectedStaticMethods(),
+                *self.getPrivateStaticMethods(),
+            ]
+
+        # Return the cached list of method names
+        return self.__cacheGetMethods
 
     def getPublicMethods(self) -> List[str]:
         """

orionis/test/core/unit_test.py

@@ -638,12 +638,13 @@ class UnitTest(IUnitTest):
         test_case: unittest.TestCase
     ) -> bool:
         """
-        Check if the given test case contains any debugging or dump calls.
+        Determine if the given test case contains debugging or dump calls.
 
-        This method inspects the source code of the provided test case to determine
-        whether it contains any lines that invoke debugging or dump functions, as
-        specified by the internal `__debbug_keywords` list (e.g., 'self.dd', 'self.dump').
-        It ignores commented lines and only considers actual code statements.
+        This method inspects the source code of the test method and common setup/teardown methods
+        (such as `setUp`, `tearDown`, `onSetup`, `onTeardown`) for the presence of any keywords
+        specified in the internal `__debbug_keywords` list (e.g., 'self.dd', 'self.dump').
+        Commented lines are ignored during inspection. If any debug keyword is found, the method
+        disables live console output and returns True.
 
         Parameters
         ----------
@@ -653,48 +654,66 @@ class UnitTest(IUnitTest):
         Returns
         -------
         bool
-            True if any debug or dump keyword is found in the test case source code,
-            or if the internal debug flag (`__debbug`) is set. False otherwise.
+            True if any debug or dump keyword is found in the test case source code;
+            False otherwise.
 
         Notes
         -----
-        - The method uses reflection to retrieve the source code of the test case.
-        - Lines that are commented out are skipped during inspection.
-        - If an error occurs during source code retrieval or inspection, the method returns False.
+        - Uses `inspect.getsource` to retrieve the source code of relevant methods.
+        - Ignores lines that are commented out.
+        - If an error occurs during source code retrieval or inspection, returns False.
+        - If a debug keyword is found, disables live console output for the test run.
         """
-
         try:
 
-            # Retrieve the source code of the test case using reflection
-            method_name = getattr(test_case, "_testMethodName", None)
+            # Gather method names to inspect: main test method and common setup/teardown hooks
+            rf_instance = ReflectionInstance(test_case)
+            method_name = rf_instance.getAttribute("_testMethodName")
+            extra_methods = ["setUp", "tearDown", "onSetup", "onTeardown"]
+            method_names_to_check = [method_name] if method_name else []
+            method_names_to_check += [m for m in extra_methods if rf_instance.hasMethod(m)]
+
+            # Inspect each method's source code for debug keywords
+            for mname in method_names_to_check:
+
+                # Skip if method name is None
+                if not mname:
+                    continue
 
-            # If a method name is found, proceed to inspect its source code
-            if method_name:
+                try:
 
-                # Get the source code of the specific test method
-                source = inspect.getsource(getattr(test_case, method_name))
+                    # Retrieve the source code of the method
+                    source = rf_instance.getSourceCode(mname)
 
-                # Check each line of the source code
+                except Exception:
+
+                    # Skip if source cannot be retrieved
+                    continue
+
+                # Inspect each line of the source code
                 for line in source.splitlines():
 
-                    # Strip leading and trailing whitespace from the line
+                    # Strip leading/trailing whitespace for accurate matching
                     stripped = line.strip()
 
-                    # Skip lines that are commented out
+                    # Ignore commented lines
                     if stripped.startswith('#') or re.match(r'^\s*#', line):
                         continue
 
-                    # If any debug keyword is present in the line, return True
+                    # Check for any debug keyword in the line
                     if any(keyword in line for keyword in self.__debbug_keywords):
-                        self.__live_console = False if self.__live_console is True else self.__live_console
+
+                        # Disable live console output if a debug keyword is found
+                        if self.__live_console is True:
+                            self.__live_console = False
                         return True
 
         except Exception:
 
-            # If any error occurs during inspection, return False
+            # On any error during inspection, return False
             return False
 
-        # No debug keywords found; return False
+        # No debug keywords found in any inspected method
         return False
 
     def run(

{orionis-0.610.0.dist-info → orionis-0.612.0.dist-info}/METADATA

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

{orionis-0.610.0.dist-info → orionis-0.612.0.dist-info}/RECORD

@@ -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=Wxis51jOBs0Ly2h4yTGyRz9ppSd_oFXruIJ6t-B0j74,4109
+orionis/metadata/framework.py,sha256=3faHOXLyiFX9kf9mI3YWJzOninqiFserHDv_3OwGUps,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
@@ -267,7 +267,7 @@ orionis/services/introspection/callables/reflection.py,sha256=zzxrjExc2iIlfs3xfo
 orionis/services/introspection/callables/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/callables/contracts/reflection.py,sha256=EZi9VfTf5GJBnMd47j_oJ8dENQ5-HzDbQ-4zSffrvpM,5523
 orionis/services/introspection/concretes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/concretes/reflection.py,sha256=vKgkDfIbuRYH4iTcHaYoHIAMalZfGjmJ_tYTG7mhsbQ,56823
+orionis/services/introspection/concretes/reflection.py,sha256=WINn-MAaMBLz36jUh26mWi_X-TMoaHfE-QhkUtBIZ4c,59768
 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/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -280,7 +280,7 @@ orionis/services/introspection/dependencies/entities/resolve_argument.py,sha256=
 orionis/services/introspection/exceptions/__init__.py,sha256=uVRbnndapr9veJps8EzFJeLItxnMEbjUDdPBy3dQbeM,221
 orionis/services/introspection/exceptions/introspection.py,sha256=Qd021psWiXyY9HQVNWIBVZ3KNfHGSgq8NL4btUTR8tg,2532
 orionis/services/introspection/instances/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/instances/reflection.py,sha256=WTkHHST8DIjKV_-DygzOsx2IA7yL5aqkr0Zn6EWm2Xo,54809
+orionis/services/introspection/instances/reflection.py,sha256=RZTgrHnd_oWSZGQ2lHmsj03QkQxkzR3yuv5bg8Hl7Ck,58495
 orionis/services/introspection/instances/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/instances/contracts/reflection.py,sha256=OBZ7vI6KsII76oqIF63v1I-msh94_xGfhPZQvqAVLgY,20834
 orionis/services/introspection/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -371,7 +371,7 @@ orionis/test/contracts/render.py,sha256=wpDQzUtT0r8KFZ7zPcxWHXQ1EVNKxzA_rZ6ZKUcZ
 orionis/test/contracts/test_result.py,sha256=SNXJ2UerkweYn7uCT0i0HmMGP0XBrL_9KJs-0ZvIYU4,4002
 orionis/test/contracts/unit_test.py,sha256=EyidHoOPJItwgkBWGYY1TymbNklyn2EUXnghVvW4htc,4652
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/core/unit_test.py,sha256=5KaCu8anWP9Ei-Axd61roCogpoo1Frs81h1Rug3RbBw,70920
+orionis/test/core/unit_test.py,sha256=P7AKazQWa-2TNjfqdiVEgVMpTgVn7k3l8RwO1C6Uq3w,71671
 orionis/test/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/entities/result.py,sha256=eZ6UIqGmFW8FZ9x8PB_MZbLAc-SAuUyi4FUcMYIZzGo,4777
 orionis/test/enums/__init__.py,sha256=M3imAgMvKFTKg55FbtVoY3zxj7QRY9AfaUWxiSZVvn4,66
@@ -404,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.610.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.610.0.dist-info/METADATA,sha256=XTzhBWyc4DB5ULxSGO9ocB7nY98Zj29vUafUbLjzbT4,4801
-orionis-0.610.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.610.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.610.0.dist-info/RECORD,,
+orionis-0.612.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.612.0.dist-info/METADATA,sha256=GaMIB8MG9eN4CaF-PjiClO-1KsVWFLY6YA9SMmeBjT0,4801
+orionis-0.612.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.612.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.612.0.dist-info/RECORD,,