Skip to main content

Jupyter notebook assignment formatting and distribution

Project description

jassign: Jupyter Notebook Assignments

Format and tools for authoring and distributing Jupyter notebook assignments

Getting started

Course instructors author assignments as Jupyter notebooks by creating a notebook that contains setup code, questions, solutions, and tests to validate those solutions. This project prepares an assignment to be distributed to students and later scored automatically.

The notebook format is not specific to a programming language or autograding framework, but was designed to be used with okpy, which is Python based. Contributions to support other testing frameworks, such as [nbgrader, and other programming languages are welcome.

An example notebook appears in tests/example.ipynb, which uses the notebook format. To convert it, run:

jassign tests/example.ipynb tests/output some/course

This command will create tests/output with a student version and an autograder version as subdirectories.

You can then generate a PDF from the result:

jassign-pdf tests/output/autograder/example.ipynb tests/output/autograder/example.pdf

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jassign-0.0.7.tar.gz (9.7 kB view hashes)

Uploaded Source

Built Distribution

jassign-0.0.7-py3-none-any.whl (13.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page