feat: add xapi transformer for grading events

event_routing_backends/processors/xapi/constants.py

@@ -21,6 +21,7 @@
 XAPI_VERB_VOTED = 'https://w3id.org/xapi/openedx/verb/voted'
 XAPI_VERB_REPORTED = 'https://w3id.org/xapi/acrossx/verbs/reported'
 XAPI_VERB_UNREPORTED = 'https://w3id.org/xapi/openedx/verb/unreported'
+XAPI_VERB_GRADED = 'http://dimmy.com/verb/graded'
 
 XAPI_VERB_TERMINATED = 'http://adlnet.gov/expapi/verbs/terminated'
 XAPI_VERB_ASKED = 'http://adlnet.gov/expapi/verbs/asked'
@@ -47,6 +48,7 @@
 XAPI_ACTIVITY_TOTAL_COUNT = 'https://w3id.org/xapi/acrossx/extensions/total-items'
 XAPI_ACTIVITY_MODE = 'https://w3id.org/xapi/acrossx/extensions/type'
 XAPI_ACTIVITY_ATTEMPT = 'http://id.tincanapi.com/extension/attempt-id'
+XAPI_ACTIVITY_GRADE = 'http://dummy.com/grade'
 
 # xAPI context
 XAPI_CONTEXT_VIDEO_LENGTH = 'https://w3id.org/xapi/video/extensions/length'

event_routing_backends/processors/xapi/event_transformers/grading_events.py

@@ -0,0 +1,79 @@
+"""
+Transformers for grading related events.
+"""
+from tincan import Activity, ActivityDefinition, Extensions, LanguageMap, Verb
+
+from event_routing_backends.helpers import get_course_from_id
+from event_routing_backends.processors.xapi import constants
+from event_routing_backends.processors.xapi.registry import XApiTransformersRegistry
+from event_routing_backends.processors.xapi.transformer import XApiTransformer
+
+
+@XApiTransformersRegistry.register('edx.grades.subsection.grade_calculated')
+class SubsectionGradedTransformer(XApiTransformer):
+    """
+    Transformer for event generated when an subsection is graded.
+    """
+    verb = Verb(
+        id=constants.XAPI_VERB_GRADED,
+        display=LanguageMap({constants.EN: constants.EVALUATED}),
+    )
+
+    def get_object(self):
+        """
+        Get object for xAPI transformed event related to subsection grading.
+
+        Returns:
+            `Activity`
+        """
+        return Activity(
+            id=self.get_object_iri('xblock', self.get_data('data.block_id')),
+            definition=ActivityDefinition(
+                type=constants.XAPI_ACTIVITY_RESOURCE,
+                extensions=Extensions({
+                    constants.XAPI_ACTIVITY_GRADE: self.get_data('data.weighted_total_earned'),
+                    # TODO course_version
+                    # TODO weighted_total_earned
+                    # TODO weighted_total_possible
+                    # TODO weighted_graded_earned
+                    # TODO weighted_graded_possible
+                })
+            ),
+        )
+
+
+@XApiTransformersRegistry.register('edx.grades.course.grade_calculated')
+class CourseGradedTransformer(XApiTransformer):
+    """
+    Transformer for event generated when an course is graded.
+    """
+    verb = Verb(
+        id=constants.XAPI_VERB_GRADED,
+        display=LanguageMap({constants.EN: constants.EVALUATED}),
+    )
+
+    def get_object(self):
+        """
+        Get object for xAPI transformed event related to course grading.
+
+        Returns:
+            `Activity`
+        """
+        course_id = self.get_data('context.course_id', True)
+        object_id = self.get_object_iri('course', course_id)
+        course = get_course_from_id(course_id)
+        display_name = course['display_name']
+
+        return Activity(
+            id=object_id,
+            definition=ActivityDefinition(
+                type=constants.XAPI_ACTIVITY_COURSE,
+                name=LanguageMap(**({constants.EN: display_name} if display_name is not None else {})),
+                extensions=Extensions({
+                    constants.XAPI_ACTIVITY_GRADE: self.get_data('data.percent_grade')*100,
+                    # TODO letter_grade
+                    # TODO course_version
+                    # TODO grading_policy_hash
+                })
+            ),
+        )

event_routing_backends/settings/common.py

@@ -72,6 +72,8 @@ def plugin_settings(settings):
                                     'edx.course.enrollment.activated',
                                     'edx.course.enrollment.deactivated',
                                     'edx.course.enrollment.mode_changed',
+                                    'edx.grades.subsection.grade_calculated',
+                                    'edx.grades.course.grade_calculated',
                                     'edx.forum.thread.created',
                                     'edx.forum.thread.deleted',
                                     'edx.forum.thread.edited',