generate-question.py
2.1 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
#!/usr/bin/env python3
'''
Example of a question generator.
Arguments are read from stdin.
'''
from random import randint
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 = randint(a, b)
y = randint(a, b)
r = x + y
print(f"""---
type: text
title: Geradores de perguntas
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
from random import randint
import sys
a, b = (int(n) for n in sys.argv[1:]) # argumentos da linha de comando
x = randint(a, b) # número inteiro no intervalo a..b
y = randint(a, b) # número inteiro no intervalo a..b
r = x + y # calcula resultado correcto
print(f'''---
type: text
title: Contas de somar
text: |
Calcule o resultado de ${{x}} + {{y}}$.
correct: '{{r}}'
solution: |
A solução é {{r}}.''')
```
Este script deve ter permissões para poder ser executado no terminal.
Podemos testar o programa no terminal `./gen-somar.py 1 100` e verificar que
o output é uma pergunta válida em formato `yaml`. 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 programa pode receber uma lista de argumentos de linha de comando
declarados em `args`.
---
Calcule o resultado de ${x} + {y}$.
Os números foram gerados aleatoriamente no intervalo de {a} a {b}.
correct: '{r}'
solution: |
A solução é {r}.""")