quiz-builder

quiz-builder — GLOBAL quiz-building methodology

Build or update a Canvas Classic quiz: its question items + the description summary. Idempotent — create a quiz's questions from nothing OR modify an existing quiz (questions matched by question_name). Pairs with the machinery quiz_builder.py (same dir) the way assignment-page-builder pairs with assignment_page_builder.py.

⛔ HARD RULE — the machinery is the ONLY path (gate, don't hand-roll)

• ALL Canvas quiz API calls go through skills/quiz-builder/quiz_builder.py (co-located). NEVER write ad-hoc canvas_rest.get/post/put to /quizzes/... in a session — that is the recurring hand-roll bug (grade_nb_skill / Stage-B finalize). If a needed call is missing, ADD it to quiz_builder.py, never improvise. The entry is quiz_builder.make_quiz(base, token, course_id, quiz_id, questions, ...).
• NEVER publishes. No published set — the instructor publishes.
• Full payload always (question_type / points_possible / question_text / answers) — a missing field silently fails. make_quiz refreshes the STALE question_count/points_possible cache after changes, and reorders (the question endpoint ignores position). All per Access/Canvas.md.

Two parts

1. Question items — built by TYPE (dispatch below), then upsert_questions (create-or-update by name).
2. Description summary — build_description_summary renders a student-facing table: Questions · Total points · Time limit · Attempts · Due (computed from the questions, since the quiz's own fields are stale until refresh). Add a short intro via intro_html.

Question dispatch — by type