dbosk / canvaslms Goto Github PK

We can add an option so that the submission command shows the diff between hand-ins instead of printing each version in full.

By default it should list my courses. Add an option --all to list all courses.

We must create a pip-installable package for one command to be able to import another as a module.

Python's argparse supports subcommands.

This would put everything in the same file, which obsoletes the requirement of #10 (and #8).

Add command to handle outcomes in Canvas (list, add).

There is a guide for how to access the rubric assessment for a submission.

We should add an option, say -r to get the rubric data for a submission.

Add an option to set the LADOK component name. In this case, all matching assignments (or assignment groups) will be summarized into one grade in LADOK.

Add an option to open the submission in the browser.

The results command lists results for a course. And optionally filters one student.

When we list the submissions, we can include grades.

Lists the assignments for a given course (requires #5).

Produce a list of users on a specified course. Requires #5.

Something that can do this for an assignment. And also something that can say something about relations to dates.

#!/bin/bash

COURSE=DD1315
ASSIGNMENT=Projektredovisning

results=$(mktemp)
canvas submissions -c $COURSE -a "$ASSIGNMENT" > $results

function get_results() {
  cat $results
}

function print_stats() {
  total=$(get_results | grep -v None | wc -l)
  echo "Done: $total (100%)"
  As=$(get_results | grep A | wc -l)
  echo "As: $As ($(((100 * $As / $total)))%)"
  Bs=$(get_results | grep B | wc -l)
  echo "Bs: $Bs ($(((100 * $Bs / $total)))%)"
  Cs=$(get_results | grep C | wc -l)
  echo "Cs: $Cs ($(((100 * $Cs / $total)))%)"
  Ds=$(get_results | grep D | wc -l)
  echo "Ds: $Ds ($(((100 * $Ds / $total)))%)"
  Es=$(get_results | grep E | wc -l)
  echo "Es: $Es ($(((100 * $Es / $total)))%)"
  Fs=$(get_results | grep F | wc -l)
  echo "Fs: $Fs ($(((100 * $Fs / $total)))%)"
  echo "Remaining: $(get_results | grep None | wc -l)"
}

print_stats

Add the URL to the repo to the epilogue.

https://github.com/KTH/lms-export-results

Create better classes which reference objects directly instead of Canvas object IDs.

We can use such objects to create an entire object hierarchy representing a course and its contents.

This is particularly useful for the submission command. If the assignment is ".*" you get the details for all assignments.

Have an export/results command that can export results for e.g. LADOK (see this issue). It should export CSV formatted results data.

This would be useful for the submissions command, since then one can filter on an assignment group to get the submissions of a student for all assignments in the assignment group.

If the output (stdout) is going to a TTY, we should filter through pandoc, to convert HTML to plain text.

If there is not TTY, then we output to a pipe or redirection. Then we can send unfiltered HTML.

We could add an argument -i for interactive grading. This would be similar to SpeedGrader. Downloading and viewing any attachments, asks for grade, comments and rubric.

For instance, when we try to tab-complete canvas users -c it should list the possible courses.

The courses command must do some filtering. Add -a option to list all courses. Default to something like favourites or currently running courses.

Add a quiz command that can create and read quizzes results.

As of now, this limits us to the "old" quizzes system.

Which means we can't check the results or submissions for them.

Add an option to the submission command to download attachments.

This should allow us to modify the calendars, e.g. add appointments and list bookings.

We should output a warning or an error when a list is empty, eg list of courses or submissions.

The ungraded filter has no effect on assignments which should not be handed in.

Zoom allows importing CSV containing users to map them into breakout rooms. Adapt the output of the users command to be on that format easily.

Take a list of students (requires #4) and their grades and set those for an assignment (requires #6) on Canvas.

Add a reference command that opens the PDF documentation. This requires that the PDF is installed locally.

It would be nice to see the gradebook history:

• https://community.canvaslms.com/t5/Canvas-Question-Forum/How-can-I-un-do-a-grade-change-in-the-Gradebook/td-p/150572
• https://canvas.instructure.com/doc/api/gradebook_history.html

The submissions command shows a submission per user, not a submission for whoever submitted.

It would be nice to be able to select users by regex on their ID, login and name.

Some parts have doc-strings, others don't. Some doc-strings are OK, others bad.

Must add a login command, similar to ladok, which can guide the user to fixing access tokens etc.

In Unix spirit, have a short name.

This way we have syntax highlighted code in the output.

This way we can say we want to grade all ungraded assignments in the filtered group.

We want to be able to filter on grade when listing submissions. Particularly for the submission command if we want to see all Es for instance.

The assignments command should list the assignments by assignment groups.

Check that we don't use the classes for the IDs anymore (this should be true). Then remove them.

Some things can be cached, like user and assignment information. Cache this type of data.

Add an option to store that cache on disk between sessions.

There is a tutorial that seems promising.

We should merge all related work into this command-line utility.

• Chip's Canvas-Tools
• Alan's Canvas-Tools
• Sandor's Canvas grading tool
• Joel's canvascli