✨(xapi) add ralph-malph library for statements generation

Finally, we have integrated Ralph in marsha to help generate xAPI statements with Pydantic! However the integration is partial as statements are initialized from the frontend.
openfun · May 3, 2024 · c5d0957 · c5d0957
1 parent 26ce607
commit c5d0957
Show file tree

Hide file tree

Showing 7 changed files with 206 additions and 101 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -10,6 +10,7 @@ Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Added
 
+- Integrate `ralph-malph` library for xAPI statements generation
 - Add scaleway storage configuration
 - Add Peertube pipeline to VOD
 - Celery task queue

diff --git a/src/backend/marsha/core/tests/api/xapi/document/test_from_website.py b/src/backend/marsha/core/tests/api/xapi/document/test_from_website.py
@@ -24,6 +24,7 @@ def test_xapi_statement_document_resource(self):
 
         session_id = str(uuid.uuid4())
         jwt_token = UserAccessTokenFactory()
+        print(jwt_token.__dict__)
 
         data = {
             "verb": {

diff --git a/src/backend/marsha/core/tests/test_xapi.py b/src/backend/marsha/core/tests/test_xapi.py
@@ -80,7 +80,6 @@ def test_xapi_statement_missing_user(self):
                     "name": {"en-US": "test video xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -91,11 +90,17 @@ def test_xapi_statement_missing_user(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/video"}],
+                    "category": [
+                        {
+                            "id": "https://w3id.org/xapi/video",
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                        }
+                    ],
                     "parent": [
                         {
                             "id": "course-v1:ufr+mathematics+0001",
-                            "objectType": "Activity",
                             "definition": {
                                 "type": "http://adlnet.gov/expapi/activities/course"
                             },
@@ -121,6 +126,7 @@ def test_xapi_statement_enrich_statement(self):
             session_id="326c0689-48c1-493e-8d2d-9fb0c289de7f",
             context_id="course-v1:ufr+mathematics+0001",
             user__id="b2584aa405540758db2a6278521b6478",
+            user__username="johndoe",
         )
 
         base_statement = {
@@ -153,6 +159,7 @@ def test_xapi_statement_enrich_statement(self):
         self.assertEqual(
             statement["actor"],
             {
+                "name": "johndoe",
                 "objectType": "Agent",
                 "account": {
                     "name": "b2584aa405540758db2a6278521b6478",
@@ -168,7 +175,6 @@ def test_xapi_statement_enrich_statement(self):
                     "name": {"en-US": "test video xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -179,11 +185,17 @@ def test_xapi_statement_enrich_statement(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/video"}],
+                    "category": [
+                        {
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                            "id": "https://w3id.org/xapi/video",
+                        }
+                    ],
                     "parent": [
                         {
                             "id": "course-v1:ufr+mathematics+0001",
-                            "objectType": "Activity",
                             "definition": {
                                 "type": "http://adlnet.gov/expapi/activities/course"
                             },
@@ -210,6 +222,7 @@ def test_xapi_statement_live_video(self):
             session_id="326c0689-48c1-493e-8d2d-9fb0c289de7f",
             context_id="course-v1:ufr+mathematics+0001",
             user__id="b2584aa405540758db2a6278521b6478",
+            user__username="johndoe",
         )
 
         base_statement = {
@@ -242,6 +255,7 @@ def test_xapi_statement_live_video(self):
         self.assertEqual(
             statement["actor"],
             {
+                "name": "johndoe",
                 "objectType": "Agent",
                 "account": {
                     "name": "b2584aa405540758db2a6278521b6478",
@@ -257,7 +271,6 @@ def test_xapi_statement_live_video(self):
                     "name": {"en-US": "test video xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -268,11 +281,17 @@ def test_xapi_statement_live_video(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/video"}],
+                    "category": [
+                        {
+                            "id": "https://w3id.org/xapi/video",
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                        }
+                    ],
                     "parent": [
                         {
                             "id": "course-v1:ufr+mathematics+0001",
-                            "objectType": "Activity",
                             "definition": {
                                 "type": "http://adlnet.gov/expapi/activities/course"
                             },
@@ -300,6 +319,7 @@ def test_xapi_statement_live_video_ended(self):
             session_id="326c0689-48c1-493e-8d2d-9fb0c289de7f",
             context_id="course-v1:ufr+mathematics+0001",
             user__id="b2584aa405540758db2a6278521b6478",
+            user__username="johndoe",
         )
 
         base_statement = {
@@ -332,6 +352,7 @@ def test_xapi_statement_live_video_ended(self):
         self.assertEqual(
             statement["actor"],
             {
+                "name": "johndoe",
                 "objectType": "Agent",
                 "account": {
                     "name": "b2584aa405540758db2a6278521b6478",
@@ -347,7 +368,6 @@ def test_xapi_statement_live_video_ended(self):
                     "name": {"en-US": "test video xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -358,11 +378,17 @@ def test_xapi_statement_live_video_ended(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/video"}],
+                    "category": [
+                        {
+                            "id": "https://w3id.org/xapi/video",
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                        }
+                    ],
                     "parent": [
                         {
                             "id": "course-v1:ufr+mathematics+0001",
-                            "objectType": "Activity",
                             "definition": {
                                 "type": "http://adlnet.gov/expapi/activities/course"
                             },
@@ -434,7 +460,6 @@ def test_xapi_statement_missing_context_id(self):
                     "name": {"en-US": "test video xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -445,7 +470,14 @@ def test_xapi_statement_missing_context_id(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/video"}]
+                    "category": [
+                        {
+                            "id": "https://w3id.org/xapi/video",
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                        }
+                    ]
                 },
             },
         )
@@ -470,6 +502,7 @@ def test_xapi_statement_enrich_statement(self):
             session_id="326c0689-48c1-493e-8d2d-9fb0c289de7f",
             context_id="course-v1:ufr+mathematics+0001",
             user__id="b2584aa405540758db2a6278521b6478",
+            user__username="johndoe",
         )
 
         base_statement = {
@@ -493,6 +526,7 @@ def test_xapi_statement_enrich_statement(self):
         self.assertEqual(
             statement["actor"],
             {
+                "name": "johndoe",
                 "objectType": "Agent",
                 "account": {
                     "name": "b2584aa405540758db2a6278521b6478",
@@ -508,7 +542,6 @@ def test_xapi_statement_enrich_statement(self):
                     "name": {"en-US": "test document xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -519,11 +552,17 @@ def test_xapi_statement_enrich_statement(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/lms"}],
+                    "category": [
+                        {
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                            "id": "https://w3id.org/xapi/lms",
+                        }
+                    ],
                     "parent": [
                         {
                             "id": "course-v1:ufr+mathematics+0001",
-                            "objectType": "Activity",
                             "definition": {
                                 "type": "http://adlnet.gov/expapi/activities/course"
                             },
@@ -547,6 +586,7 @@ def test_xapi_statement_missing_context_id(self):
         jwt_token = LTIPlaylistAccessTokenFactory(
             session_id="326c0689-48c1-493e-8d2d-9fb0c289de7f",
             user__id="b2584aa405540758db2a6278521b6478",
+            user__username="johndoe",
         )
         del jwt_token.payload["context_id"]
 
@@ -571,6 +611,7 @@ def test_xapi_statement_missing_context_id(self):
         self.assertEqual(
             statement["actor"],
             {
+                "name": "johndoe",
                 "objectType": "Agent",
                 "account": {
                     "name": "b2584aa405540758db2a6278521b6478",
@@ -586,7 +627,6 @@ def test_xapi_statement_missing_context_id(self):
                     "name": {"en-US": "test document xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -597,7 +637,14 @@ def test_xapi_statement_missing_context_id(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/lms"}]
+                    "category": [
+                        {
+                            "id": "https://w3id.org/xapi/lms",
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                        }
+                    ]
                 },
             },
         )
@@ -655,7 +702,6 @@ def test_xapi_statement_missing_user_id(self):
                     "name": {"en-US": "test document xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -666,11 +712,17 @@ def test_xapi_statement_missing_user_id(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/lms"}],
+                    "category": [
+                        {
+                            "id": "https://w3id.org/xapi/lms",
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                        }
+                    ],
                     "parent": [
                         {
                             "id": "course-v1:ufr+mathematics+0001",
-                            "objectType": "Activity",
                             "definition": {
                                 "type": "http://adlnet.gov/expapi/activities/course"
                             },

diff --git a/src/backend/marsha/core/tests/xapi/document/test_statement_from_website.py b/src/backend/marsha/core/tests/xapi/document/test_statement_from_website.py
@@ -41,11 +41,11 @@ def test_xapi_statement_enrich_statement(self):
         self.assertEqual(
             statement["actor"],
             {
+                "name": f"{user.username}",
                 "objectType": "Agent",
                 "account": {
                     "name": f"{user.id}",
                     "homePage": "http://marsha.education",
-                    "mbox": "mailto:[email protected]",
                 },
             },
         )
@@ -57,7 +57,6 @@ def test_xapi_statement_enrich_statement(self):
                     "name": {"en-US": "test document xapi"},
                 },
                 "id": "uuid://68333c45-4b8c-4018-a195-5d5e1706b838",
-                "objectType": "Activity",
             },
         )
         self.assertEqual(
@@ -68,7 +67,14 @@ def test_xapi_statement_enrich_statement(self):
                     "43b4-8452-2037fed588df"
                 },
                 "contextActivities": {
-                    "category": [{"id": "https://w3id.org/xapi/lms"}]
+                    "category": [
+                        {
+                            "definition": {
+                                "type": "http://adlnet.gov/expapi/activities/profile"
+                            },
+                            "id": "https://w3id.org/xapi/lms",
+                        }
+                    ]
                 },
             },
         )