generate-question.py
2.54 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
#!/usr/bin/env python3
'''
Example of a parameterized question generator.
Parameters are read from stdin.
The generated question is written to stdout in JSON format.
'''
import json
import random
import sys
# read two arguments from the field `args` specified in the question yaml file
a, b = (int(n) for n in sys.argv[1:])
x = random.randint(a, b)
y = random.randint(a, b)
r = x + y
# ----------------------------------------------------------------------------
text = '''
As perguntas podem ser estáticas (como as que vimos até aqui), ou serem
geradas dinâmicamente por um programa externo. Para gerar uma pergunta, o
programa deve escrever texto no `stdout` em formato `yaml` tal como os
exemplos das perguntas estáticas dos tipos apresentados anteriormente. Pode
também receber argumentos de linha de comando para parametrizar a pergunta.
Aqui está um exemplo de uma pergunta gerada por um script python:
```python
#!/usr/bin/env python3
import json
import random
import sys
a, b = (int(n) for n in sys.argv[1:]) # argumentos da linha de comando
x = random.randint(a, b) # número inteiro no intervalo a..b
y = random.randint(a, b) # número inteiro no intervalo a..b
r = x + y # calcula o resultado correcto
question = {
'type': 'text',
'title': 'Geradores de perguntas',
'text': f'Quanto é {x} + {y}?',
'transform': ['trim'],
'correct': f'{r}',
'solution': f'A resposta correcta é {r}.'
}
json.dump(question, sys.stdout)
```
Este script deve ter permissões para poder ser executado.
Podemos testar o programa no terminal `./gen-somar.py 1 100` e verificar que
o output é uma pergunta válida no formato JSON. Agora é necessário indicar
que este script deve ser usado para gerar uma pergunta.
Uma pergunta gerada por um programa externo é declarada com
```yaml
- type: generator
ref: gen-somar
script: gen-somar.py
# argumentos opcionais
args: [1, 100]
```
O script vai receber a lista de argumentos declarados em `args`.
A pergunta vai ser modificada, sendo acrescentados os campos gerados pelo
script. O tipo da pergunta vai também ser preenchido pelo tipo correcto.
Apenas a referência mantém-se.
---
'''
# ----------------------------------------------------------------------------
question = {
'type': 'text',
'title': 'Geradores de perguntas',
'text': text + f'Quanto é {x} + {y}?',
'transform': ['trim'],
'correct': f'{r}',
'solution': f'A resposta correcta é {r}.'
}
json.dump(question, sys.stdout)