11413675820

Committed 19 Oct 2024 02:12AM UTC coverage: 56.081% (+1.3%) from 54.79%

Build # 11413675820

Build Type

Pull #87

github

Committed by

web-flow

Commit Message

Merge 18529b606 into 6a43c847c

Pull Request Pull Request #87: Implement views for file actions

Run Details

435 of 928 branches covered (46.88%)

Branch coverage included in aggregate %.

78 of 81 new or added lines in 5 files covered. (96.3%)

93 existing lines in 1 file now uncovered.

1571 of 2649 relevant lines covered (59.31%)

0.59 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

59.82

/tin/apps/assignments/views.py

from __future__ import annotations

import csv
import datetime
import logging
import os
import subprocess
import zipfile
from io import BytesIO

import celery
from django import http
from django.conf import settings
from django.contrib.auth import get_user_model
from django.shortcuts import get_object_or_404, redirect, render
from django.urls import reverse
from django.utils.text import slugify
from django.utils.timezone import now
from django.views.decorators.http import require_POST

from ... import sandboxing
from ..auth.decorators import login_required, teacher_or_superuser_required
from ..courses.models import Course, Period
from ..submissions.models import PublishedSubmission, Submission
from ..submissions.tasks import run_submission
from ..users.models import User
from .forms import (
    AssignmentForm,
    ChooseFileActionForm,
    FileActionForm,
    FileSubmissionForm,
    FileUploadForm,
    FolderForm,
    GraderScriptUploadForm,
    MossForm,
    TextSubmissionForm,
)
from .models import Assignment, CooldownPeriod, FileAction, QuizLogMessage
from .tasks import run_moss

logger = logging.getLogger(__name__)


@login_required
def show_view(request, assignment_id):
    """Shows an overview of the :class:`.Assignment`

    Args:
        request : The request
        assignment_id : the :class:`.Assignment` id
    """
    assignment: Assignment = get_object_or_404(
        Assignment.objects.filter_visible(request.user), id=assignment_id
    )
    course = assignment.course
    quiz_accessible = assignment.is_quiz and assignment.quiz_open_for_student(request.user)

    if course.is_only_student_in_course(request.user):
        submissions = Submission.objects.filter(student=request.user, assignment=assignment)
        latest_submission = submissions.latest() if submissions else None
        publishes = PublishedSubmission.objects.filter(student=request.user, assignment=assignment)
        graded_submission = publishes.latest().submission if publishes else latest_submission

        return render(
            request,
            "assignments/show.html",
            {
                "course": assignment.course,
                "folder": assignment.folder,
                "assignment": assignment,
                "submissions": submissions.order_by("-date_submitted"),
                "latest_submission": latest_submission,
                "graded_submission": graded_submission,
                "is_student": course.is_student_in_course(request.user),
                "is_teacher": request.user in course.teacher.all(),
                "quiz_accessible": quiz_accessible,
            },
        )
    else:
        students_and_submissions = []
        new_since_last_login = None
        new_in_last_24 = None
        teacher_last_login = request.user.last_login
        time_24_hours_ago = now() - datetime.timedelta(days=1)

        query = request.GET.get("query", "")

        period = request.GET.get("period", "")
        period_set = course.period_set.order_by("teacher", "name")

        if query:
            active_period = "query"
            student_list = course.students.filter(full_name__icontains=query).order_by(
                "periods", "last_name"
            )
        elif course.period_set.exists():
            if period == "":
                if request.user in course.teacher.all():
                    try:
                        period = (
                            course.period_set.filter(teacher=request.user).order_by("name")[0].id
                        )
                    except IndexError:
                        period = "none"
                else:
                    period = "none"

            if period == "all":
                active_period = "all"
                student_list = course.students.all().order_by("periods", "last_name")
            elif period == "none":
                active_period = "none"
                student_list = []
            else:
                active_period = get_object_or_404(
                    Period.objects.filter(course=course), id=int(period)
                )
                student_list = active_period.students.all().order_by("last_name")
        elif period == "all":
            active_period = "all"
            student_list = course.students.all().order_by("last_name")
        else:
            active_period = "none"
            student_list = []

        for student in student_list:
            period = student.periods.filter(course=assignment.course)
            submissions = Submission.objects.filter(student=student, assignment=assignment)
            publishes = PublishedSubmission.objects.filter(student=student, assignment=assignment)
            latest_submission = submissions.latest() if submissions else None
            graded_submission = publishes.latest().submission if publishes else latest_submission

            if not assignment.is_quiz:
                if latest_submission:
                    new_since_last_login = latest_submission.date_submitted > teacher_last_login
                    new_in_last_24 = latest_submission.date_submitted > time_24_hours_ago
                students_and_submissions.append(
                    (
                        student,
                        period,
                        latest_submission,
                        graded_submission,
                        new_since_last_login,
                        new_in_last_24,
                    )
                )
            else:
                students_and_submissions.append(
                    (
                        student,
                        period,
                        latest_submission,
                        graded_submission,
                        assignment.quiz_ended_for_student(student),
                        assignment.quiz_locked_for_student(student),
                    )
                )

        context = {
            "course": course,
            "folder": assignment.folder,
            "assignment": assignment,
            "students_and_submissions": students_and_submissions,
            "log_file_exists": (
                os.path.exists(os.path.join(settings.MEDIA_ROOT, assignment.grader_log_filename))
            ),
            "is_student": course.is_student_in_course(request.user),
            "is_teacher": request.user in course.teacher.all(),
            "query": query,
            "period_set": period_set,
            "active_period": active_period,
            "quiz_accessible": quiz_accessible,
        }

        submissions = Submission.objects.filter(student=request.user, assignment=assignment)
        publishes = PublishedSubmission.objects.filter(student=request.user, assignment=assignment)
        latest_submission = submissions.latest() if submissions else None
        graded_submission = publishes.latest().submission if publishes else latest_submission
        context.update(
            {
                "submissions": submissions.order_by("-date_submitted"),
                "latest_submission": latest_submission,
                "graded_submission": graded_submission,
            }
        )

        return render(request, "assignments/show.html", context)


@teacher_or_superuser_required
def create_view(request, course_id):
    """Creates an assignment

    Args:
        request: The request
        course_id: The id of the :class:`.Course`
    """
    course = get_object_or_404(Course.objects.filter_editable(request.user), id=course_id)

    if request.method == "POST":
        assignment_form = AssignmentForm(course, request.POST)
        if assignment_form.is_valid():
            assignment = assignment_form.save(commit=False)
            assignment.course = course
            assignment.save()

            assignment.make_assignment_dir()

            return redirect("assignments:show", assignment.id)
    else:
        assignment_form = AssignmentForm(course)
    return render(
        request,
        "assignments/edit_create.html",
        {
            "assignment_form": assignment_form,
            "course": course,
            "nav_item": "Create assignment",
            "action": "add",
            "imgbb_api_key": settings.IMGBB_API_KEY,
        },
    )


@teacher_or_superuser_required
def edit_view(request, assignment_id):
    """Edits an assignment

    Args:
        request: The request
        assignment_id: The id of the :class:`.Assignment`
    """
    assignment: Assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    course = assignment.course

    assignment_form = AssignmentForm(course, instance=assignment)
    if request.method == "POST":
        assignment_form = AssignmentForm(course, data=request.POST, instance=assignment)
        if assignment_form.is_valid():
            assignment_form.save()
            return redirect("assignments:show", assignment.id)

    return render(
        request,
        "assignments/edit_create.html",
        {
            "assignment_form": assignment_form,
            "course": assignment.course,
            "folder": assignment.folder,
            "assignment": assignment,
            "nav_item": "Edit",
            "action": "edit",
            "imgbb_api_key": settings.IMGBB_API_KEY,
        },
    )


@teacher_or_superuser_required
def delete_view(request, assignment_id):
    """Deletes an assignment

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    course = assignment.course
    folder = assignment.folder
    assignment.delete()
    if folder:
        return redirect(reverse("assignments:show_folder", args=(course.id, folder.id)))
    return redirect(reverse("courses:show", args=(course.id,)))


@teacher_or_superuser_required
def manage_grader_view(request, assignment_id):
    """Uploads a grader for an assignment

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    grader_form = GraderScriptUploadForm()

    grader_file_errors = ""

    if request.method == "POST":
        if request.FILES.get("grader_file"):
            if request.FILES["grader_file"].size <= settings.SUBMISSION_SIZE_LIMIT:
                grader_form = GraderScriptUploadForm(
                    request.POST,
                    request.FILES,
                )
                if grader_form.is_valid():
                    try:
                        grader_text = request.FILES["grader_file"].read().decode()
                    except UnicodeDecodeError:
                        grader_file_errors = "Please don't upload binary files."
                    else:
                        assignment.save_grader_file(grader_text)

                        return redirect("assignments:show", assignment.id)
                else:
                    grader_file_errors = grader_form.errors
            else:
                grader_file_errors = "That file's too large. Are you sure it's a Python program?"
        else:
            grader_file_errors = "Please select a file."

    grader_file = assignment.grader_file
    if grader_file:
        with grader_file.open(mode="r") as f_obj:
            grader_text = f_obj.read()
    else:
        grader_text = ""

    return render(
        request,
        "assignments/grader.html",
        {
            "grader_form": grader_form,
            "grader_file_errors": grader_file_errors,
            "course": assignment.course,
            "folder": assignment.folder,
            "assignment": assignment,
            "grader_text": grader_text,
            "nav_item": "Manage grader" if grader_file else "Upload grader",
        },
    )


@teacher_or_superuser_required
def download_grader_view(request, assignment_id):
    """Downloads the grader for an assignment

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    grader_file = assignment.grader_file
    if not grader_file:
        raise http.Http404

    with grader_file.open() as f_obj:
        response = http.HttpResponse(f_obj.read(), content_type="text/plain")
    filename = f'{assignment.name.replace(" ", "_")}_{grader_file.name.split("/")[-1]}'
    response["Content-Disposition"] = f'attachment; filename="{filename}"'

    return response


@teacher_or_superuser_required
def manage_files_view(request, assignment_id):
    """List current assignment files and allow uploading new ones

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    form = FileUploadForm()

    file_errors = ""

    if request.method == "POST":
        if request.FILES.get("upload_file"):
            if request.FILES["upload_file"].size <= settings.SUBMISSION_SIZE_LIMIT:
                form = FileUploadForm(
                    request.POST,
                    request.FILES,
                )
                if form.is_valid():
                    try:
                        text = request.FILES["upload_file"].read().decode()
                    except UnicodeDecodeError:
                        file_errors = "Please don't upload binary files."
                    else:
                        assignment.save_file(text, request.FILES["upload_file"].name)

                        return redirect("assignments:manage_files", assignment.id)
                else:
                    file_errors = form.errors
            else:
                file_errors = "That file's too large."
        else:
            file_errors = "Please select a file."

    files = assignment.list_files()

    actions = assignment.course.file_actions.all()

    return render(
        request,
        "assignments/manage_files.html",
        {
            "files": files,
            "actions": actions,
            "form": form,
            "file_errors": file_errors,
            "course": assignment.course,
            "folder": assignment.folder,
            "assignment": assignment,
            "nav_item": "Manage files",
        },
    )


@teacher_or_superuser_required
def download_file_view(request, assignment_id, file_id):
    """Download a file

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
        file_id: The id of the file
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    file_name, file_path = assignment.get_file(file_id)

    with open(file_path, "rb") as f_obj:
        response = http.HttpResponse(f_obj.read(), content_type="text/plain")
    response["Content-Disposition"] = f'attachment; filename="{file_name}"'

    return response


@teacher_or_superuser_required
def delete_file_view(request, assignment_id, file_id):
    """Delete a file

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
        file_id: The id of the file to delete
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    assignment.delete_file(file_id)

    return redirect("assignments:manage_files", assignment.id)


@teacher_or_superuser_required
def file_action_view(request, assignment_id, action_id):
    """Run file actions on an assignment's files

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
        action_id: The primary key of the :class:`.FileAction`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    action = get_object_or_404(assignment.course.file_actions.all(), id=action_id)

    action.run(assignment)

    return redirect("assignments:manage_files", assignment.id)


@teacher_or_superuser_required
def choose_file_action(request, course_id: int):
    """Choose a file action template."""
    course = get_object_or_404(
        Course.objects.filter_editable(request.user),
        id=course_id,
    )

    if request.method == "POST":
        form = ChooseFileActionForm(request.POST)
        if form.is_valid():
            file_action = form.cleaned_data["file_action"]
            file_action.courses.add(course)
            return http.JsonResponse({"success": True})
        return http.JsonResponse({"success": False, "errors": form.errors.as_json()}, status=400)

    actions = FileAction.objects.exclude(courses=course)
    course_actions = course.file_actions.all()
    return render(
        request,
        "assignments/choose_file_action.html",
        {
            "actions": actions,
            "course_actions": course_actions,
            "course": course,
            "nav_item": "Choose file action",
        },
    )


@teacher_or_superuser_required
def create_file_action(request, course_id: int):
    """Creates or edits a :class:`.FileAction`

    If the ``GET`` request has a ``action`` parameter,
    the view will action as an edit view.

    Args:
        request: The request
        course_id: The primary key of the :class:`.Course`
    """
    course = get_object_or_404(Course.objects.filter_editable(request.user), id=course_id)
    if (action_id := request.GET.get("action", "")).isdigit():
        action = get_object_or_404(course.file_actions, id=action_id)
    else:
        action = None

    if request.method == "POST":
        form = FileActionForm(request.POST, instance=action)
        if form.is_valid():
            action = form.save(commit=False)
            if request.POST.get("copy"):
                action.pk = None
                action._state.adding = True
            action.save()
            action.courses.add(course)
            return redirect("courses:show", course.id)
    else:
        form = FileActionForm(instance=action)

    return render(
        request,
        "assignments/custom_file_action.html",
        {
            "form": form,
            "action": action,
            "course": course,
            "nav_item": "Create file action",
        },
    )


@teacher_or_superuser_required
@require_POST
def delete_file_action_view(request, course_id: int):
    """Removes a :class:`.FileAction` from a :class:`.Course`.

    This does NOT permanently delete the :class:`.FileAction`.

    Args:
        request: The request
        course_id: The primary key of the :class:`.Course`
        action_id: The primary key of the :class:`.FileAction`
    """
    course = get_object_or_404(Course.objects.filter_editable(request.user), id=course_id)
    form = ChooseFileActionForm(request.POST)
    if form.is_valid():
        action = form.cleaned_data["file_action"]
        action.courses.remove(course)
        return http.JsonResponse({"success": True})
    return http.JsonResponse({"success": False, "errors": form.errors.as_json()}, status=400)


@teacher_or_superuser_required
def student_submissions_view(request, assignment_id, student_id):
    """See the submissions of a student

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
        student_id: The primary key of the student model
    """
    assignment: Assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    student = get_object_or_404(User, id=student_id)

    submissions = Submission.objects.filter(student=student, assignment=assignment)
    publishes = PublishedSubmission.objects.filter(student=student, assignment=assignment)
    latest_submission = submissions.latest() if submissions else None
    published_submission = publishes.latest().submission if publishes else latest_submission

    log_messages = (
        assignment.log_messages.filter(student=student).order_by("date")
        if assignment.is_quiz
        else None
    )

    return render(
        request,
        "assignments/student_submissions.html",
        {
            "course": assignment.course,
            "folder": assignment.folder,
            "assignment": assignment,
            "student": student,
            "submissions": submissions.order_by("-date_submitted"),
            "latest_submission": latest_submission,
            "published_submission": published_submission,
            "log_messages": log_messages,
        },
    )


@login_required
def submit_view(request, assignment_id):
    """Submit an assignment

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_submittable(request.user),
        id=assignment_id,
    )

    if assignment.is_quiz:
        raise http.Http404

    student = request.user

    submissions = Submission.objects.filter(student=student, assignment=assignment)
    latest_submission = submissions.latest() if submissions else None
    latest_submission_text = latest_submission.file_text if latest_submission else None

    file_form = FileSubmissionForm()
    text_form = TextSubmissionForm(initial={"text": latest_submission_text})

    file_errors = ""
    text_errors = ""

    if request.method == "POST":
        if assignment.grader_file is None:
            return redirect("assignments:show", assignment.id)

        if (
            Submission.objects.filter(student=request.user, complete=False).count()
            >= settings.CONCURRENT_USER_SUBMISSION_LIMIT
        ):
            if request.FILES.get("file"):
                file_form = FileSubmissionForm(request.POST, request.FILES)
                file_errors = (
                    "You may only have a maximum of {} submission{} running at the same "
                    "time".format(
                        settings.CONCURRENT_USER_SUBMISSION_LIMIT,
                        "" if settings.CONCURRENT_USER_SUBMISSION_LIMIT == 1 else "s",
                    )
                )
            else:
                text_form = TextSubmissionForm(request.POST)
                text_errors = (
                    "You may only have a maximum of {} submission{} running at the same "
                    "time".format(
                        settings.CONCURRENT_USER_SUBMISSION_LIMIT,
                        "" if settings.CONCURRENT_USER_SUBMISSION_LIMIT == 1 else "s",
                    )
                )
        elif CooldownPeriod.exists(assignment=assignment, student=student):
            cooldown_period = CooldownPeriod.objects.get(assignment=assignment, student=student)

            end_delta = cooldown_period.get_time_to_end()
            # Throw out the microseconds
            end_delta = datetime.timedelta(days=end_delta.days, seconds=end_delta.seconds)

            if request.FILES.get("file"):
                file_form = FileSubmissionForm(request.POST, request.FILES)
                file_errors = (
                    "You have made too many submissions too quickly. You will be able to "
                    f"re-submit in {end_delta}."
                )
            else:
                text_form = TextSubmissionForm(request.POST)
                text_errors = (
                    "You have made too many submissions too quickly. You will be able to "
                    f"re-submit in {end_delta}."
                )
        elif request.FILES.get("file"):
            if request.FILES["file"].size <= settings.SUBMISSION_SIZE_LIMIT:
                file_form = FileSubmissionForm(request.POST, request.FILES)
                if file_form.is_valid():
                    try:
                        submission_text = request.FILES["file"].read().decode()
                    except UnicodeDecodeError:
                        file_errors = "Please don't upload binary files."
                    else:
                        submission = Submission()
                        submission.assignment = assignment
                        submission.student = student
                        submission.save_file(submission_text)
                        submission.save()

                        assignment.check_rate_limit(student)

                        submission.create_backup_copy(submission_text)

                        run_submission.delay(submission.id)
                        return redirect("assignments:show", assignment.id)
            else:
                file_errors = "That file's too large. Are you sure it's a Python program?"
        else:
            text_form = TextSubmissionForm(request.POST)
            if text_form.is_valid():
                submission_text = text_form.cleaned_data["text"]
                if len(submission_text) <= settings.SUBMISSION_SIZE_LIMIT:
                    submission = text_form.save(commit=False)
                    submission.assignment = assignment
                    submission.student = student
                    submission.save_file(submission_text)
                    submission.save()

                    assignment.check_rate_limit(student)

                    submission.create_backup_copy(submission_text)

                    run_submission.delay(submission.id)
                    return redirect("assignments:show", assignment.id)
                else:
                    text_errors = "Submission too large"

    return render(
        request,
        "assignments/submit.html",
        {
            "file_form": file_form,
            "text_form": text_form,
            "file_errors": file_errors,
            "text_errors": text_errors,
            "course": assignment.course,
            "folder": assignment.folder,
            "assignment": assignment,
            "nav_item": "Submit",
        },
    )


def rerun_view(request, assignment_id):
    """Rerun select submissions

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment`
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    course = assignment.course
    period = request.GET.get("period", "")

    if period == "all":
        students = course.students.all()
    elif course.period_set.exists():
        students = get_object_or_404(
            Period.objects.filter(course=course), id=int(period)
        ).students.all()
    else:
        raise http.Http404

    submission_reruns = []

    for student in students:
        submissions = Submission.objects.filter(student=student, assignment=assignment)
        latest_submission = submissions.latest() if submissions else None
        publishes = PublishedSubmission.objects.filter(student=request.user, assignment=assignment)
        published_submission = publishes.latest().submission if publishes else latest_submission
        if published_submission:
            submission_reruns.append(published_submission.rerun())

    celery.group(submission_reruns).delay()

    return redirect("assignments:show", assignment.id)


@login_required
def quiz_view(request, assignment_id):
    """The view for taking a Quiz

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment: Assignment = get_object_or_404(
        Assignment.objects.filter_visible(request.user).filter(course__archived=False),
        id=assignment_id,
    )

    if not assignment.is_quiz or not assignment.quiz_open_for_student(request.user):
        raise http.Http404

    student = request.user

    submissions = Submission.objects.filter(student=student, assignment=assignment)
    latest_submission = submissions.latest() if submissions else None
    latest_submission_text = latest_submission.file_text if latest_submission else ""

    text_form = TextSubmissionForm(initial={"text": latest_submission_text})
    text_errors = ""

    if request.method == "POST":
        if assignment.grader_file is None:
            return redirect("assignments:show", assignment.id)

        if (
            Submission.objects.filter(student=request.user, complete=False).count()
            >= settings.CONCURRENT_USER_SUBMISSION_LIMIT
        ):
            text_form = TextSubmissionForm(request.POST)
            text_errors = (
                "You may only have a maximum of {} submission{} running at the same time".format(
                    settings.CONCURRENT_USER_SUBMISSION_LIMIT,
                    "" if settings.CONCURRENT_USER_SUBMISSION_LIMIT == 1 else "s",
                )
            )
        elif CooldownPeriod.exists(assignment=assignment, student=student):
            cooldown_period = CooldownPeriod.objects.get(assignment=assignment, student=student)

            end_delta = cooldown_period.get_time_to_end()
            # Throw out the microseconds
            end_delta = datetime.timedelta(days=end_delta.days, seconds=end_delta.seconds)

            text_form = TextSubmissionForm(request.POST)
            text_errors = (
                "You have made too many submissions too quickly. You will be able to re-submit"
                f"in {end_delta}."
            )
        else:
            text_form = TextSubmissionForm(request.POST)
            if text_form.is_valid():
                submission_text = text_form.cleaned_data["text"]
                if len(submission_text) <= settings.SUBMISSION_SIZE_LIMIT:
                    submission = text_form.save(commit=False)
                    submission.assignment = assignment
                    submission.student = student
                    submission.save_file(submission_text)
                    submission.save()

                    assignment.check_rate_limit(student)

                    submission.create_backup_copy(submission_text)

                    run_submission.delay(submission.id)
                    return redirect("assignments:quiz", assignment.id)
                else:
                    text_errors = "Submission too large"

    quiz_color = assignment.quiz_issues_for_student(request.user) and assignment.quiz_action == "1"

    return render(
        request,
        "assignments/quiz.html",
        {
            "nav_item": "Take Quiz",
            "course": assignment.course,
            "folder": assignment.folder,
            "assignment": assignment,
            "latest_submission": latest_submission,
            "text_form": text_form,
            "text_errors": text_errors,
            "quiz_color": quiz_color,
        },
    )


@login_required
def quiz_report_view(request, assignment_id):
    """Allows client-side JavaScript to report quiz log messages

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_visible(request.user), id=assignment_id
    )

    content = request.GET.get("content", "")
    severity = int(request.GET.get("severity", 0))

    action = "no action"

    if not assignment.quiz_ended_for_student(request.user):
        QuizLogMessage.objects.create(
            assignment=assignment, student=request.user, content=content, severity=severity
        )

        if severity >= settings.QUIZ_ISSUE_THRESHOLD:
            if assignment.quiz_action == "1":
                action = "color"
            elif assignment.quiz_action == "2":
                action = "lock"

    return http.JsonResponse({"action": action})


@login_required
def quiz_end_view(request, assignment_id):
    """The view for ending a quiz

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_visible(request.user), id=assignment_id
    )

    QuizLogMessage.objects.create(
        assignment=assignment, student=request.user, content="Ended quiz", severity=0
    )

    return redirect("assignments:show", assignment.id)


@teacher_or_superuser_required
def quiz_clear_view(request, assignment_id, user_id):
    """Clear the log messages of a user.

    This effectively also restarts the quiz.

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
        user_id: The primary key of the user
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    user = get_object_or_404(get_user_model(), id=user_id)

    assignment.log_messages.filter(student=user).delete()

    return redirect("assignments:student_submission", assignment.id, user.id)


@teacher_or_superuser_required
def scores_csv_view(request, assignment_id):
    """Get a ``.csv`` of the scores

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    course = assignment.course
    period = request.GET.get("period", "")

    if period == "all":
        students = course.students.all()
        name = f"assignment_{assignment.id}_all_scores.csv"
    elif course.period_set.exists():
        period_obj = get_object_or_404(Period.objects.filter(course=course), id=int(period))
        students = period_obj.students.all()
        name = "assignment_{}_period_{}_scores.csv".format(
            assignment.id, period_obj.name.replace(" ", "_")
        )
    else:
        raise http.Http404

    response = http.HttpResponse(content_type="text/csv")
    response["Content-Disposition"] = f"attachment; filename={name}"

    writer = csv.writer(response)
    writer.writerow(["Name", "Username", "Period", "Raw Score", "Final Score", "Formatted Grade"])

    for student in students.order_by("periods", "last_name"):
        row = [student.full_name, student.username]
        periods = ", ".join([p.name for p in student.periods.filter(course=assignment.course)])
        row.append(periods)

        submissions = Submission.objects.filter(student=student, assignment=assignment)
        latest_submission = submissions.latest() if submissions else None
        publishes = PublishedSubmission.objects.filter(student=student, assignment=assignment)
        published_submission = publishes.latest().submission if publishes else latest_submission
        if published_submission is not None:
            if published_submission.points_received:
                row.append(published_submission.points_received)
                row.append(published_submission.points)
                row.append(published_submission.formatted_grade)
            else:
                row.append("NG")
                row.append("NG")
                row.append("NG")
        else:
            row.append("M")
            row.append("M")
            row.append("M")
        writer.writerow(row)

    return response


@teacher_or_superuser_required
def download_submissions_view(request, assignment_id):
    """Download the submissions as a zipped file

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    course = assignment.course
    period = request.GET.get("period", "")

    if period == "all":
        students = course.students.all()
        name = f"assignment_{assignment.id}_all_submissions.zip"
    elif course.period_set.exists():
        period_obj = get_object_or_404(Period.objects.filter(course=course), id=int(period))
        students = period_obj.students.all()
        name = "assignment_{}_period_{}_submissions.zip".format(
            assignment.id, period_obj.name.replace(" ", "_")
        )
    else:
        raise http.Http404

    language = "P" if assignment.filename.endswith(".py") else "J"
    extension = "java" if language == "J" else "py"

    s = BytesIO()
    with zipfile.ZipFile(s, "w") as zf:
        for student in students:
            submissions = Submission.objects.filter(student=student, assignment=assignment)
            latest_submission = submissions.latest() if submissions else None
            publishes = PublishedSubmission.objects.filter(student=student, assignment=assignment)
            published_submission = publishes.latest().submission if publishes else latest_submission
            if published_submission is not None:
                file_with_header = published_submission.file_text_with_header
                zf.writestr(f"{student.username}.{extension}", file_with_header)
    resp = http.HttpResponse(s.getvalue(), content_type="application/x-zip-compressed")
    resp["Content-Disposition"] = f"attachment; filename={name}"
    return resp


@teacher_or_superuser_required
def moss_view(request, assignment_id):
    """Allows teachers to select submissions and send them to Moss.

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )
    course = assignment.course
    period = request.GET.get("period", "")

    if period and period != "all" and course.period_set.exists():
        period = get_object_or_404(Period.objects.filter(course=course), id=int(period))
    else:
        period = None

    errors = ""
    filename = assignment.filename

    if request.method == "POST":
        form = MossForm(assignment, period, request.POST, request.FILES)
        if form.is_valid():
            moss_result = form.save(commit=False)
            moss_result.assignment = assignment
            moss_result.filename = filename
            moss_result.save()
            run_moss.delay(moss_result.id)
        return redirect(
            reverse("assignments:moss", kwargs={"assignment_id": assignment_id})
            + (f"?period={period.id}" if period else "")
        )

    form = MossForm(assignment, period)

    past_results = assignment.moss_results.order_by("-date")

    return render(
        request,
        "assignments/moss.html",
        {
            "form": form,
            "errors": errors,
            "past_results": past_results,
            "course": course,
            "folder": assignment.folder,
            "assignment": assignment,
            "nav_item": "Run Moss",
        },
    )


@teacher_or_superuser_required
def download_log_view(request, assignment_id):
    """Download the log messages

    Args:
        request: The request
        assignment_id: The primary key of the :class:`.Assignment` model
    """
    assignment = get_object_or_404(
        Assignment.objects.filter_editable(request.user), id=assignment_id
    )

    log_file_name = os.path.join(settings.MEDIA_ROOT, assignment.grader_log_filename)

    if (
        request.user not in assignment.course.teacher.all() and not request.user.is_superuser
    ) or not os.path.exists(log_file_name):
        raise http.Http404

    assigment_dir = os.path.dirname(log_file_name)

    args = sandboxing.get_assignment_sandbox_args(
        ["cat", "--", log_file_name],
        network_access=False,
        whitelist=[assigment_dir],
        read_only=[assigment_dir],
    )

    try:
        res = subprocess.run(
            args,
            capture_output=True,
            text=True,
            check=True,
        )
    except FileNotFoundError as e:
        logger.error("Cannot run processes: %s", e)
        raise FileNotFoundError from e

    data = res.stdout

    response = http.HttpResponse(data, content_type="text/plain")
    response["Content-Disposition"] = (
        f'attachment; filename="{slugify(assignment.name)}-grader.log"'
    )

    return response


@login_required
def show_folder_view(request, course_id, folder_id):
    """Show a folder

    Args:
        request: The request
        course_id: The primary key of the :class:`.Course` model
        folder_id: The primary key of the :class:`.Folder` model
    """
    course = get_object_or_404(Course.objects.filter_visible(request.user), id=course_id)
    folder = get_object_or_404(course.folders.all(), id=folder_id)

    assignments = course.assignments.filter(folder=folder).filter_visible(request.user)
    if course.sort_assignments_by == "due_date":
        assignments = assignments.order_by("-due")
    elif course.sort_assignments_by == "name":
        assignments = assignments.order_by("name")

    context = {
        "course": course,
        "folder": folder,
        "assignments": assignments,
        "period": course.period_set.filter(students=request.user),
        "is_student": course.is_student_in_course(request.user),
        "is_teacher": request.user in course.teacher.all(),
    }
    if course.is_student_in_course(request.user):
        context["unsubmitted_assignments"] = assignments.exclude(submissions__student=request.user)

    return render(request, "assignments/show_folder.html", context=context)


@teacher_or_superuser_required
def create_folder_view(request, course_id):
    """Create a folder

    Args:
        request: The request
        course_id: The primary key of the :class:`.Course` model
    """
    course = get_object_or_404(Course.objects.filter_editable(request.user), id=course_id)

    if request.method == "POST":
        form = FolderForm(request.POST)
        if form.is_valid():
            folder = form.save(commit=False)
            folder.course = course
            folder.save()
            return redirect("courses:show", course.id)

    form = FolderForm()
    context = {
        "form": form,
        "nav_item": "Create folder",
        "course": course,
        "action": "add",
    }

    return render(request, "assignments/edit_create_folder.html", context=context)


@teacher_or_superuser_required
def edit_folder_view(request, course_id, folder_id):
    """Edit a folder

    Args:
        request: The request
        course_id: The primary key of the :class:`.Course` model
        folder_id: The primary key of the :class:`.Folder` model
    """
    course = get_object_or_404(Course.objects.filter_editable(request.user), id=course_id)
    folder = get_object_or_404(course.folders.all(), id=folder_id)

    if request.method == "POST":
        form = FolderForm(request.POST, instance=folder)
        if form.is_valid():
            form.save()
            return redirect("assignments:show_folder", course.id, folder.id)

    form = FolderForm(instance=folder)
    context = {
        "form": form,
        "nav_item": "Edit",
        "course": course,
        "folder": folder,
        "action": "edit",
    }

    return render(request, "assignments/edit_create_folder.html", context=context)


@teacher_or_superuser_required
def delete_folder_view(request, course_id, folder_id):
    """Delete a folder

    Args:
        request: The request
        course_id: The primary key of the :class:`.Course` model
        folder_id: The primary key of the :class:`.Folder` model
    """
    course = get_object_or_404(Course.objects.filter_editable(request.user), id=course_id)
    folder = get_object_or_404(course.folders.all(), id=folder_id)

    folder.delete()
    return redirect("courses:show", course.id)

tjcsl / tin / 11413675820

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous