qbank — generador de bancos de preguntas de opción múltiple

Conviene instalar dentro de un entorno virtual (en Debian, Ubuntu o con el Python de Homebrew, pip fuera de uno da externally-managed-environment):

python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install calcprop-qbank       # instala también calcprop

El Manual (sección «Instalación paso a paso») lo explica despacio, también para Windows.

Con soporte para el editor visual en Jupyter:

pip install "calcprop-qbank[jupyter]"

qbank-init y lint llegan con la 0.6.0: si pip te deja una versión anterior (python -c "import qbank; print(qbank.__version__)" falla o da menos de 0.6), actualiza con pip install -U calcprop-qbank. La versión en desarrollo se instala desde el repositorio:

pip install "calcprop-qbank[jupyter] @ git+https://github.com/mbujosab/calcprop-qbank"

Esa orden necesita git instalado. El paquete solo instala el código. El tutorial (Tutorial.ipynb), la guía de diseño (GuiaDiseno.org y su versión impresa GuiaDiseno.pdf), el manual (Manual.org, Manual.pdf) y los ejemplos de ejemplosManual/ están en el repositorio: clónalo con git clone https://github.com/mbujosab/calcprop-qbank o abre el tutorial sin instalar nada con la insignia de MyBinder de arriba. La guía y el manual se leen también en la web, mbujosab.github.io/calcprop-qbank.

La forma recomendada de empezar es la plantilla de proyecto que se distribuye con el paquete (qbank-init necesita la versión 0.6 o posterior):

qbank-init mi-banco
cd mi-banco
make lint          # comprueba las preguntas de ejemplo (sin LaTeX)
make amc           # PDF de revisión (vista profe) en build/amc/

El proyecto contiene cinco preguntas de ejemplo en preguntas/, los scripts que las exportan a AMC y Moodle, un Makefile (lint, tabla, amc, amc-student, moodle, lectura, clean, filtro LECCION=N), nueva_pregunta.py, un guion para escribir una pregunta en Python y guardarla como JSON, y en prompts/ las instrucciones para escribir preguntas con ayuda de una IA. Su README.org explica el flujo.

make usa el intérprete python3 del sistema. Si instalaste qbank en un entorno virtual, actívalo antes (source .venv/bin/activate) o indícalo con PYTHON: make lint PYTHON=/ruta/al/.venv/bin/python. Si ese intérprete no tiene qbank 0.6 o posterior, make se para y lo dice.

from qbank import *

p = ProblemaTipo(
    [
        "Sea $f$ una función ",
        [   # mundos alternativos: en cada variante se sortea uno
            Supuesto("estrictamente creciente", v('crec')),
            Supuesto("estrictamente decreciente", v('decr')),
        ],
        " y sean $a < b$. Entonces:",
        [   # hueco 1: el alumno ve una de estas dos
            Cuestion("$f(a) < f(b)$", v('crec')),
            Cuestion("$f(a) > f(b)$", v('decr')),
        ],
        Cuestion("$f(a) = f(b)$", False),              # hueco 2: siempre
        [   # hueco 3
            Cuestion("$f(b) - f(a) > 0$", v('crec')),
            Cuestion("$f(b) - f(a) < 0$", v('decr')),
        ],
    ],
    export={"last_choice": True},   # + «Ninguna de las anteriores»
)

for etiqueta, partes in p.por_partes():
    for enunciado, cuestiones in partes:
        print(f"Variante {etiqueta}: {enunciado}")
        for texto, correcto, activa, exp in cuestiones:
            print(f"  {'✓' if correcto else '✗'} {texto}")

Ocho variantes (pocas para un banco real: lint lo avisa), cada una con tres opciones más la opción por defecto («Ninguna de las anteriores», correcta solo si las otras tres son falsas). Una lista de Cuestion sortea una por variante; el alumno ve tantas opciones como elementos-Cuestion consecutivos haya (GuiaDiseno.org lo explica).

Todo se puede leer sin clonar el repositorio en mbujosab.github.io/calcprop-qbank (HTML y PDF). En este orden:

• Tres cuadernos Jupyter, que se abren en MyBinder sin instalar nada:
  • Tutorial.ipynb (MyBinder) — cinco ejemplos progresivos ejecutables: verdadero/falso literales, mundos, precond, interpolación @{var} y semántica lambda.
  • Demo.ipynb (MyBinder) — los mismos ejemplos, recorriendo la API Python y el editor visual.
  • Ejemplos.ipynb (MyBinder) — el flujo completo en Python con un ejemplo de econometría: construir la pregunta, revisarla, guardarla en JSON y exportarla a Moodle y AMC.
• GuiaDiseno.org (impresa en GuiaDiseno.pdf) — cómo diseñar buenas preguntas: la mecánica de listas y mundos, el patrón de tres huecos + opción por defecto, setup, redacción de cuestiones y explicaciones, trampas de LaTeX/Moodle y checklist.
• Manual.org (Manual.pdf) — referencia completa de la API y del formato JSON.
• Prompt genérico para una IA — si escribes las preguntas con un asistente: qbank-init deja en prompts/ este prompt (qué leer, proceso y reglas) y otro con huecos para las decisiones de tu banco, más un CLAUDE.md de entrada.
• CalcPropQuiz.org y CalcPropExport.org — código fuente comentado (programación literate) de los módulos _quiz, _json, _widgets, _lint, _export y _plantilla. Son la fuente de src/qbank/: los .py se generan con org-babel-tangle o, sin Emacs, con python tools/orgtangle.py write; tests/test_literate.py comprueba que coinciden.

Copyright (C) 2020-2026 Andrés Bujosa, Marcos Bujosa (_quiz)
Copyright (C) 2020-2026 Marcos Bujosa (_export, _json, _widgets)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

See the LICENSE file for details.