Skip to content
Espen Angell Kristiansen edited this page Oct 27, 2013 · 20 revisions

Install

See Install.

General usage information for all scripts

All of the scripts can be exectuted with --help for details on what they do and how they work. Example:

$ ./period-overview-csv.py --help

All of the scripts require login, so you always need to supply --url and --user. Additionally, if your Devilry server do not use Devilry for login, you may have to specify --loginprofile or --usernamefield and --passwordfield.

Instructions for specific devilry installs

About each script

download-all-deliveries-on-assignment.py

Download all deliveries on an assignment. Works for administrators and examiners.

Examples

Download all assignments where you have admin permission:

$ ./download-all-deliveries-on-assignment.py --url https://devilry.example.com --user myusername --assignment inf1000.2013h.oblig-3 --outdir . --role administrator

Same example, but only download groups where you are examiner:

$ ./download-all-deliveries-on-assignment.py --url https://devilry.example.com --user myusername --assignment inf1000.2013h.oblig-3 --outdir . --role examiner

copy-passing-groups.py

Copy groups (students) from one assignment to another. Includes examiners and tags. Example:

$ ./copy-passing-groups.py --url https://devilry.example.com --user someuser --source inf1100.2011h.week1 --target inf1100.2011h.week2 --deadline "2012-04-22 22:30"

list-groups.py

List groups on an assignment as JSON encoded data. Mainly useful as a very simple example, and if you want to get data into another script in any programming language. Example:

$ ./list-groups.py --url https://devilry.example.com --user someuser --assignment inf1100.2011h.week1

number-of-groups-corrected-by-each-examiner.py

Show a table with the number of groups corrected by each examiner. Useful for administrators when calculating cost of a semester. Example:

$ ./number-of-groups-corrected-by-each-examiner.py --url https://devilry.example.com --user someuser --period inf1010.2012v

NOTE: This script used to count the examiner that is registered on the group, but now it counts the examiner that actually saved the active feedback.

period-overview-csv.py

Show a table with CSV results for each student on the entire period aggregated. Meaning of the numbers in the table:

  • 0: No deliveries
  • 1: Not approved
  • 2: Approved

Example:

$ ./period-overview-csv.py --url https://devilry.example.com --user someuser --period inf1010.2012v

period-overview.py

Show a table with results for each student on the entire period aggregated. Note that "no-data" means that the student is not registered on that assignment. Example:

$ ./period-overview.py --url https://devilry.example.com --user someuser --period inf1010.2012v