# -*- coding: utf-8 -*-
from __future__ import division
__copyright__ = "Copyright (C) 2015 Andreas Kloeckner, Dong Zhuang"
__license__ = """
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
"""
from typing import cast
from django.utils.translation import (
gettext_lazy as _, gettext)
from django.utils.safestring import mark_safe
from course.validation import validate_struct, validate_markup, ValidationError
from course.content import remove_prefix
import django.forms as forms
from relate.utils import Struct, StyledInlineForm, string_concat
from course.page.base import (
AnswerFeedback, PageBaseWithValue, markup_to_html)
from course.page.text import TextQuestionBase, parse_matcher
import re
# {{{ for mypy
from typing import Tuple, Text, Optional, Any, Iterable, List # noqa
# }}}
# {{{ multiple text question
from crispy_forms.layout import Layout, HTML
from crispy_forms.bootstrap import PrependedAppendedText
class InlineMultiQuestionForm(StyledInlineForm):
no_offset_labels = True
def __init__(self, read_only, dict_for_form, page_context, *args, **kwargs):
super(InlineMultiQuestionForm, self).__init__(*args, **kwargs)
html_list = dict_for_form["html_list"]
self.answer_instance_list = answer_instance_list = \
dict_for_form["answer_instance_list"]
correctness_list = None
if "correctness_list" in dict_for_form:
correctness_list = dict_for_form["correctness_list"]
self.helper.layout = Layout()
# for question with only one field, the field is forced
# to be "required".
if len(answer_instance_list) == 1:
force_required = True
else:
force_required = False
for idx, html_item in enumerate(html_list):
if html_list[idx] != "":
self.helper.layout.extend([
HTML(html_item)])
# for fields embedded in html, the defined html_list can be
# longer than the answer_instance_list.
if idx < len(answer_instance_list):
field_name = answer_instance_list[idx].name
self.fields[field_name] = answer_instance_list[idx] \
.get_form_field(page_context, force_required=force_required)
if correctness_list is None:
self.helper.layout.extend([
answer_instance_list[idx].get_field_layout()])
else:
self.helper.layout.extend([
answer_instance_list[idx].get_field_layout(
correctness=correctness_list[idx])])
if read_only:
if isinstance(self.fields[field_name].widget,
forms.widgets.Select):
# This will also disable the option dropdown
self.fields[field_name].widget.attrs["disabled"] \
= "disabled"
else:
# Then it should be a TextInput widget
self.fields[field_name].widget.attrs["readonly"] \
= "readonly"
self.helper.layout.extend([HTML("
")])
def clean(self):
cleaned_data = super(InlineMultiQuestionForm, self).clean()
answer_name_list = [answer_instance.name
for answer_instance in self.answer_instance_list]
for answer in list(cleaned_data.keys()):
idx = answer_name_list.index(answer)
instance_idx = self.answer_instance_list[idx]
field_name_idx = instance_idx.name
if hasattr(instance_idx, "matchers"):
for i, validator in enumerate(instance_idx.matchers): # pragma: no branch # noqa
try:
validator.validate(cleaned_data[answer])
except forms.ValidationError:
if i + 1 == len(instance_idx.matchers):
# last one, and we flunked -> not valid
import sys
tp, e, _ = sys.exc_info()
self.add_error(field_name_idx, e)
else:
# Found one that will take the input. Good enough.
break
def get_question_class(location, q_type, answers_desc):
for question_class in ALLOWED_EMBEDDED_QUESTION_CLASSES:
if question_class.type == q_type:
return question_class
else:
raise ValidationError(
string_concat(
"%(location)s: ",
_("unknown embedded question type '%(type)s'"))
% {
"location": location,
"type": q_type})
def parse_question(vctx, location, name, answers_desc):
if isinstance(answers_desc, Struct):
return (get_question_class(location, answers_desc.type, answers_desc)
(vctx, location, name, answers_desc))
else:
raise ValidationError(
string_concat(
"%s: ",
_("Embedded question '%s' must be a struct" % name))
% location)
class AnswerBase(object):
"""Abstract interface for answer class of different type.
.. attribute:: type
.. attribute:: form_field_class
"""
def __init__(self, vctx, location, name, answers_desc):
self.name = name
self.answers_desc = answers_desc
self.required = getattr(answers_desc, "required", False)
def get_answer_text(self, page_context, answer):
return answer
def get_correct_answer_text(self, page_context):
raise NotImplementedError()
def get_correctness(self, answer):
raise NotImplementedError()
def get_weight(self, answer):
if answer is None or answer == "":
return 0
return self.weight * self.get_correctness(answer)
def get_field_layout(self, correctness=None):
kwargs = {}
kwargs["prepended_text"] = getattr(self.answers_desc, "prepended_text", "")
kwargs["appended_text"] = getattr(self.answers_desc, "appended_text", "")
kwargs["use_popover"] = "true"
kwargs["popover_title"] = getattr(self.answers_desc, "hint_title", "")
kwargs["popover_content"] = getattr(self.answers_desc, "hint", "")
if correctness is None:
kwargs["style"] = self.get_width_str()
else:
kwargs["style"] = self.get_width_str(self.width + 2)
kwargs["correctness"] = correctness
return PrependedAppendedText(self.name, **kwargs)
def get_form_field(self, page_context):
raise NotImplementedError()
# length unit used is "em"
DEFAULT_WIDTH = 10
MINIMUN_WIDTH = 4
EM_LEN_DICT = {
"em": 1,
"pt": 10.00002,
"cm": 0.35146,
"mm": 3.5146,
"in": 0.13837,
"%": ""}
ALLOWED_LENGTH_UNIT = EM_LEN_DICT.keys()
WIDTH_STR_RE = re.compile(r"^(\d*\.\d+|\d+)\s*(.*)$")
class ShortAnswer(AnswerBase):
type = "ShortAnswer"
form_field_class = forms.CharField
@staticmethod
def get_length_attr_em(location, width_attr):
# type: (Text, Text) -> Optional[float]
"""
generate the length for input box, the unit is 'em'
"""
if width_attr is None:
return None
if isinstance(width_attr, (int, float)):
return width_attr
width_re_match = WIDTH_STR_RE.match(width_attr)
if width_re_match:
length_value = width_re_match.group(1)
length_unit = width_re_match.group(2)
else:
raise ValidationError(
string_concat(
"%(location)s: ",
_("unrecogonized width attribute string: "
"'%(width_attr)s'"))
% {
"location": location,
"width_attr": width_attr
})
if length_unit not in ALLOWED_LENGTH_UNIT:
raise ValidationError(
string_concat(
"%(location)s: ",
_("unsupported length unit '%(length_unit)s', "
"expected length unit can be "
"%(allowed_length_unit)s", ))
% {
"location": location,
"length_unit": length_unit,
"allowed_length_unit": ", ".join(
["'" + item + "'"
for item in ALLOWED_LENGTH_UNIT])
})
if length_unit == "%":
return float(length_value)*DEFAULT_WIDTH/100.0
else:
return float(length_value)/cast(float, EM_LEN_DICT[length_unit])
def __init__(self, vctx, location, name, answers_desc):
super(ShortAnswer, self).__init__(
vctx, location, name, answers_desc)
validate_struct(
vctx,
location,
answers_desc,
required_attrs=(
("type", str),
("correct_answer", list)
),
allowed_attrs=(
("weight", (int, float)),
("prepended_text", str),
("appended_text", str),
("hint", str),
("hint_title", str),
("width", (str, int, float)),
("required", bool),
),
)
weight = getattr(answers_desc, "weight", 0)
if weight < 0:
raise ValidationError(
string_concat(
"%s: %s: ",
_("'weight' must be a non-negative value, "
"got '%s' instead") % str(weight))
% (location, self.name))
self.weight = weight
if len(answers_desc.correct_answer) == 0:
raise ValidationError(
string_concat(
"%s: %s: ",
_("at least one answer must be provided"))
% (location, self.name))
self.hint = getattr(self.answers_desc, "hint", "")
width = getattr(self.answers_desc, "width", None)
parsed_length = self.get_length_attr_em(
"%s: %s: 'width'" % (location, self.name), width)
self.width = 0
if parsed_length is not None:
self.width = max(MINIMUN_WIDTH, parsed_length)
else:
self.width = DEFAULT_WIDTH
self.width_str = "width: " + str(self.width) + "em"
self.matchers = [
parse_matcher(
vctx,
string_concat("%s, ",
# Translators: refers to optional
# correct answer for checking
# correctness sumbitted by students.
_("answer"),
" %d") % (location, i+1),
answer)
for i, answer in enumerate(answers_desc.correct_answer)]
if not any(matcher.correct_answer_text() is not None
for matcher in self.matchers):
raise ValidationError(
string_concat(
"%s: %s: ",
_("no matcher is able to provide a plain-text "
"correct answer"))
% (location, self.name))
def get_width_str(self, opt_width=0):
return "width: " + str(max(self.width, opt_width)) + "em"
def get_correct_answer_text(self, page_context):
unspec_correct_answer_text = None
for matcher in self.matchers: # pragma: no branch # noqa
unspec_correct_answer_text = matcher.correct_answer_text()
if unspec_correct_answer_text is not None:
break
assert unspec_correct_answer_text is not None
return ("%s%s%s"
% (getattr(self.answers_desc, "prepended_text", "").strip(),
unspec_correct_answer_text,
getattr(self.answers_desc, "appended_text", "").strip())
)
def get_correctness(self, answer):
correctnesses = [0]
# If empty an list, sometime it will cause ValueError:
# max() arg is an empty sequence, observed in SandBox
for matcher in self.matchers:
try:
matcher.validate(answer)
except forms.ValidationError:
continue
correctnesses.append(matcher.grade(answer))
return max(correctnesses)
def get_form_field(self, page_context, force_required=False):
return (self.form_field_class)(
required=self.required or force_required,
widget=None,
help_text=None,
label=self.name
)
class ChoicesAnswer(AnswerBase):
type = "ChoicesAnswer"
form_field_class = forms.ChoiceField
CORRECT_TAG = "~CORRECT~"
@classmethod
def process_choice_string(cls, page_context, s):
if not isinstance(s, str):
s = str(s)
s = remove_prefix(cls.CORRECT_TAG, s)
s_contain_p_tag = "
" in s s = markup_to_html(page_context, s) # allow HTML in option if not s_contain_p_tag: s = s.replace("
", "").replace("
", "") s = mark_safe(s) return s def __init__(self, vctx, location, name, answers_desc): super(ChoicesAnswer, self).__init__( vctx, location, name, answers_desc) validate_struct( vctx, location, answers_desc, required_attrs=( ("type", str), ("choices", list) ), allowed_attrs=( ("weight", (int, float)), ("hint", str), ("hint_title", str), ("required", bool), ), ) self.weight = getattr(answers_desc, "weight", 0) correct_choice_count = 0 for choice_idx, choice in enumerate(answers_desc.choices): try: choice = str(choice) except Exception: raise ValidationError( string_concat( "%(location)s: '%(answer_name)s' ", _("choice %(idx)d: unable to convert to string") ) % {"location": location, "answer_name": self.name, "idx": choice_idx+1}) if choice.startswith(self.CORRECT_TAG): correct_choice_count += 1 if vctx is not None: validate_markup(vctx, location, remove_prefix(self.CORRECT_TAG, choice)) if correct_choice_count < 1: raise ValidationError( string_concat( "%(location)s: ", _("one or more correct answer(s) expected " " for question '%(question_name)s', " "%(n_correct)d found")) % { "location": location, "question_name": self.name, "n_correct": correct_choice_count}) self.hint = getattr(self.answers_desc, "hint", "") self.width = 0 def get_answer_text(self, page_context, answer): if answer == "": return answer return self.process_choice_string( page_context, self.answers_desc.choices[int(answer)]) def get_width_str(self, opt_width=0): return None def correct_indices(self): result = [] for i, choice_text in enumerate(self.answers_desc.choices): if str(choice_text).startswith(self.CORRECT_TAG): result.append(i) return result def get_correct_answer_text(self, page_context): corr_idx = self.correct_indices()[0] return ("%s%s%s" % ( getattr(self.answers_desc, "prepended_text", "").strip(), self.process_choice_string( page_context, self.answers_desc.choices[corr_idx]).lstrip(), getattr(self.answers_desc, "appended_text", "").strip()) ) def get_max_correct_answer_len(self, page_context): return max([len(answer) for answer in [self.process_choice_string(page_context, processed) for processed in self.answers_desc.choices]]) def get_correctness(self, answer): if answer == "": return 0 if int(answer) in self.correct_indices(): return 1 return 0 def get_form_field(self, page_context, force_required=False): choices = tuple( (i, self.process_choice_string( page_context, self.answers_desc.choices[i])) for i, src_i in enumerate(self.answers_desc.choices)) choices = ( (None, "-"*self.get_max_correct_answer_len(page_context)), ) + choices return (self.form_field_class)( required=self.required or force_required, choices=tuple(choices), widget=None, help_text=None, label="" ) ALLOWED_EMBEDDED_QUESTION_CLASSES = [ ShortAnswer, ChoicesAnswer ] WRAPPED_NAME_RE = re.compile(r"[^{](?=(\[\[[^\[\]]*\]\]))[^}]") NAME_RE = re.compile(r"[^{](?=\[\[([^\[\]]*)\]\])[^}]") NAME_VALIDATE_RE = re.compile("^[a-zA-Z]+[a-zA-Z0-9_]{0,}$") class InlineMultiQuestion(TextQuestionBase, PageBaseWithValue): r""" An auto-graded page with cloze like questions. .. attribute:: id |id-page-attr| .. attribute:: type ``InlineMultiQuestion`` .. attribute:: is_optional_page |is-optional-page-attr| .. attribute:: access_rules |access-rules-page-attr| .. attribute:: title |title-page-attr| .. attribute:: question The body of the question, with answer fields wrapped by paired ``[[`` and ``]]``, written in :ref:`markup`. .. attribute:: answers Answers of the questions, written in :ref:`markup`. Each cloze question require an answer struct. The question now support cloze question of TextAnswer and ChoiceAnswer type. .. attribute:: answer_explanation Text justifying the answer, written in :ref:`markup`. Example: .. code-block:: yaml type: InlineMultiQuestion id: inlinemulti value: 10 prompt: | # An InlineMultiQuestion example Complete the following paragraph. question: | Foo and [[blank1]] are often used in code examples, or tutorials. $\frac{1}{5}$ is equivalent to [[blank_2]]. The correct answer for this choice question is [[choice_a]]. The Upper case of "foo" is [[choice2]]. One dollar is [[blank3]], and five percent is [[blank4]], and "Bar" wrapped by a pair of parentheses is [[blank5]]. answers: blank1: type: ShortAnswer width: 4em required: True hint: Tex can be rendered in hint, e.g. $x_1$. hint_title: Hint correct_answer: -tags and change
# to line break. return markup_to_html( page_context, self.page_desc.question, ).replace("", "").replace("
", "