question-bank-quiz

question-bank-quiz — a text bank → Canvas quiz

An adapter in front of quiz-builder, not a second quiz engine. It converts an unstructured publisher bank into the JSON quiz_builder.build_quiz_from_file already consumes. Every Canvas call still happens in quiz_builder.py — there is one quiz machine.

bank.txt ──▶ bank_parse.py ──▶ Ch<N>_quiz.json ──▶ quiz_builder ──▶ Canvas quiz
                   │                                                  (unpublished)
                   └──▶ Ch<N>_quiz.html  ← REVIEW THIS FIRST

What this is NOT: hand-authoring questions from a doc or slide (that is quiz-builder directly, or a course's customize-quiz), and not a git-program question (that is git-asmt → quiz-builder). Nothing here knows about git.

Input — the bank format

Chapter 7 Single-Dimensional Arrays        title line
Section 7.5 Copying Arrays                 section marker, skipped ("Sections" too)
12.<TAB>stem text
                                           blank line separates stem from code
int[] list = {1, 2, 3};                    code block
a.<TAB>choice
...
Key:cde  optional rationale                answer letters, then the author's prose
#                                          block separator

Three parsing rules exist because breaking any of them loses questions silently:

1. key: is matched case-insensitively. In the Liang chapter-7 bank, 5 of 53 items use lowercase key:. A case-sensitive parser drops exactly those five and the count still looks plausible.
2. Only the run of [a-e] right after key: is the answer. The rest is the author's rationale (Key:abcd e is incorrect because…) and never reaches the student.
3. Escaping is entity-aware. The bank already contains <; a plain escape would show students <.

One answer letter → mc. Two or more → ma (multiple_answers_question).

The input shape IS the contract

The parser reads exactly one shape:

12.<TAB>stem text
a.<TAB>choice
b.<TAB>choice
Key:b