nbgrader-jupyterquiz 0.3.0

Interactive graded quizzes for Jupyter notebooks (nbgrader-jupyterquiz).

Versions
Documentation and Support
Open Source
Coding Standards
Development Status

nbgrader-jupyterquiz lets instructors embed interactive, gradeable quizzes directly inside Jupyter notebooks using a simple Markdown syntax. During nbgrader assign the quiz source is transformed into interactive quiz cells (powered by a fork of jupyterquiz); correct answers are hidden from students before the assignment is released.

• Free software: MIT license

• Documentation: https://nbgrader-jupyterquiz.readthedocs.io

Installation

pip install nbgrader-jupyterquiz

Quick start

Register the preprocessor in nbgrader_config.py:

c.GenerateAssignment.preprocessors = [
    "nbgrader_jupyterquiz.CreateQuiz",
]

Write quizzes in Manually Graded Task cells using #### Quiz / #### End Quiz delimiters:

#### Quiz
* (SC) "What is the capital of France?"
  + (Correct!) "Paris"
  - "London"
  - "Berlin"
#### End Quiz

Run nbgrader assign — quiz regions are replaced with interactive widgets and correct answers are hidden from students.

See the documentation for the full quiz syntax, nbgrader pipeline, and display options.

Credits

This package incorporates a fork of jupyterquiz (v2.9.6.4) by John M. Shea, copyright 2021–2025, used under the MIT License. See LICENSES/jupyterquiz-MIT.txt.

This package was scaffolded with Cookiecutter and the Ouranosinc/cookiecutter-pypackage project template.