- changed text-numeric to numeric-interval

- many changes and fixes. review still hardcoded...

- changed text-numeric to numeric-interval
- many changes and fixes. review still hardcoded...
Miguel Barão
1 parent c68097b2
Showing 12 changed files with 236 additions and 80 deletions Show diff stats
BUGS.md
demo/questions/questions-tutorial.yaml
demo/test-tutorial.yaml
questions.py
serve.py
static/css/test.css
templates/question-success.html
templates/question-warning.html
templates/question.html
templates/review-question.html
templates/test.html
test.py
  
 # BUGS
  
-- testar perguntas warning/warn
-- text-numeric não está a gerar a pergunta. faltam templates?
+- numeracao das perguntas do teste esta a contar com paineis informativos...
+- servir imagens das perguntas
+- review de um teste nao funciona (hardcoded...)
+- testar opcao --allow-all
+- como alterar configuracao para mostrar logs de debug?
+- hints nao funciona
 - uniformizar question.py com a de aprendizations...
 - Review de um teste que foi apagado rebenta.
 - permitir eliminar teste a decorrer de modo a que o aluno possa recomeçar (e.g. noutro browser)
@@ -11,13 +15,10 @@
 # TODO
  
 - Gerar pdf's com todos os testes no final (pdfkit).
-- testar SSL
 - manter registo dos unfocus durante o teste e de qual a pergunta visivel nesse momento
  
 - permitir varios testes, aluno escolhe qual o teste que quer fazer.
-- usar thread.Lock para aceder a variaveis de estado?
 - se ocorrer um erro na correcçao avisar aluno para contactar o professor.
-- implementar practice mode?
 - abrir o teste numa janela maximizada e que nao permite que o aluno a redimensione/mova?
 - detectar scroll e enviar posição para servidor (analise de scroll para detectar copianço? ou simplesmente para analisar como os alunos percorrem o teste)
 - single page web no teste/correcçao. Página construída em javascript, obter perguntas com ajax (para practice?).
@@ -30,6 +31,9 @@
  
 # FIXED
  
+- testar SSL
+- text-numeric não está a gerar a pergunta. faltam templates?
+- testar perguntas warning/warn
 - qd user 0 faz logout rebenta.
 - Quando grava JSON do teste deve usar 'path' tal como definido na configuração e não expandido. Isto porque em OSX /home é /Users e quando se muda de um sistema para outro não encontra os testes. Assim, usando ~ na configuração deveria funcionar sempre.
 - configuração do teste não joga bem com o do aprendizations. Em particular os scripts não ficam com o mesmo path!!!
@@ -0,0 +1,92 @@
+-
+    ref: tut-information
+    type: information
+    title: information (ou info)
+    text: Texto informativo. Não conta para avaliação.
+# ---------------------------------------------------------------------------
+-
+    ref: tut-success
+    type: success
+    title: success
+    text: Texto de positivo (sucesso). Não conta para avaliação.
+# ---------------------------------------------------------------------------
+-
+    ref: tut-warning
+    type: warning
+    title: warning (ou warn)
+    text: Texto de aviso. Não conta para avaliação.
+# ----------------------------------------------------------------------------
+-
+    ref: tut-alert
+    type: alert
+    title: alert
+    text: Texto negativo (alerta). Não conta para avaliação.
+# ----------------------------------------------------------------------------
+-
+    ref: tut-radio
+    type: radio
+    title: radio
+    text: Escolha simples, apenas uma opção está correcta.
+    options:
+        - Opção 0 (correcta)
+        - Opção 1
+        - Opção 2
+        - Opção 3
+    # opcionais e valores por defeito
+    shuffle: True
+    correct: 0
+# ----------------------------------------------------------------------------
+-
+    ref: tut-checkbox
+    type: checkbox
+    title: checkbox
+    text: Escolha simples, apenas uma opção está correcta.
+    options:
+        - Opção 0 (sim)
+        - Opção 1 (não)
+        - Opção 2 (não)
+        - Opção 3 (sim)
+    correct: [1,-1,-1,1]
+    # opcionais e valores por defeito
+    shuffle: True    
+# ----------------------------------------------------------------------------
+-
+    ref: tut-text
+    type: text
+    title: text
+    text: |
+        Resposta numa linha de texto. A resposta está correcta se coincidir com alguma das respostas admissíveis.
+        Neste exemplo a resposta correcta é `azul`, `Azul` ou `AZUL`.
+    correct: ['azul', 'Azul', 'AZUL']
+# ---------------------------------------------------------------------------
+-
+    ref: tut-text-regex
+    type: text-regex
+    title: text-regex
+    text: |
+        Resposta numa linha de texto. A resposta é validada com uma expressão regular.
+        Neste exemplo a expressão regular é `(VERDE|[Vv]erde)`.
+    correct: !regex '(VERDE|[Vv]erde)'
+# ---------------------------------------------------------------------------
+-
+    ref: tut-numeric-interval
+    type: numeric-interval
+    title: numeric-interval
+    text: |
+        Resposta numérica numa linha de texto. A resposta é convertida para um float e tem de pertencer a um intervalo de valores.
+        Neste exemplo o intervalo é [3.14, 3.15].
+    correct: [3.14, 3.15]
+# ---------------------------------------------------------------------------
+-
+    ref: tut-textarea
+    type: textarea
+    title: textarea
+    text: |
+        Resposta num bloco de texto que pode ser usado para introduzir código. 
+        A resposta é avaliada por um programa externo. 
+        O programa externo, recebe a resposta no stdin e devolve a classificação no stdout.
+        Neste exemplo, o programa de avaliação verifica se a resposta contém as três palavras red, green e blue.
+    correct: correct/correct-question.py
+    # opcionais e defaults
+    lines: 3
+    timeout: 5
@@ -0,0 +1,56 @@
+#=============================================================================
+# The test reference should be a unique identifier. It is saved in the database
+# so that queries for the results can be done in the terminal with
+#   $ sqlite3 students.db "select * from tests where ref='demo'"
+ref: tutorial
+
+# (optional, default: '') You may wish to refer the course, year or kind of test
+title: Teste tutorial
+
+# (optional) duration in minutes FIXME
+duration: 90
+
+# Database with student credentials and grades of all questions and tests done
+# The database is an sqlite3 file generate with the script initdb.py
+database: demo/students.db
+
+# Generate a file for each test done by a student.
+# It includes the questions, answers and grades.
+answers_dir: demo/ans
+
+# (optional, default: False) Show points for each question, scale 0-20.
+show_points: True
+
+# (optional, default: False) Show hints if available
+show_hints: True
+
+# (optional, default: False) Show lots of information for debugging
+# debug: True
+
+#-----------------------------------------------------------------------------
+# Base path applied to the questions files and all the scripts
+# including question generators and correctors.
+# Either absolute path or relative to current directory can be used.
+questions_dir: demo/questions
+
+# (optional) List of files containing questions in yaml format.
+# Selected questions will be obtained from these files.
+# If undefined, all yaml files in questions_dir are loaded (not recommended).
+files:
+    - questions-tutorial.yaml
+
+# This is the list of questions that will make up the test.
+# The order is preserved.
+# There are several ways to define each question (explained below).
+questions:
+    - tut-information
+    - tut-success
+    - tut-warning
+    - tut-alert
+    
+    - tut-radio
+    - tut-checkbox
+    - tut-text
+    - tut-text-regex
+    - tut-numeric-interval
+    - tut-textarea
@@ -275,7 +275,7 @@ class QuestionTextRegex(Question):
  
  
 # ===========================================================================
-class QuestionTextNumeric(Question):
+class QuestionNumericInterval(Question):
     '''An instance of QuestionTextNumeric will always have the keys:
         type (str)
         text (str)
@@ -302,6 +302,7 @@ class QuestionTextNumeric(Question):
             try:
                 answer = float(self['answer'])
  
+                # TODO:
                 # alternative using locale  (1.2 vs 1,2)
                 # import locale
                 # locale.setlocale(locale.LC_ALL, 'pt_PT')
@@ -401,8 +402,8 @@ class QuestionFactory(dict):
         'radio'     : QuestionRadio,
         'checkbox'  : QuestionCheckbox,
         'text'      : QuestionText,
-        'text_regex': QuestionTextRegex,     'text-regex': QuestionTextRegex,
-        'text_numeric': QuestionTextNumeric, 'text-numeric': QuestionTextNumeric,
+        'text-regex': QuestionTextRegex,
+        'numeric-interval': QuestionNumericInterval,
         'textarea'  : QuestionTextArea,
         # -- informative panels --
         'information': QuestionInformation, 'info': QuestionInformation,
@@ -420,22 +421,17 @@ class QuestionFactory(dict):
     # Add single question provided in a dictionary.
     # After this, each question will have at least 'ref' and 'type' keys.
     # -----------------------------------------------------------------------
-    def add(self, question):
-        # if ref missing try ref='/path/file.yaml:3'
-        try:
-            question.setdefault('ref', question['filename'] + ':' + str(question['index']))
-        except KeyError:
-            logger.error('Missing "ref". Cannot add question to the pool.')
-            return
+    def add_question(self, question):
+        # if missing defaults to ref='/path/file.yaml:3'
+        question.setdefault('ref', f'{question["filename"]}:{question["index"]}')
  
-        # check duplicate references
         if question['ref'] in self:
-            logger.error(f'Duplicate reference "{question["ref"]}". Replacing the original one!')
+            logger.error(f'Duplicate reference "{question["ref"]}" replaces the original.')
  
         question.setdefault('type', 'information')
  
         self[question['ref']] = question
-        logger.debug('Added question "{0}" to the pool.'.format(question['ref']))
+        logger.debug(f'Added question "{question["ref"]}" to the pool.')
  
     # -----------------------------------------------------------------------
     # load single YAML questions file
@@ -453,20 +449,19 @@ class QuestionFactory(dict):
  
         questions = load_yaml(fullpath, default=[])
  
-        n = 0
         for i, q in enumerate(questions):
-            if isinstance(q, dict):
+            try:
                 q.update({
                     'filename': filename,
                     'path': dirname,
-                    'index': i                # position in the file, 0 based
+                    'index': i              # position in the file, 0 based
                     })
-                self.add(q)                   # add question
-                n += 1                        # counter
-            else:
-                logger.error(f'Question index {i} from file {pathfile} is not a dictionary. Skipped!')
+            except AttributeError:
+                logger.error(f'Question {pathfile}:{i} is not a dictionary. Skipped!')
+            else:              
+                self.add_question(q)
  
-        logger.info(f'Loaded {n} questions from "{pathfile}".')
+        logger.info(f'Loaded {len(self)} questions from "{pathfile}".')
  
     # -----------------------------------------------------------------------
     # load multiple YAML question files
-#!/usr/bin/env python3
+#!/usr/bin/env python3.6
  
 # base
 from os import path
@@ -26,7 +26,7 @@ class WebApplication(tornado.web.Application):
             (r'/login',         LoginHandler),
             (r'/logout',        LogoutHandler),
             (r'/test',          TestHandler),
-            (r'/review',        ReviewHandler), # FIXME
+            (r'/review',        ReviewHandler),
             (r'/admin',         AdminHandler),
             # (r'/change_password', ChangePasswordHandler),
             (r'/static/(.+)',   FileHandler), # FIXME
@@ -76,7 +76,7 @@ class LoginHandler(BaseHandler):
             self.set_secure_cookie("user", str(uid), expires_days=30)
             self.redirect(self.get_argument("next", "/"))
         else:
-            self.render("login.html", error='Número ou senha incorrectos')
+            self.render("login.html", error='Não autorizado ou número/senha inválido')
  
 # -------------------------------------------------------------------------
 class LogoutHandler(BaseHandler):
@@ -110,10 +110,8 @@ class TestHandler(BaseHandler):
         'radio':        'question-radio.html',
         'checkbox':     'question-checkbox.html',
         'text':         'question-text.html',
-        # 'text_regex':   'question-text.html',
         'text-regex':   'question-text.html',
-        # 'text_numeric': 'question-text.html',
-        'text-numeric': 'question-text.html',
+        'numeric-interval': 'question-text.html',
         'textarea':     'question-textarea.html',
         # -- information panels --
         'information':  'question-information.html',
@@ -153,7 +151,7 @@ class TestHandler(BaseHandler):
                         ans[i] = None
                     else:
                         ans[i] = ans[i][0]
-                elif q['type'] in ('textarea', 'text', 'text-numeric', 'text-regex'):
+                elif q['type'] in ('text', 'text-regex', 'textarea', 'numeric-interval'):
                     ans[i] = ans[i][0]
  
         self.testapp.correct_test(uid, ans)
@@ -170,10 +168,12 @@ class ReviewHandler(BaseHandler):
         'checkbox':     'review-question-checkbox.html',
         'text':         'review-question-text.html',
         'text-regex':   'review-question-text.html',
-        'text-numeric': 'review-question-text.html',
+        'numeric-interval': 'review-question-text.html',
         'textarea':     'review-question-text.html',
         # -- information panels --
+        'information':  'question-information.html',
         'info':         'question-information.html',
+        'warning':      'question-warning.html',
         'warn':         'question-warning.html',
         'alert':        'question-alert.html',
         'success':      'question-success.html',
@@ -322,6 +322,7 @@ def main():
         logging.critical('Failed to start application.')
         sys.exit(1)
  
+    # --- start web application
     try:
         webapp = WebApplication(app, debug=arg.debug)
     except Exception as e:
 /* Fixes navigation panel overlaying content */
+html {
+    font-size: 14px;
+}
+
 body {
     padding-top: 100px; /* make room at top of page for the navbar */
     background: #aaa;
 {% autoescape %}
  
  
-<div class="alert alert-success" role="alert">
+<div class="alert alert-success border-success" role="alert">
     <h3>
       {{ question['title'] }}
     </h3>
 {% autoescape %}
  
  
-<div class="alert alert-warning" role="alert">
+<div class="alert alert-warning border-warning" role="alert">
     <h3>
       {{ question['title'] }}
     </h3>
@@ -18,7 +18,7 @@
  
     <p class="text-right">
       <small>
-        (Cotação: {{ question['points'] }} pontos não normalizados)
+        (Cotação: {{ round(question['points'], 2) }} pontos)
       </small>
     </p>
  
@@ -25,38 +25,39 @@
     {% if t['show_points'] %}
       <p class="text-right">
         <small>
-          (Cotação: {{ q['points'] }} pontos não normalizados)
+          (Cotação: {{ q['points'] }})
         </small>
       </p>
     {% end %}
+  </div> <!-- card-body -->
+
+  {% if t['state'] == 'FINISHED' %}
+    <div class="card-footer">
+      {% if q['grade'] > 0.99 %}
+        <p class="text-success">
+          <i class="fa fa-thumbs-o-up" aria-hidden="true"></i>
+          {{ round(q['grade'] * q['points'], 2) }}
+          pontos<br>
+          {{ q['comments'] }}
+        </p>
+      {% elif q['grade'] > 0.49 %}
+        <p class="text-warning">
+          <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+          {{ round(q['grade'] * q['points'], 2) }} 
+          pontos<br>
+          {{ q['comments'] }}
+        </p>
+      {% else %}
+        <p class="text-danger">
+          <i class="fa fa-thumbs-o-down" aria-hidden="true"></i>
+          {{ round(q['grade'] * q['points'], 2) }} 
+          pontos<br>
+          {{ q['comments'] }}
+        </p>
+      {% end %}
+    </div> <!-- card-footer -->
+  {% end %}
  
-    {% if t['state'] == 'FINISHED' %}
-      <div class="card-footer">
-        {% if q['grade'] > 0.99 %}
-          <p class="text-success">
-            <i class="fa fa-thumbs-o-up" aria-hidden="true"></i>
-            {{ round(q['grade'] * q['points'] / total_points * 20.0, 2)}}
-            pontos<br>
-            {{ q['comments'] }}
-          </p>
-        {% elif q['grade'] > 0.49 %}
-          <p class="text-warning">
-            <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
-            {{ round(q['grade'] * q['points'] / total_points * 20.0, 2) }} 
-            pontos<br>
-            {{ q['comments'] }}
-          </p>
-        {% else %}
-          <p class="text-danger">
-            <i class="fa fa-thumbs-o-down" aria-hidden="true"></i>
-            {{ round(q['grade'] * q['points'] / total_points * 20.0, 2) }} 
-            pontos<br>
-            {{ q['comments'] }}
-          </p>
-        {% end %}
-      </div>
-    {% end %}
-  </div>
  
 </div>
 {% end %}
 \ No newline at end of file
@@ -28,9 +28,9 @@
 <!-- ===================================================================== -->
 <body>
  
-<nav class="navbar navbar-expand-lg fixed-top navbar-dark bg-dark">
+<nav class="navbar navbar-expand-sm fixed-top navbar-dark bg-dark">
   <a class="navbar-brand" href="#">
-    <i class="fa fa-clock-o" aria-hidden="true"></i>
+    <!-- <i class="fa fa-clock-o" aria-hidden="true"></i> -->
     <span id="clock"> --:-- </span>
   </a>
   <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarText" aria-controls="navbarText" aria-expanded="false" aria-label="Toggle navigation">
@@ -129,9 +129,12 @@ class TestFactory(dict):
         self.setdefault('title', '')
         self.setdefault('show_hints', False)
         self.setdefault('show_points', False)
+        self.setdefault('scale_points', True)
+        self.setdefault('scale_max', 20.0)
+        self.setdefault('duration', 0)  # FIXME unused
+
         self.setdefault('debug', False)
         self.setdefault('show_ref', False)
-        self.setdefault('duration', 0)  # FIXME unused
  
  
     # -----------------------------------------------------------------------
@@ -140,6 +143,8 @@ class TestFactory(dict):
     # -----------------------------------------------------------------------
     def generate(self, student):
         test = []
+        total_points = 0.0
+
         for qq in self['questions']:
             # generate Question() selected randomly from list of references
             qref = random.choice(qq['ref'])
@@ -151,19 +156,26 @@ class TestFactory(dict):
                 continue
  
             # some defaults
-            if q['type'] in ('information', 'warning', 'alert'):
+            if q['type'] in ('information', 'success', 'warning', 'alert'):
                 q['points'] = qq.get('points', 0.0)
             else:
                 q['points'] = qq.get('points', 1.0)
  
+            total_points += q['points']
             test.append(q)
  
+        # normalize question points to scale
+        if self['scale_points']:
+            for q in test:
+                q['points'] *= self['scale_max'] / total_points
+
         return Test({
             'ref': self['ref'],
             'title': self['title'],         # title of the test
             'student': student,             # student id
             'questions': test,              # list of questions
             'answers_dir': self['answers_dir'],
+            # 'total_points': total_points,
  
             # FIXME which ones are required?
             'show_hints': self['show_hints'],
@@ -218,17 +230,8 @@ class Test(dict):
         self['finish_time'] = datetime.now()
         self['state'] = 'FINISHED'
  
-        grade = 0.0
-        total_points = 0.0
-        for q in self['questions']:
-            grade += q.correct() * q['points']
-            total_points += q['points']
-
-        if total_points > 0.0:
-            self['grade'] = round(20.0 * max(grade / total_points, 0.0), 1)
-        else:
-            logger.error(f'Student {self["student"]["number"]}:  division by zero during correction. Total points must be positive.')
-            self['grade'] = 0.0
+        grade = sum(q.correct()*q['points'] for q in self['questions'])
+        self['grade'] = round(grade, 1)
  
         logger.info(f'Student {self["student"]["number"]}:  correction gave {self["grade"]} points.')
         return self['grade']
1	1
2	2	# BUGS
3	3
4		-- testar perguntas warning/warn
5		-- text-numeric não está a gerar a pergunta. faltam templates?
	4	+- numeracao das perguntas do teste esta a contar com paineis informativos...
	5	+- servir imagens das perguntas
	6	+- review de um teste nao funciona (hardcoded...)
	7	+- testar opcao --allow-all
	8	+- como alterar configuracao para mostrar logs de debug?
	9	+- hints nao funciona
6	10	- uniformizar question.py com a de aprendizations...
7	11	- Review de um teste que foi apagado rebenta.
8	12	- permitir eliminar teste a decorrer de modo a que o aluno possa recomeçar (e.g. noutro browser)
...	...	@@ -11,13 +15,10 @@
11	15	# TODO
12	16
13	17	- Gerar pdf's com todos os testes no final (pdfkit).
14		-- testar SSL
15	18	- manter registo dos unfocus durante o teste e de qual a pergunta visivel nesse momento
16	19
17	20	- permitir varios testes, aluno escolhe qual o teste que quer fazer.
18		-- usar thread.Lock para aceder a variaveis de estado?
19	21	- se ocorrer um erro na correcçao avisar aluno para contactar o professor.
20		-- implementar practice mode?
21	22	- abrir o teste numa janela maximizada e que nao permite que o aluno a redimensione/mova?
22	23	- detectar scroll e enviar posição para servidor (analise de scroll para detectar copianço? ou simplesmente para analisar como os alunos percorrem o teste)
23	24	- single page web no teste/correcçao. Página construída em javascript, obter perguntas com ajax (para practice?).
...	...	@@ -30,6 +31,9 @@
30	31
31	32	# FIXED
32	33
	34	+- testar SSL
	35	+- text-numeric não está a gerar a pergunta. faltam templates?
	36	+- testar perguntas warning/warn
33	37	- qd user 0 faz logout rebenta.
34	38	- Quando grava JSON do teste deve usar 'path' tal como definido na configuração e não expandido. Isto porque em OSX /home é /Users e quando se muda de um sistema para outro não encontra os testes. Assim, usando ~ na configuração deveria funcionar sempre.
35	39	- configuração do teste não joga bem com o do aprendizations. Em particular os scripts não ficam com o mesmo path!!!
...	...
...	...	@@ -0,0 +1,92 @@
	1	+-
	2	+ ref: tut-information
	3	+ type: information
	4	+ title: information (ou info)
	5	+ text: Texto informativo. Não conta para avaliação.
	6	+# ---------------------------------------------------------------------------
	7	+-
	8	+ ref: tut-success
	9	+ type: success
	10	+ title: success
	11	+ text: Texto de positivo (sucesso). Não conta para avaliação.
	12	+# ---------------------------------------------------------------------------
	13	+-
	14	+ ref: tut-warning
	15	+ type: warning
	16	+ title: warning (ou warn)
	17	+ text: Texto de aviso. Não conta para avaliação.
	18	+# ----------------------------------------------------------------------------
	19	+-
	20	+ ref: tut-alert
	21	+ type: alert
	22	+ title: alert
	23	+ text: Texto negativo (alerta). Não conta para avaliação.
	24	+# ----------------------------------------------------------------------------
	25	+-
	26	+ ref: tut-radio
	27	+ type: radio
	28	+ title: radio
	29	+ text: Escolha simples, apenas uma opção está correcta.
	30	+ options:
	31	+ - Opção 0 (correcta)
	32	+ - Opção 1
	33	+ - Opção 2
	34	+ - Opção 3
	35	+ # opcionais e valores por defeito
	36	+ shuffle: True
	37	+ correct: 0
	38	+# ----------------------------------------------------------------------------
	39	+-
	40	+ ref: tut-checkbox
	41	+ type: checkbox
	42	+ title: checkbox
	43	+ text: Escolha simples, apenas uma opção está correcta.
	44	+ options:
	45	+ - Opção 0 (sim)
	46	+ - Opção 1 (não)
	47	+ - Opção 2 (não)
	48	+ - Opção 3 (sim)
	49	+ correct: [1,-1,-1,1]
	50	+ # opcionais e valores por defeito
	51	+ shuffle: True
	52	+# ----------------------------------------------------------------------------
	53	+-
	54	+ ref: tut-text
	55	+ type: text
	56	+ title: text
	57	+ text: \|
	58	+ Resposta numa linha de texto. A resposta está correcta se coincidir com alguma das respostas admissíveis.
	59	+ Neste exemplo a resposta correcta é `azul`, `Azul` ou `AZUL`.
	60	+ correct: ['azul', 'Azul', 'AZUL']
	61	+# ---------------------------------------------------------------------------
	62	+-
	63	+ ref: tut-text-regex
	64	+ type: text-regex
	65	+ title: text-regex
	66	+ text: \|
	67	+ Resposta numa linha de texto. A resposta é validada com uma expressão regular.
	68	+ Neste exemplo a expressão regular é `(VERDE\|[Vv]erde)`.
	69	+ correct: !regex '(VERDE\|[Vv]erde)'
	70	+# ---------------------------------------------------------------------------
	71	+-
	72	+ ref: tut-numeric-interval
	73	+ type: numeric-interval
	74	+ title: numeric-interval
	75	+ text: \|
	76	+ Resposta numérica numa linha de texto. A resposta é convertida para um float e tem de pertencer a um intervalo de valores.
	77	+ Neste exemplo o intervalo é [3.14, 3.15].
	78	+ correct: [3.14, 3.15]
	79	+# ---------------------------------------------------------------------------
	80	+-
	81	+ ref: tut-textarea
	82	+ type: textarea
	83	+ title: textarea
	84	+ text: \|
	85	+ Resposta num bloco de texto que pode ser usado para introduzir código.
	86	+ A resposta é avaliada por um programa externo.
	87	+ O programa externo, recebe a resposta no stdin e devolve a classificação no stdout.
	88	+ Neste exemplo, o programa de avaliação verifica se a resposta contém as três palavras red, green e blue.
	89	+ correct: correct/correct-question.py
	90	+ # opcionais e defaults
	91	+ lines: 3
	92	+ timeout: 5
...	...
...	...	@@ -0,0 +1,56 @@
	1	+#=============================================================================
	2	+# The test reference should be a unique identifier. It is saved in the database
	3	+# so that queries for the results can be done in the terminal with
	4	+# $ sqlite3 students.db "select * from tests where ref='demo'"
	5	+ref: tutorial
	6	+
	7	+# (optional, default: '') You may wish to refer the course, year or kind of test
	8	+title: Teste tutorial
	9	+
	10	+# (optional) duration in minutes FIXME
	11	+duration: 90
	12	+
	13	+# Database with student credentials and grades of all questions and tests done
	14	+# The database is an sqlite3 file generate with the script initdb.py
	15	+database: demo/students.db
	16	+
	17	+# Generate a file for each test done by a student.
	18	+# It includes the questions, answers and grades.
	19	+answers_dir: demo/ans
	20	+
	21	+# (optional, default: False) Show points for each question, scale 0-20.
	22	+show_points: True
	23	+
	24	+# (optional, default: False) Show hints if available
	25	+show_hints: True
	26	+
	27	+# (optional, default: False) Show lots of information for debugging
	28	+# debug: True
	29	+
	30	+#-----------------------------------------------------------------------------
	31	+# Base path applied to the questions files and all the scripts
	32	+# including question generators and correctors.
	33	+# Either absolute path or relative to current directory can be used.
	34	+questions_dir: demo/questions
	35	+
	36	+# (optional) List of files containing questions in yaml format.
	37	+# Selected questions will be obtained from these files.
	38	+# If undefined, all yaml files in questions_dir are loaded (not recommended).
	39	+files:
	40	+ - questions-tutorial.yaml
	41	+
	42	+# This is the list of questions that will make up the test.
	43	+# The order is preserved.
	44	+# There are several ways to define each question (explained below).
	45	+questions:
	46	+ - tut-information
	47	+ - tut-success
	48	+ - tut-warning
	49	+ - tut-alert
	50	+
	51	+ - tut-radio
	52	+ - tut-checkbox
	53	+ - tut-text
	54	+ - tut-text-regex
	55	+ - tut-numeric-interval
	56	+ - tut-textarea
...	...
...	...	@@ -275,7 +275,7 @@ class QuestionTextRegex(Question):
275	275
276	276
277	277	# ===========================================================================
278		-class QuestionTextNumeric(Question):
	278	+class QuestionNumericInterval(Question):
279	279	'''An instance of QuestionTextNumeric will always have the keys:
280	280	type (str)
281	281	text (str)
...	...	@@ -302,6 +302,7 @@ class QuestionTextNumeric(Question):
302	302	try:
303	303	answer = float(self['answer'])
304	304
	305	+ # TODO:
305	306	# alternative using locale (1.2 vs 1,2)
306	307	# import locale
307	308	# locale.setlocale(locale.LC_ALL, 'pt_PT')
...	...	@@ -401,8 +402,8 @@ class QuestionFactory(dict):
401	402	'radio' : QuestionRadio,
402	403	'checkbox' : QuestionCheckbox,
403	404	'text' : QuestionText,
404		- 'text_regex': QuestionTextRegex, 'text-regex': QuestionTextRegex,
405		- 'text_numeric': QuestionTextNumeric, 'text-numeric': QuestionTextNumeric,
	405	+ 'text-regex': QuestionTextRegex,
	406	+ 'numeric-interval': QuestionNumericInterval,
406	407	'textarea' : QuestionTextArea,
407	408	# -- informative panels --
408	409	'information': QuestionInformation, 'info': QuestionInformation,
...	...	@@ -420,22 +421,17 @@ class QuestionFactory(dict):
420	421	# Add single question provided in a dictionary.
421	422	# After this, each question will have at least 'ref' and 'type' keys.
422	423	# -----------------------------------------------------------------------
423		- def add(self, question):
424		- # if ref missing try ref='/path/file.yaml:3'
425		- try:
426		- question.setdefault('ref', question['filename'] + ':' + str(question['index']))
427		- except KeyError:
428		- logger.error('Missing "ref". Cannot add question to the pool.')
429		- return
	424	+ def add_question(self, question):
	425	+ # if missing defaults to ref='/path/file.yaml:3'
	426	+ question.setdefault('ref', f'{question["filename"]}:{question["index"]}')
430	427
431		- # check duplicate references
432	428	if question['ref'] in self:
433		- logger.error(f'Duplicate reference "{question["ref"]}". Replacing the original one!')
	429	+ logger.error(f'Duplicate reference "{question["ref"]}" replaces the original.')
434	430
435	431	question.setdefault('type', 'information')
436	432
437	433	self[question['ref']] = question
438		- logger.debug('Added question "{0}" to the pool.'.format(question['ref']))
	434	+ logger.debug(f'Added question "{question["ref"]}" to the pool.')
439	435
440	436	# -----------------------------------------------------------------------
441	437	# load single YAML questions file
...	...	@@ -453,20 +449,19 @@ class QuestionFactory(dict):
453	449
454	450	questions = load_yaml(fullpath, default=[])
455	451
456		- n = 0
457	452	for i, q in enumerate(questions):
458		- if isinstance(q, dict):
	453	+ try:
459	454	q.update({
460	455	'filename': filename,
461	456	'path': dirname,
462		- 'index': i # position in the file, 0 based
	457	+ 'index': i # position in the file, 0 based
463	458	})
464		- self.add(q) # add question
465		- n += 1 # counter
466		- else:
467		- logger.error(f'Question index {i} from file {pathfile} is not a dictionary. Skipped!')
	459	+ except AttributeError:
	460	+ logger.error(f'Question {pathfile}:{i} is not a dictionary. Skipped!')
	461	+ else:
	462	+ self.add_question(q)
468	463
469		- logger.info(f'Loaded {n} questions from "{pathfile}".')
	464	+ logger.info(f'Loaded {len(self)} questions from "{pathfile}".')
470	465
471	466	# -----------------------------------------------------------------------
472	467	# load multiple YAML question files
...	...
1		-#!/usr/bin/env python3
	1	+#!/usr/bin/env python3.6
2	2
3	3	# base
4	4	from os import path
...	...	@@ -26,7 +26,7 @@ class WebApplication(tornado.web.Application):
26	26	(r'/login', LoginHandler),
27	27	(r'/logout', LogoutHandler),
28	28	(r'/test', TestHandler),
29		- (r'/review', ReviewHandler), # FIXME
	29	+ (r'/review', ReviewHandler),
30	30	(r'/admin', AdminHandler),
31	31	# (r'/change_password', ChangePasswordHandler),
32	32	(r'/static/(.+)', FileHandler), # FIXME
...	...	@@ -76,7 +76,7 @@ class LoginHandler(BaseHandler):
76	76	self.set_secure_cookie("user", str(uid), expires_days=30)
77	77	self.redirect(self.get_argument("next", "/"))
78	78	else:
79		- self.render("login.html", error='Número ou senha incorrectos')
	79	+ self.render("login.html", error='Não autorizado ou número/senha inválido')
80	80
81	81	# -------------------------------------------------------------------------
82	82	class LogoutHandler(BaseHandler):
...	...	@@ -110,10 +110,8 @@ class TestHandler(BaseHandler):
110	110	'radio': 'question-radio.html',
111	111	'checkbox': 'question-checkbox.html',
112	112	'text': 'question-text.html',
113		- # 'text_regex': 'question-text.html',
114	113	'text-regex': 'question-text.html',
115		- # 'text_numeric': 'question-text.html',
116		- 'text-numeric': 'question-text.html',
	114	+ 'numeric-interval': 'question-text.html',
117	115	'textarea': 'question-textarea.html',
118	116	# -- information panels --
119	117	'information': 'question-information.html',
...	...	@@ -153,7 +151,7 @@ class TestHandler(BaseHandler):
153	151	ans[i] = None
154	152	else:
155	153	ans[i] = ans[i][0]
156		- elif q['type'] in ('textarea', 'text', 'text-numeric', 'text-regex'):
	154	+ elif q['type'] in ('text', 'text-regex', 'textarea', 'numeric-interval'):
157	155	ans[i] = ans[i][0]
158	156
159	157	self.testapp.correct_test(uid, ans)
...	...	@@ -170,10 +168,12 @@ class ReviewHandler(BaseHandler):
170	168	'checkbox': 'review-question-checkbox.html',
171	169	'text': 'review-question-text.html',
172	170	'text-regex': 'review-question-text.html',
173		- 'text-numeric': 'review-question-text.html',
	171	+ 'numeric-interval': 'review-question-text.html',
174	172	'textarea': 'review-question-text.html',
175	173	# -- information panels --
	174	+ 'information': 'question-information.html',
176	175	'info': 'question-information.html',
	176	+ 'warning': 'question-warning.html',
177	177	'warn': 'question-warning.html',
178	178	'alert': 'question-alert.html',
179	179	'success': 'question-success.html',
...	...	@@ -322,6 +322,7 @@ def main():
322	322	logging.critical('Failed to start application.')
323	323	sys.exit(1)
324	324
	325	+ # --- start web application
325	326	try:
326	327	webapp = WebApplication(app, debug=arg.debug)
327	328	except Exception as e:
...	...
1	1	/* Fixes navigation panel overlaying content */
	2	+html {
	3	+ font-size: 14px;
	4	+}
	5	+
2	6	body {
3	7	padding-top: 100px; /* make room at top of page for the navbar */
4	8	background: #aaa;
...	...
1	1	{% autoescape %}
2	2
3	3
4		-<div class="alert alert-success" role="alert">
	4	+<div class="alert alert-success border-success" role="alert">
5	5	<h3>
6	6	{{ question['title'] }}
7	7	</h3>
...	...
1	1	{% autoescape %}
2	2
3	3
4		-<div class="alert alert-warning" role="alert">
	4	+<div class="alert alert-warning border-warning" role="alert">
5	5	<h3>
6	6	{{ question['title'] }}
7	7	</h3>
...	...
...	...	@@ -18,7 +18,7 @@
18	18
19	19	<p class="text-right">
20	20	<small>
21		- (Cotação: {{ question['points'] }} pontos não normalizados)
	21	+ (Cotação: {{ round(question['points'], 2) }} pontos)
22	22	</small>
23	23	</p>
24	24
...	...
...	...	@@ -25,38 +25,39 @@
25	25	{% if t['show_points'] %}
26	26	<p class="text-right">
27	27	<small>
28		- (Cotação: {{ q['points'] }} pontos não normalizados)
	28	+ (Cotação: {{ q['points'] }})
29	29	</small>
30	30	</p>
31	31	{% end %}
	32	+ </div> <!-- card-body -->
	33	+
	34	+ {% if t['state'] == 'FINISHED' %}
	35	+ <div class="card-footer">
	36	+ {% if q['grade'] > 0.99 %}
	37	+ <p class="text-success">
	38	+ <i class="fa fa-thumbs-o-up" aria-hidden="true"></i>
	39	+ {{ round(q['grade'] * q['points'], 2) }}
	40	+ pontos<br>
	41	+ {{ q['comments'] }}
	42	+ </p>
	43	+ {% elif q['grade'] > 0.49 %}
	44	+ <p class="text-warning">
	45	+ <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
	46	+ {{ round(q['grade'] * q['points'], 2) }}
	47	+ pontos<br>
	48	+ {{ q['comments'] }}
	49	+ </p>
	50	+ {% else %}
	51	+ <p class="text-danger">
	52	+ <i class="fa fa-thumbs-o-down" aria-hidden="true"></i>
	53	+ {{ round(q['grade'] * q['points'], 2) }}
	54	+ pontos<br>
	55	+ {{ q['comments'] }}
	56	+ </p>
	57	+ {% end %}
	58	+ </div> <!-- card-footer -->
	59	+ {% end %}
32	60
33		- {% if t['state'] == 'FINISHED' %}
34		- <div class="card-footer">
35		- {% if q['grade'] > 0.99 %}
36		- <p class="text-success">
37		- <i class="fa fa-thumbs-o-up" aria-hidden="true"></i>
38		- {{ round(q['grade'] * q['points'] / total_points * 20.0, 2)}}
39		- pontos<br>
40		- {{ q['comments'] }}
41		- </p>
42		- {% elif q['grade'] > 0.49 %}
43		- <p class="text-warning">
44		- <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
45		- {{ round(q['grade'] * q['points'] / total_points * 20.0, 2) }}
46		- pontos<br>
47		- {{ q['comments'] }}
48		- </p>
49		- {% else %}
50		- <p class="text-danger">
51		- <i class="fa fa-thumbs-o-down" aria-hidden="true"></i>
52		- {{ round(q['grade'] * q['points'] / total_points * 20.0, 2) }}
53		- pontos<br>
54		- {{ q['comments'] }}
55		- </p>
56		- {% end %}
57		- </div>
58		- {% end %}
59		- </div>
60	61
61	62	</div>
62	63	{% end %}
63	64	\ No newline at end of file
...	...