core/controllers/review_tests.py - develop - githubmirror/oppia

core/controllers/review_tests.py
78 строк3 KB
Gabriel Fuentes
Black formatter staging (#23456)
05 окт 2025, 06:15
05 окт 2025, 06:1562ec95a
# Copyright 2019 The Oppia Authors. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS-IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Controllers for the review tests page."""

from __future__ import annotations

from core import feconf
from core.constants import constants
from core.controllers import acl_decorators, base
from core.domain import skill_fetchers, story_fetchers

from typing import Dict


class ReviewTestsPageDataHandler(
    base.BaseHandler[Dict[str, str], Dict[str, str]]
):
    """Fetches relevant data for the review tests page. This handler should
    be called only if the user has completed at least one exploration in
    the story.
    """

    GET_HANDLER_ERROR_RETURN_TYPE = feconf.HANDLER_TYPE_JSON
    URL_PATH_ARGS_SCHEMAS = {
        'classroom_url_fragment': constants.SCHEMA_FOR_CLASSROOM_URL_FRAGMENTS,
        'topic_url_fragment': constants.SCHEMA_FOR_TOPIC_URL_FRAGMENTS,
        'story_url_fragment': constants.SCHEMA_FOR_STORY_URL_FRAGMENTS,
    }
    HANDLER_ARGS_SCHEMAS: Dict[str, Dict[str, str]] = {'GET': {}}

    @acl_decorators.can_access_story_viewer_page
    def get(self, story_id: str) -> None:
        """Handles GET requests."""
        story = story_fetchers.get_story_by_id(story_id)
        latest_completed_node_ids = (
            (
                story_fetchers.get_latest_completed_node_ids(
                    self.user_id, story_id
                )
            )
            if self.user_id
            else []
        )

        if len(latest_completed_node_ids) == 0:
            raise self.NotFoundException

        try:
            skills = skill_fetchers.get_multi_skills(
                story.get_acquired_skill_ids_for_node_ids(
                    latest_completed_node_ids
                )
            )
        except Exception as e:
            raise self.NotFoundException(e)
        skill_descriptions = {}
        for skill in skills:
            skill_descriptions[skill.id] = skill.description

        self.values.update(
            {
                'skill_descriptions': skill_descriptions,
                'story_name': story.title,
            }
        )
        self.render_json(self.values)