Method inspect_reduced_object

python/pyfory/policy.py:421–465

Inspect and validate an object after __reduce__ protocol reconstruction. This hook is called after an object has been reconstructed using the __reduce__ protocol, allowing final inspection, modification, or replacement. When Called ----------- - After callab

(self, obj, **kwargs)

        return self.intercept_reduce_call(callable_obj, args, **kwargs)

    def inspect_reduced_object(self, obj, **kwargs):
        """Inspect and validate an object after __reduce__ protocol reconstruction.

        This hook is called after an object has been reconstructed using the __reduce__
        protocol, allowing final inspection, modification, or replacement.

        When Called
        -----------
        - After callable_obj(*args) has been executed
        - After state has been restored (if applicable)
        - After list/dict items have been added (if applicable)
        - Before the object is returned to the deserializer

        Security Use Cases
        ------------------
        - Validate reconstructed object's state
        - Replace objects that pass callable checks but are still unsafe
        - Sanitize object attributes
        - Audit reconstructed objects for security logging

        Args:
            obj (object): The reconstructed object.
            **kwargs: Reserved for future extensions.

        Returns:
            None: Return None to accept the object as-is.
            object: Return a different object to replace the original.

        Raises:
            Exception: Raise any exception to reject the object.

        Example:
            >>> class PostReduceChecker(DeserializationPolicy):
            ...     def inspect_reduced_object(self, obj, **kwargs):
            ...         # Validate that file handles are read-only
            ...         if isinstance(obj, io.IOBase) and obj.writable():
            ...             raise ValueError("Writable file handles not allowed")
            ...         return None

        Note:
            This hook provides a last line of defense after reduce reconstruction.

            `check_restored_reduced_object` is an alias for this hook.
        """
        pass

    # Hook aliases
    def check_restored_reduced_object(self, obj, **kwargs):