Skip to main content

Versions

PyPI

Documentation and Support

Documentation Status Supported Python Versions

Open Source

License OpenSSF Scorecard

Coding Standards

Ruff pre-commit.ci status

Development Status

Project Status: Active – The project has reached a stable, usable state and is being actively developed. Build Status Coveralls

nbgrader-jupyterquiz lets instructors embed interactive, gradeable quizzes directly inside Jupyter notebooks using a simple Markdown syntax. During nbgrader generate_assignment the quiz source is transformed into interactive quiz cells (powered by a fork of jupyterquiz), and the answer key is stripped from the released notebook.

Quizzes placed in an nbgrader Manually Graded Task cell are automatically graded: student responses are persisted to a responses.json sidecar as they answer, and nbgrader autograde evaluates them with partial-credit support. Per-question points (including fractions like {0.5}) are supported, and the Markdown syntax handles MathJax, code blocks, and multi-line content. See the graded-quizzes docs for the full workflow.

Installation

pip install nbgrader-jupyterquiz

Quick start

Register the preprocessor at the front of your nbgrader_config.py:

c.GenerateAssignment.preprocessors.insert(0, "nbgrader_jupyterquiz.CreateQuiz")

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

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

Run nbgrader generate_assignment — quiz regions are replaced with interactive widgets and the answer key is stripped from the released notebook. Student responses are auto-graded by nbgrader autograde.

See the documentation for the full quiz syntax, nbgrader pipeline, graded quizzes, 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.

Metadata

Release files for nbgrader-jupyterquiz 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nbgrader-jupyterquiz 0.5.0
File Size Uploaded
nbgrader_jupyterquiz-0.5.0.tar.gz 136.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nbgrader-jupyterquiz 0.5.0
File Interpreter ABI Platform
nbgrader_jupyterquiz-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 189.8 kB

Release files / nbgrader_jupyterquiz-0.5.0.tar.gz

Download URL nbgrader_jupyterquiz-0.5.0.tar.gz
Size 136.3 kB
Tags Source
SHA-256 checksum
How to use checksums
1e85fdbe90d8ce680eea64955e581c73825fef765584cdce2620ee08e6bb5939
BLAKE2b-256 checksum
How to use checksums
8cb2759b8a6e7d808f39257093b80de1981c4f96d774850bbe0fe7f0a469a6c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 7, 2026.

Transparency log

Release files / nbgrader_jupyterquiz-0.5.0-py3-none-any.whl

Download URL nbgrader_jupyterquiz-0.5.0-py3-none-any.whl
Size 53.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d5e42c650fec3b05a7b74cc77def7ae4e9b95fabe6856cbf703c6dcb9d23501f
BLAKE2b-256 checksum
How to use checksums
f8306fc20bcd3c9d1f44f138ea36cc60b72ac3dd7ff8c69637f9cd614ed8bb98
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 7, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files

0.4.0

2 release files

0.3.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page