canvas-sak 1.0.11

Command‑line Swiss Army Knife for Canvas LMS

canvas_sak - canvas Swiss-Army-Knife

a command-line python based tool for teachers who use canvas.

you can download from Pypi. just pip install canvas-sak.

you will need to grab a "token" from your canvas account. go to the canvas webpage -> click on Account in the upper left -> click Settings -> scroll down and click the New Access Token button. you will need to put the token in a configuration file. canvas-sak help-me-setup will tell you how and where to create that configuration file.

some of the major functions:

• code-similarity: download program submissions and run them through stanford MOSS.
• collect-reference-info: collect high level information about student for when they later ask for letters of recommendation.
• download-submissions: the the submissions of an assignment.
• download/upload-course-content: download and upload course content as markdown files for easily reusing past courses in a way that is easy to change.
• message-students: send a canvas messages to students from the commandline
• list/set-due-dates: list and set due dates for assignments all at once

Ignore files pattern

• canvas_sak will search for ignore patterns from the canvas_sak configuration file in the [IGNORE] section.
• if there is a canvas-sak-ignore.lst file in the current directory, it will use patterns in that file as well.
• canvas_sak will avoid processing files that match the ignore patterns.
• the patterns are the same format at gitignore patterns.

Assignment Group files

ASSIGNMENT_GROUP_NAME: WEIGHT_PERCENTAGE ASSIGNMENT_NAME ASSIGNMENT_NAME

Example Group File

Assignments: 10% Assignment1 Hard Assignment Easy Assignment LastAssignment

Test1: 30% Test1

Test2: 30% Test2

Test3: 30%

Validations

• Make sure the the weights add up to 100%. Halt with an error if it does not
• If the Assignment group does not exist, create the group
• If the Assignment doesn't exist, print an error
• Print what would happen, but don't actually do it if the --no-dryrun is not used