cheesegrader 1.0.0

A collection of grading/quercus tools for University of Toronto instructors.

Cheesegrader 🧀

Cheesegrader is a CLI tool to streamline grading workflows for Quercus (Canvas).

Its main features are:

• sorting: Sorting rubrics/student assignments into folders based on their filenames. Useful to organize graders.
• copying: Generating a copy of a file for each student. Useful for rubrics.
• renaming: Replacing one id filenames with another id. Useful when (e.g.) you bulk download off quercus and find out the assignments don't have UTORID in the name.
• downloading: Downloading student lists, or assignment submissions.
• uploading: Uploading grades, files, or both to quercus for every student.

Following the prompts should be pretty straightforward, but you can press h at any time for help, and q or ctrl+c to quit.

This has been very useful for me, and I hope it's very useful to you!

Table of contents

• Getting Started
• Running the CLI
• Authentication and tokens
• Course and assignmend IDs
• Contact

Getting Started

• From PyPI (when published):
  • Windows (PowerShell): py -m pip install cheesegrader
  • Then run: cheesegrader
• From source (this repo):
  • git clone <repo-url>
  • cd cheesegrader
  • py -m pip install -U pip
  • Editable dev install: py -m pip install -e .
  • Then run: cheesegrader

Running the CLI

• Windows: py -m cheesegrader main
• You’ll see a menu with modules:
  • [0] Sorting
  • [1] Copying
  • [2] Uploading
  • [3] Downloading
• Enter h at any prompt for help; q to quit.

Authentication and tokens

To use the uploading and downloading scripts, you will need to generate and input an API access token. You can get this:

• By following the instructions here... but they were out of date last time I checked.
• Logging in to canvas/quercus and then account > settings > + New Access Token
• Navigating to https://q.utoronto.ca/profile/settings and clicking + New Access Token

Course and assignmend IDs

• Course and assignment IDs are visible in Quercus URLs:
  • https://q.utoronto.ca/courses/[COURSE_ID]/assignments/[ASSIGNMENT_ID]
• CSVs should have clean headers (no duplicates, no blanks) and UTF-8 encoding.

Contact

• Submit issues/bugs here
• I'm also happy to answer any questions if you send them to jesse.wardbond at mail.utoronto.ca // ...existing code...