orionis 0.213.0__py3-none-any.whl → 0.216.0__py3-none-any.whl

orionis/luminate/support/standard/contracts/std.py

@@ -0,0 +1,127 @@
+from abc import ABC, abstractmethod
+from typing import Any, Dict
+
+class IStdClass(ABC):
+    """
+    Interface for a dynamic class that allows setting arbitrary attributes,
+    similar to PHP's stdClass.
+
+    Implementations should provide dynamic attribute access and management.
+    """
+
+    @abstractmethod
+    def __init__(self, **kwargs: Any) -> None:
+        """
+        Initializes the object with optional attributes.
+
+        Parameters
+        ----------
+        kwargs : Any
+            Key-value pairs to set as initial attributes.
+        """
+        pass
+
+    @abstractmethod
+    def __repr__(self) -> str:
+        """
+        Returns an unambiguous string representation of the object.
+
+        Returns
+        -------
+        str
+            A string that could be used to recreate the object.
+        """
+        pass
+
+    @abstractmethod
+    def __str__(self) -> str:
+        """
+        Returns a readable string representation of the object.
+
+        Returns
+        -------
+        str
+            A user-friendly string showing the object's attributes.
+        """
+        pass
+
+    @abstractmethod
+    def __eq__(self, other: Any) -> bool:
+        """
+        Compares two objects for equality based on their attributes.
+
+        Parameters
+        ----------
+        other : Any
+            The object to compare with.
+
+        Returns
+        -------
+        bool
+            True if both objects have the same attributes and values.
+        """
+        pass
+
+    @abstractmethod
+    def toDict(self) -> Dict[str, Any]:
+        """
+        Converts the object's attributes to a dictionary.
+
+        Returns
+        -------
+        Dict[str, Any]
+            A dictionary representation of the object's attributes.
+        """
+        pass
+
+    @abstractmethod
+    def update(self, **kwargs: Any) -> None:
+        """
+        Updates the object's attributes dynamically.
+
+        Parameters
+        ----------
+        kwargs : Any
+            Key-value pairs to update attributes.
+
+        Raises
+        ------
+        ValueError
+            If an attribute name is invalid or conflicts with existing methods.
+        """
+        pass
+
+    @abstractmethod
+    def remove(self, *attributes: str) -> None:
+        """
+        Removes one or more attributes from the object.
+
+        Parameters
+        ----------
+        *attributes : str
+            Names of the attributes to remove.
+
+        Raises
+        ------
+        AttributeError
+            If any of the attributes doesn't exist.
+        """
+        pass
+
+    @classmethod
+    @abstractmethod
+    def from_dict(cls, dictionary: Dict[str, Any]) -> 'IStdClass':
+        """
+        Creates an instance from a dictionary.
+
+        Parameters
+        ----------
+        dictionary : Dict[str, Any]
+            Dictionary to create the object from.
+
+        Returns
+        -------
+        IStdClass
+            A new instance with the dictionary's key-value pairs as attributes.
+        """
+        pass

orionis/luminate/support/standard/std.py

@@ -0,0 +1,137 @@
+from orionis.luminate.support.standard.contracts.std import IStdClass
+
+class StdClass(IStdClass):
+    """
+    A dynamic class that allows setting arbitrary attributes,
+    similar to PHP's stdClass.
+
+    Examples
+    --------
+    >>> obj = StdClass(name='Raul', age=30)
+    >>> obj.name
+    'Raul'
+    >>> obj.update(age=31)
+    >>> obj.toDict()
+    {'name': 'Raul', 'age': 31}
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes the StdClass with optional keyword arguments.
+
+        Parameters
+        ----------
+        kwargs : dict
+            Key-value pairs to set as attributes.
+        """
+        self.update(**kwargs)
+
+    def __repr__(self):
+        """
+        Returns an unambiguous string representation of the object.
+
+        Returns
+        -------
+        str
+            A string that could be used to recreate the object.
+        """
+        return f"{self.__class__.__name__}({self.__dict__})"
+
+    def __str__(self):
+        """
+        Returns a readable string representation of the object.
+
+        Returns
+        -------
+        str
+            A user-friendly string showing the object's attributes.
+        """
+        return str(self.__dict__)
+
+    def __eq__(self, other):
+        """
+        Compares two StdClass objects for equality based on their attributes.
+
+        Parameters
+        ----------
+        other : object
+            The object to compare with.
+
+        Returns
+        -------
+        bool
+            True if both objects have the same attributes and values.
+        """
+        if not isinstance(other, StdClass):
+            return False
+        return self.__dict__ == other.__dict__
+
+    def toDict(self):
+        """
+        Converts the object's attributes to a dictionary.
+
+        Returns
+        -------
+        dict
+            A dictionary representation of the object's attributes.
+        """
+
+        # Return a copy to avoid external modifications
+        return self.__dict__.copy()
+
+    def update(self, **kwargs):
+        """
+        Updates the object's attributes dynamically.
+
+        Parameters
+        ----------
+        kwargs : dict
+            Key-value pairs to update attributes.
+
+        Raises
+        ------
+        ValueError
+            If an attribute name is invalid or conflicts with existing methods.
+        """
+        for key, value in kwargs.items():
+            if key.startswith('__') and key.endswith('__'):
+                raise ValueError(f"Cannot set attribute with reserved name: {key}")
+            if hasattr(self.__class__, key):
+                raise ValueError(f"Cannot set attribute '{key}' as it conflicts with a class method")
+            setattr(self, key, value)
+
+    def remove(self, *attributes):
+        """
+        Removes one or more attributes from the object.
+
+        Parameters
+        ----------
+        *attributes : str
+            Names of the attributes to remove.
+
+        Raises
+        ------
+        AttributeError
+            If any of the attributes doesn't exist.
+        """
+        for attr in attributes:
+            if not hasattr(self, attr):
+                raise AttributeError(f"Attribute '{attr}' not found")
+            delattr(self, attr)
+
+    @classmethod
+    def from_dict(cls, dictionary):
+        """
+        Creates a StdClass instance from a dictionary.
+
+        Parameters
+        ----------
+        dictionary : dict
+            Dictionary to create the object from.
+
+        Returns
+        -------
+        StdClass
+            A new StdClass instance with the dictionary's key-value pairs as attributes.
+        """
+        return cls(**dictionary)

{orionis-0.213.0.dist-info → orionis-0.216.0.dist-info}/METADATA

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

{orionis-0.213.0.dist-info → orionis-0.216.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=h535GtyAp9Bsjr4Ao052lL6yCui73xb5BWR70PDbLig,1469
+orionis/framework.py,sha256=GQEposKTRMRQV49FKtBLhhmOc6z7-SAsQVK3KpYHHgM,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
@@ -39,7 +39,7 @@ orionis/luminate/console/exceptions/cli_exception.py,sha256=HsZ_vSeNiJWQ0gznVFNc
 orionis/luminate/console/exceptions/cli_runtime_error.py,sha256=DaCDGu6mXBk1LIzc7cwRROw1mePAigPNASjNZHhUSBE,1154
 orionis/luminate/console/exceptions/cli_schedule_exception.py,sha256=IBbXb_5zi02pyo1laHdjGn6FYZK7WWRp4j2fkZOCT6I,1161
 orionis/luminate/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/output/console.py,sha256=Qcv54W6YOLXP81C4YzatA2casmSQ1BQhUFHsbxJUjjs,18196
+orionis/luminate/console/output/console.py,sha256=FuNlI2sjmv14iYM80YQ3jMeUcVaNv0VqBhnfVdFEChA,18209
 orionis/luminate/console/output/executor.py,sha256=-efhCbWOS4ZqmRsO0s3j5NEbw4I9hVROF8Q3Atx77zs,3369
 orionis/luminate/console/output/progress_bar.py,sha256=ZiPGcUaN3EINeLRKgLGtS1GAb1XWlCDx7wFQ7Ff0hqY,3096
 orionis/luminate/console/output/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
@@ -107,7 +107,6 @@ orionis/luminate/contracts/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5J
 orionis/luminate/contracts/services/log/log_service.py,sha256=1RD3u-a5ZDMbg7AYE8y2SW8QNRybAU3De0mEA0dAeNo,2167
 orionis/luminate/contracts/support/exception_parse.py,sha256=P7yh5Q3KIcRPAZeg6190XbOSvu5XBK-VVt6zHxaiexw,779
 orionis/luminate/contracts/support/reflection.py,sha256=Ht5_FsFbCb-APRXX3HdsfKl3cDZU8DyXGXPWKTn05uQ,8429
-orionis/luminate/contracts/support/std.py,sha256=IihREHnJ_D2LqsrwtnGsIRYr0UsJsQezYPSPO6UaBQ4,992
 orionis/luminate/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/facades/app_facade.py,sha256=UzZ4n7N_Gz5MgYJvLethVUTp4gmYlubriYGtPXUxQxQ,893
 orionis/luminate/facades/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -162,20 +161,28 @@ orionis/luminate/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5N
 orionis/luminate/services/log/log_service.py,sha256=jrCrKz7Uj6n_ri-v5A4YOILQGUQ9MAmrlSizbbOvKhI,8303
 orionis/luminate/support/asyn_run.py,sha256=MTwVGNEnKRqD582oZRpUDQ141-hXoO5wc4NSdC7ct0E,1114
 orionis/luminate/support/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
-orionis/luminate/support/exception_parse.py,sha256=S4KU0s-MCEbulPrf0N9tLZZIN3Sjn-tOKYtQCP0Xe0k,1655
-orionis/luminate/support/reflection.py,sha256=TbWZ_cer0PXrPlwCYFbUJRymlzYxXT0E4C5XCsSc3mw,11951
-orionis/luminate/support/std.py,sha256=TqrgMxF_i5ubYGT5LOvHCH7HOHNmI8CE1kG9pNoSniY,1390
 orionis/luminate/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/inspection/container_integrity.py,sha256=6d9FsGk-Rm1AXgqBS3Nww49dR7n1ptXTTNyGUuBHgNY,10111
 orionis/luminate/support/inspection/functions.py,sha256=4wDT7iNp-5l4vuHk0UsIxN9wakASJRD4V0KY24uMDzk,7227
-orionis/luminate/support/inspection/reflection.py,sha256=mOCamaKv1ED-Q60_01HMzsCAhoCFeDK7ZqYZ3iYepsM,7716
-orionis/luminate/support/inspection/reflexion_abstract.py,sha256=U_VAGQN0ZDMgjxYPhNrLxFt6F8_-8zXcA_B5djTV4GE,10731
+orionis/luminate/support/inspection/reflection.py,sha256=xUILK5eEkTqXiAaOWVjEn_u-ybQyDMRxDE2Vn2aTYGU,7800
+orionis/luminate/support/inspection/reflexion_abstract.py,sha256=nImlP07TpsT0azgIafGVZfSv1THrBoJOlNSSr9vDKiE,10848
 orionis/luminate/support/inspection/reflexion_concrete.py,sha256=1ISuy2L6Oser-EhmpuGALmbauh7Z-X8Rx1YYgt5CabQ,7543
 orionis/luminate/support/inspection/reflexion_concrete_with_abstract.py,sha256=z1cAscuG6a1E4ZJmwkp9HVQ0yhTAeFYKfnnyR_M-RFI,7480
 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/support/inspection/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/inspection/contracts/reflection.py,sha256=zF9OLiEdgWJtJWvfrmWCQhbDjgYmm-QvAkFv9OLb3rE,4959
+orionis/luminate/support/inspection/contracts/reflexion_abstract.py,sha256=u8SiBTvcWltwR9g64akCNCzsTq8YkkZIPPEPwbyroQU,6396
+orionis/luminate/support/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/parsers/exception_parser.py,sha256=6MTeql76c1Muh9Nn-jz2jJdzb9_F7SLdoFjqBD5F8lY,3642
+orionis/luminate/support/parsers/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/parsers/contracts/exception_parser.py,sha256=HcWN7nJrvD7xLREPKEnBhyG30IkkAB7Bx_hGpcfb0ZE,912
+orionis/luminate/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/standard/std.py,sha256=AlhDc0CXC8_TSfZfkodefl_MwCyauX2E3CUXJF6_55w,3761
+orionis/luminate/support/standard/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/standard/contracts/std.py,sha256=x9sVir2yg4hve56cCklIdVSr8utruIO_sUdlTNfZ1Ds,3109
 orionis/luminate/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/test/test_case.py,sha256=jFhNcUZWuDTDFpe_nYJTqXQChA4z5kxu0I2YCONGSVk,134
 orionis/luminate/test/test_exception.py,sha256=21PILTXnMuL5-wT3HGKjIklt8VeIYDcQDN346i-BbJw,1336
@@ -199,7 +206,7 @@ tests/example/test_example.py,sha256=8EYjl1b-J_479dmJdQoAcKCKr7JUydW7EmPQpeiF13Y
 tests/support/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/inspection/test_reflection_abstract.py,sha256=K78avxUlI_dYKofSvVcuaVLAz-CivWSe3RkhrO-IRcA,9185
-tests/support/inspection/test_reflection_concrete.py,sha256=dvO7dduJMCsioCxZ5i2WW6V5-3z5LR6gIgGvBGaQcNI,6542
+tests/support/inspection/test_reflection_concrete.py,sha256=XEDzYP3Ac0CkjoukPIFeBz2FIXYW0SJV9uAw7aC2e7E,6662
 tests/support/inspection/test_reflection_concrete_with_abstract.py,sha256=G29gqevXQd7TBOluaPpK6ER-24a4uK-zaImamig7cEE,4650
 tests/support/inspection/test_reflection_instance.py,sha256=iwwf-QY-O3kR_HTHdATUnu9iXn6Nat7d8Y8Hxhwfpb0,6938
 tests/support/inspection/test_reflection_instance_with_abstract.py,sha256=RQkw2BYY8TLuk6h_9NIa_5JfRL7RG8004ro252t6YF8,4059
@@ -209,9 +216,15 @@ tests/support/inspection/fakes/fake_reflection_concrete.py,sha256=j6gzsxE3xq5oJ3
 tests/support/inspection/fakes/fake_reflection_concrete_with_abstract.py,sha256=ibCjrtNM6BMf5Z5VMvat7E6zOAk5g9z--gj4ykKJWY8,2118
 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.213.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.213.0.dist-info/METADATA,sha256=AAJOh4awPCmTybz8JgS7tMkkRL6nv6mLVrptKugaYS0,3003
-orionis-0.213.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.213.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.213.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.213.0.dist-info/RECORD,,
+tests/support/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/parsers/test_exception_parser.py,sha256=vSbSDAGH0TFIP4C6xfCecOgQYP-Aibqrb3K8ewWig0c,2339
+tests/support/parsers/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/parsers/fakes/fake_custom_error.py,sha256=BD8tQPhmIYFYVcaeMpEQ6uK1d6pcU4EGbwRkVfCZp7c,802
+tests/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/standard/test_std.py,sha256=PSM-AXDxvzJurAO7TfLdnq-W1oUMX6bWThNCGJCFAm4,1900
+orionis-0.216.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.216.0.dist-info/METADATA,sha256=7d93eflVGbnXtk6z9hAKh_o5mdFO7aMYW6dFcxV_QmU,3003
+orionis-0.216.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.216.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.216.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.216.0.dist-info/RECORD,,

tests/support/inspection/test_reflection_concrete.py

@@ -105,8 +105,11 @@ class TestReflectionConcrete(TestCase):
         """Test getFileLocation method."""
         reflection = Reflection.concrete(FakeExample)
         file_location = reflection.getFileLocation()
+        self.assertIn('tests', file_location)
+        self.assertIn('support', file_location)
+        self.assertIn('inspection', file_location)
+        self.assertIn('fakes', file_location)
         self.assertIn('fake_reflection_concrete.py', file_location)
-        self.assertIn('tests\\support\\inspection\\fakes', file_location)
 
     def testReflectionConcreteGetAnnotations(self):
         """Test getAnnotations method."""

tests/support/parsers/fakes/fake_custom_error.py

@@ -0,0 +1,27 @@
+class CustomError(Exception):
+    """
+    A custom exception class for handling errors with an optional error code.
+
+    Parameters
+    ----------
+    message : str
+        The error message describing the exception.
+    code : int, optional
+        An optional error code associated with the exception (default is None).
+
+    Attributes
+    ----------
+    code : int or None
+        The error code associated with the exception, if provided.
+
+    Examples
+    --------
+    >>> try:
+    ...     raise CustomError("An error occurred", code=404)
+    ... except CustomError as e:
+    ...     print(f"Error: {e}, Code: {e.code}")
+    Error: An error occurred, Code: 404
+    """
+    def __init__(self, message, code=None):
+        super().__init__(message)
+        self.code = code

tests/support/parsers/test_exception_parser.py

@@ -0,0 +1,59 @@
+from orionis.luminate.support.parsers.exception_parser import ExceptionParser
+from orionis.luminate.test.test_case import TestCase
+from tests.support.parsers.fakes.fake_custom_error import CustomError
+
+class TestsExceptionParser(TestCase):
+
+    def testBasicExceptionStructure(self):
+        """
+        Ensure that the ExceptionParser correctly structures a basic exception.
+        """
+        try:
+            raise ValueError("Something went wrong")
+        except Exception as e:
+            result = ExceptionParser(e).toDict()
+
+            self.assertIsInstance(result, dict)
+            self.assertIn("error_type", result)
+            self.assertIn("error_message", result)
+            self.assertIn("stack_trace", result)
+            self.assertIn("error_code", result)
+            self.assertIn("cause", result)
+
+            self.assertEqual(result["error_type"], "ValueError")
+            self.assertTrue("Something went wrong" in result["error_message"])
+            self.assertIsNone(result["error_code"])
+            self.assertIsNone(result["cause"])
+            self.assertIsInstance(result["stack_trace"], list)
+            self.assertGreater(len(result["stack_trace"]), 0)
+
+    def testRawExceptionProperty(self):
+        """
+        Ensure that the raw_exception property returns the original exception.
+        """
+        try:
+            raise RuntimeError("Test exception")
+        except Exception as e:
+            parser = ExceptionParser(e)
+            self.assertIs(parser.raw_exception, e)
+
+    def testExceptionWithCode(self):
+        try:
+            raise CustomError("Custom message", code=404)
+        except Exception as e:
+            result = ExceptionParser(e).toDict()
+            self.assertEqual(result["error_code"], 404)
+            self.assertEqual(result["error_type"], "CustomError")
+
+    def testNestedExceptionCause(self):
+        """
+        Ensure that the ExceptionParser correctly handles nested exceptions.
+        """
+        try:
+            try:
+                raise ValueError("Original cause")
+            except ValueError as exc:
+                raise TypeError("Outer error")
+        except Exception as e:
+            result = ExceptionParser(e).toDict()
+            self.assertEqual(result["error_type"], "TypeError")

tests/support/standard/test_std.py

@@ -0,0 +1,58 @@
+from orionis.luminate.support.standard.std import StdClass
+from orionis.luminate.test.test_case import TestCase
+
+class TestStdClass(TestCase):
+
+    def testInitializationAndAccess(self):
+        obj = StdClass(name='Raul', age=30)
+        self.assertEqual(obj.name, 'Raul')
+        self.assertEqual(obj.age, 30)
+
+    def testToDictReturnsCorrectData(self):
+        obj = StdClass(a=1, b=2)
+        expected = {'a': 1, 'b': 2}
+        self.assertEqual(obj.toDict(), expected)
+
+    def testUpdateAttributes(self):
+        obj = StdClass()
+        obj.update(foo='bar', number=42)
+        self.assertEqual(obj.foo, 'bar')
+        self.assertEqual(obj.number, 42)
+
+    def testUpdateReservedAttributeRaisesError(self):
+        obj = StdClass()
+        with self.assertRaises(ValueError):
+            obj.update(__init__='bad')
+
+    def testUpdateConflictingAttributeRaisesError(self):
+        obj = StdClass()
+        with self.assertRaises(ValueError):
+            obj.update(toDict='oops')
+
+    def testRemoveExistingAttributes(self):
+        obj = StdClass(x=1, y=2)
+        obj.remove('x')
+        self.assertFalse(hasattr(obj, 'x'))
+        self.assertTrue(hasattr(obj, 'y'))
+
+    def testRemoveNonExistingAttributeRaisesError(self):
+        obj = StdClass()
+        with self.assertRaises(AttributeError):
+            obj.remove('not_there')
+
+    def testFromDictCreatesEquivalentInstance(self):
+        data = {'a': 10, 'b': 20}
+        obj = StdClass.from_dict(data)
+        self.assertEqual(obj.toDict(), data)
+
+    def testReprAndStr(self):
+        obj = StdClass(x=5)
+        self.assertIn("StdClass", repr(obj))
+        self.assertIn("'x': 5", str(obj))
+
+    def testEquality(self):
+        a = StdClass(x=1, y=2)
+        b = StdClass(x=1, y=2)
+        c = StdClass(x=3)
+        self.assertEqual(a, b)
+        self.assertNotEqual(a, c)

orionis/luminate/contracts/support/std.py

@@ -1,43 +0,0 @@
-from abc import ABC, abstractmethod
-
-class IStdClass(ABC):
-    """
-    Interface for a dynamic class that allows setting arbitrary attributes,
-    similar to PHP's stdClass.
-    """
-
-    @abstractmethod
-    def __repr__(self) -> str:
-        """
-        Returns a string representation of the object.
-
-        Returns
-        -------
-        str
-            A formatted string showing the object's attributes.
-        """
-        pass
-
-    @abstractmethod
-    def toDict(self) -> dict:
-        """
-        Converts the object's attributes to a dictionary.
-
-        Returns
-        -------
-        dict
-            A dictionary representation of the object's attributes.
-        """
-        pass
-
-    @abstractmethod
-    def update(self, **kwargs):
-        """
-        Updates the object's attributes dynamically.
-
-        Parameters
-        ----------
-        kwargs : dict
-            Key-value pairs to update attributes.
-        """
-        pass

orionis/luminate/support/exception_parse.py

@@ -1,47 +0,0 @@
-import traceback
-from orionis.luminate.contracts.support.exception_parse import IExceptionParse
-
-class ExceptionParse(IExceptionParse):
-    """
-    A utility class to parse an exception and convert it into a structured dictionary.
-    """
-
-    @staticmethod
-    def toDict(exception):
-        """
-        Parse the provided exception and serialize it into a dictionary format.
-
-        Parameters
-        ----------
-        exception : Exception
-            The exception object to be serialized.
-
-        Returns
-        -------
-        dict
-            A dictionary containing the exception details such as error type, message,
-            and the stack trace.
-
-        Notes
-        -----
-        - Uses `traceback.TracebackException.from_exception()` to extract detailed traceback information.
-        - The stack trace includes filenames, line numbers, function names, and the exact line of code.
-        """
-        # Extract the detailed traceback information from the exception
-        tb = traceback.TracebackException.from_exception(exception)
-
-        # Construct and return the dictionary containing all necessary exception details
-        return {
-            "error_type": tb.exc_type_str,
-            "error_message": str(tb).strip(),
-            "error_code": getattr(exception, "code", None),
-            "stack_trace": [
-                {
-                    "filename": frame.filename,
-                    "lineno": frame.lineno,
-                    "name": frame.name,
-                    "line": frame.line
-                }
-                for frame in tb.stack
-            ]
-        }