feat: add filter exception for rendering custom response

openedx_filters/learning/filters.py

@@ -555,8 +555,23 @@ class RenderXBlockStarted(OpenEdxPublicFilter):
 
     class PreventXBlockBlockRender(OpenEdxFilterException):
         """
-        Custom class used to prevent the vertical block from rendering for the user.
+        Custom class used to prevent the XBlock from rendering for the user.
+        """
+
+    class RenderCustomResponse(OpenEdxFilterException):
         """
+        Custom class used to stop the XBlock rendering process and return a custom response.
+        """
+
+        def __init__(self, message, response=None):
+            """
+            Override init that defines specific arguments used in the XBlock render process.
+
+            Arguments:
+                message: error message for the exception.
+                response: custom response which will be returned by the XBlock render view.
+            """
+            super().__init__(message, response=response)
 
     @classmethod
     def run_filter(cls, context, student_view_context):

openedx_filters/learning/tests/test_filters.py

@@ -522,6 +522,26 @@ def test_halt_xblock_render(self, xblock_render_exception, attributes):
 
         self.assertDictContainsSubset(attributes, exception.__dict__)
 
+    @data(
+        (
+            RenderXBlockStarted.RenderCustomResponse,
+            {
+                "message": "Danger, Will Robinson!"
+            }
+        )
+    )
+    @unpack
+    def test_halt_xblock_render_custom_response(self, xblock_render_exception, attributes):
+        """
+        Test for xblock render exception attributes.
+
+        Expected behavior:
+            - The exception must have the attributes specified.
+        """
+        exception = xblock_render_exception(**attributes)
+
+        self.assertDictContainsSubset(attributes, exception.__dict__)
+
     def test_account_settings_render_started(self):
         """
         Test AccountSettingsRenderStarted filter behavior under normal conditions.