edx-platform/cms/djangoapps/contentstore/views/tabs.py

"""
Views related to course tabs
"""
from typing import Dict, Iterable, List, Optional, Union

from django.contrib.auth import get_user_model
from django.contrib.auth.decorators import login_required
from django.core.exceptions import PermissionDenied
from django.http import HttpResponseNotFound
from django.shortcuts import redirect
from django.views.decorators.csrf import ensure_csrf_cookie
from django.views.decorators.http import require_http_methods
from opaque_keys.edx.keys import CourseKey, UsageKey
from rest_framework.exceptions import ValidationError
from xmodule.course_block import CourseBlock
from xmodule.modulestore import ModuleStoreEnum
from xmodule.modulestore.django import modulestore
from xmodule.tabs import CourseTab, CourseTabList, InvalidTabsException, StaticTab

from common.djangoapps.student.auth import has_course_author_access
from common.djangoapps.util.json_request import JsonResponse, JsonResponseBadRequest, expect_json
from ..utils import get_pages_and_resources_url, get_custom_pages_url

__all__ = ["tabs_handler", "update_tabs_handler"]

User = get_user_model()


@expect_json
@login_required
@ensure_csrf_cookie
@require_http_methods(("GET", "POST", "PUT"))
def tabs_handler(request, course_key_string):
    """
    The restful handler for static tabs.

    GET
        html: return page for editing static tabs
        json: not supported
    PUT or POST
        json: update the tab order. It is expected that the request body contains a JSON-encoded dict with entry "tabs".
        The value for "tabs" is an array of tab locators, indicating the desired order of the tabs.

    Creating a tab, deleting a tab, or changing its contents is not supported through this method.
    Instead use the general xblock URL (see item.xblock_handler).
    """
    course_key = CourseKey.from_string(course_key_string)
    if not has_course_author_access(request.user, course_key):
        raise PermissionDenied()

    course_item = modulestore().get_course(course_key)

    if "application/json" in request.META.get("HTTP_ACCEPT", "application/json"):
        if request.method == "GET":  # lint-amnesty, pylint: disable=no-else-raise
            raise NotImplementedError("coming soon")
        else:
            try:
                update_tabs_handler(course_item, request.json, request.user)
            except ValidationError as err:
                return JsonResponseBadRequest(err.detail)
            return JsonResponse()

    elif request.method == "GET":  # assume html
        # get all tabs from the tabs list: static tabs (a.k.a. user-created tabs) and built-in tabs
        # present in the same order they are displayed in LMS
        return redirect(get_custom_pages_url(course_key))
    else:
        return HttpResponseNotFound()


def get_course_tabs(course_item: CourseBlock, user: User) -> Iterable[CourseTab]:
    """
    Yields all the course tabs in a course including hidden tabs.

    Args:
        course_item (CourseBlock): The course object from which to get the tabs
        user (User): The user fetching the course tabs.

    Returns:
        Iterable[CourseTab]: An iterable containing course tab objects from the
        course
    """
    pages_and_resources_mfe_enabled = bool(get_pages_and_resources_url(course_item.id))
    for tab in CourseTabList.iterate_displayable(course_item, user=user, inline_collections=False, include_hidden=True):
        if isinstance(tab, StaticTab):
            # static tab needs its locator information to render itself as an xmodule
            static_tab_loc = course_item.id.make_usage_key("static_tab", tab.url_slug)
            tab.locator = static_tab_loc
        # If the course apps MFE is set up and pages and resources is enabled, then only show static tabs
        if isinstance(tab, StaticTab) or not pages_and_resources_mfe_enabled:
            yield tab


def update_tabs_handler(course_item: CourseBlock, tabs_data: Dict, user: User) -> None:
    """
    Helper to handle updates to course tabs based on API data.

    Args:
        course_item (CourseBlock): Course block whose tabs need to be updated
        tabs_data (Dict): JSON formatted data for updating or reordering tabs.
        user (User): The user performing the operation.
    """

    if "tabs" in tabs_data:
        reorder_tabs_handler(course_item, tabs_data["tabs"], user)
    elif "tab_id_locator" in tabs_data:
        edit_tab_handler(course_item, tabs_data, user)
    else:
        raise NotImplementedError("Creating or changing tab content is not supported.")


def reorder_tabs_handler(course_item, tabs_data, user):
    """
    Helper function for handling reorder of tabs request
    """

    # Static tabs are identified by locators (a UsageKey) instead of a tab id like
    # other tabs. These can be used to identify static tabs since they are xmodules.
    # Although all tabs have tab_ids, newly created static tabs do not know
    # their tab_ids since the xmodule editor uses only locators to identify new objects.
    new_tab_list = create_new_list(tabs_data, course_item.tabs)

    # validate the tabs to make sure everything is Ok (e.g., did the client try to reorder unmovable tabs?)
    try:
        CourseTabList.validate_tabs(new_tab_list)
    except InvalidTabsException as exception:
        raise ValidationError({"error": f"New list of tabs is not valid: {str(exception)}."}) from exception

    course_item.tabs = new_tab_list

    modulestore().update_item(course_item, user.id)


def create_new_list(tab_locators, old_tab_list):
    """
    Helper function for creating a new course tab list in the new order of
    reordered tabs.

    It will take tab_locators for static tabs and resolve them to actual tab
    instances.
    """
    new_tab_list = []
    for tab_locator in tab_locators:
        tab = get_tab_by_tab_id_locator(old_tab_list, tab_locator)
        if tab is None:
            raise ValidationError({"error": f"Tab with id_locator '{tab_locator}' does not exist."})
        if isinstance(tab, StaticTab):
            new_tab_list.append(tab)

    # the old_tab_list may contain additional tabs that were not rendered in the UI because of
    # global or course settings.  so add those to the end of the list.
    non_displayed_tabs = set(old_tab_list) - set(new_tab_list)
    new_tab_list.extend(non_displayed_tabs)
    return sorted(new_tab_list, key=lambda item: item.priority or float('inf'))


def edit_tab_handler(course_item: CourseBlock, tabs_data: Dict, user: User):
    """
    Helper function for handling requests to edit settings of a single tab
    """

    # Tabs are identified by tab_id or locator
    tab_id_locator = tabs_data["tab_id_locator"]

    # Find the given tab in the course
    tab = get_tab_by_tab_id_locator(course_item.tabs, tab_id_locator)
    if tab is None:
        raise ValidationError({"error": f"Tab with id_locator '{tab_id_locator}' does not exist."})

    if "is_hidden" in tabs_data:
        if tab.is_hideable:
            # set the is_hidden attribute on the requested tab
            tab.is_hidden = tabs_data["is_hidden"]
            modulestore().update_item(course_item, user.id)
        else:
            raise ValidationError({"error": f"Tab of type {tab.type} can not be hidden"})
    else:
        raise NotImplementedError(f"Unsupported request to edit tab: {tabs_data}")


def get_tab_by_tab_id_locator(tab_list: List[CourseTab], tab_id_locator: Dict[str, str]) -> Optional[CourseTab]:
    """
    Look for a tab with the specified tab_id or locator.  Returns the first matching tab.
    """
    tab = None
    if "tab_id" in tab_id_locator:
        tab = CourseTabList.get_tab_by_id(tab_list, tab_id_locator["tab_id"])
    elif "tab_locator" in tab_id_locator:
        tab = get_tab_by_locator(tab_list, tab_id_locator["tab_locator"])
    return tab


def get_tab_by_locator(tab_list: List[CourseTab], tab_location: Union[str, UsageKey]) -> Optional[CourseTab]:
    """
    Look for a tab with the specified locator.  Returns the first matching tab.
    """
    if isinstance(tab_location, str):
        tab_location = UsageKey.from_string(tab_location)
    item = modulestore().get_item(tab_location)
    static_tab = StaticTab(
        name=item.display_name,
        url_slug=item.location.name,
    )
    return CourseTabList.get_tab_by_id(tab_list, static_tab.tab_id)


# "primitive" tab edit functions driven by the command line.
# These should be replaced/deleted by a more capable GUI someday.
# Note that the command line UI identifies the tabs with 1-based
# indexing, but this implementation code is standard 0-based.

def validate_args(num, tab_type):
    "Throws for the disallowed cases."
    if num < 1:
        raise ValueError('Tab 1 cannot be edited')
    if tab_type == 'static_tab':
        raise ValueError('Tabs of type static_tab cannot be edited here (use Studio)')


def primitive_delete(course, num):
    "Deletes the given tab number (0 based)."
    tabs = course.tabs
    validate_args(num, tabs[num].get('type', ''))
    del tabs[num]
    # Note for future implementations: if you delete a static_tab, then Chris Dodge
    # points out that there's other stuff to delete beyond this element.
    # This code happens to not delete static_tab so it doesn't come up.
    modulestore().update_item(course, ModuleStoreEnum.UserID.primitive_command)


def primitive_insert(course, num, tab_type, name):
    "Inserts a new tab at the given number (0 based)."
    validate_args(num, tab_type)
    new_tab = CourseTab.from_json({'type': str(tab_type), 'name': str(name)})
    tabs = course.tabs
    tabs.insert(num, new_tab)
    modulestore().update_item(course, ModuleStoreEnum.UserID.primitive_command)