feat: get migrations info REST-API added [FC-0112] (openedx#37558)

- Adds the get migrations info REST-API.
- Add missing title to CourseDetails population.

Author: ChrisChV

cms/djangoapps/modulestore_migrator/rest_api/v1/urls.py

@@ -17,5 +17,7 @@
     basename='library-migrations',
 )
 
-
-urlpatterns = ROUTER.urls
+urlpatterns = [
+    path('', include(ROUTER.urls)),
+    path('migration_info/', MigrationInfoViewSet.as_view(), name='migration-info'),
+]

cms/djangoapps/modulestore_migrator/rest_api/v1/views.py

@@ -12,11 +12,13 @@
 from rest_framework.response import Response
 from user_tasks.models import UserTaskStatus
 from user_tasks.views import StatusViewSet
+from opaque_keys.edx.keys import CourseKey
 
 from cms.djangoapps.modulestore_migrator import api as migrator_api
 from common.djangoapps.student import auth
 from openedx.core.djangoapps.content_libraries import api as lib_api
 from openedx.core.lib.api.authentication import BearerAuthenticationAllowInactiveUser
+from common.djangoapps.student.auth import has_studio_write_access
 
 from ...data import (
     CompositionLevel, RepeatHandlingStrategy,
@@ -373,6 +375,103 @@ def cancel(self, request, *args, **kwargs):
         raise NotImplementedError
 
 
+class MigrationInfoViewSet(APIView):
+    """
+    Retrieve migration information for a list of source courses or libraries.
+
+    It returns the target library information associated with each successfully migrated source.
+
+    API Endpoints
+    -------------
+    GET /api/modulestore_migrator/v1/migration-info/
+        Retrieve migration details for one or more sources.
+
+        Query parameters:
+            source_keys (list[str]): List of course or library keys to check.
+                Example: ?source_keys=course-v1:edX+DemoX+2024_T1&source_keys=library-v1:orgX+lib_2
+
+        Example request:
+            GET /api/modulestore_migrator/v1/migration-info/?source_keys=course-v1:edX+DemoX+2024_T1
+
+        Example response:
+            {
+                "course-v1:edX+DemoX+2024_T1": [
+                    {
+                        "target_key": "library-v1:orgX+lib_2",
+                        "target_title": "Demo Library",
+                        "target_collection_key": "col-v2:1234abcd",
+                        "target_collection_title": "Default Collection",
+                        "source_key": "course-v1:edX+DemoX+2024_T1"
+                    }
+                ],
+                "library-v1:orgX+lib_2": [
+                    {
+                        "target_key": "library-v1:orgX+lib_2",
+                        "target_title": "Demo Library",
+                        "target_collection_key": "col-v2:1234abcd",
+                        "target_collection_title": "Default Collection",
+                        "source_key": "course-v1:edX+DemoX+2024_T1"
+                    },
+                    {
+                        "target_key": "library-v1:orgX+lib_2",
+                        "target_title": "Demo Library",
+                        "target_collection_key": "col-v2:1234abcd",
+                        "target_collection_title": "Default Collection",
+                        "source_key": "course-v1:edX+DemoX+2024_T1"
+                    }
+                ]
+            }
+    """
+
+    permission_classes = (IsAuthenticated,)
+    authentication_classes = (
+        BearerAuthenticationAllowInactiveUser,
+        JwtAuthentication,
+        SessionAuthenticationAllowInactiveUser,
+    )
+
+    @apidocs.schema(
+        parameters=[
+            apidocs.string_parameter(
+                "source_keys",
+                apidocs.ParameterLocation.QUERY,
+                description="List of source keys to consult",
+            ),
+        ],
+        responses={
+            200: MigrationInfoResponseSerializer,
+            400: "Missing required parameter: source_keys",
+            401: "The requester is not authenticated.",
+        },
+    )
+    def get(self, request):
+        """
+        Handle the migration info `GET` request
+        """
+        source_keys = request.query_params.getlist("source_keys")
+
+        if not source_keys:
+            return Response(
+                {"detail": "Missing required parameter: source_keys"},
+                status=status.HTTP_400_BAD_REQUEST
+            )
+
+        # Check permissions for each source_key:
+        # Skip the source if the key is invalid or if the user doesn't have permissions
+        source_keys_validated = []
+        for source_key in source_keys:
+            try:
+                key = CourseKey.from_string(source_key)
+                if has_studio_write_access(request.user, key):
+                    source_keys_validated.append(key)
+            except InvalidKeyError:
+                continue
+
+        data = get_all_migrations_info(source_keys_validated)
+        serializer = MigrationInfoResponseSerializer(data)
+        return Response(serializer.data)
+
+
 @apidocs.schema_for(
     "list",
     "List all course migrations to a library.",

openedx/core/djangoapps/models/course_details.py

@@ -129,6 +129,7 @@ def populate(cls, block):
         course_details.self_paced = block.self_paced
         course_details.learning_info = block.learning_info
         course_details.instructor_info = block.instructor_info
+        course_details.title = block.display_name
 
         # Default course license is "All Rights Reserved"
         course_details.license = getattr(block, "license", "all-rights-reserved")