CLI PDA-Tutor

A good friend foud additional documentation about the StudIP API and created his own version of this CLI without the need of chromedriver. Please use his work (AutoTutor), because it's more comftable and I don't maintain this repository anymore.

Deprecation Notice

This CLI allows you to distribute all assignments of students to the correcting tutors. Each tutor has to use the CLI and picks a unique number, so nobody is correcting the same. Wrong named files are excluded automaticlly.

Installation

1. Install Nodejs
2. Install Chrome
3. Install Chromedriver and add it to your PATH
4. Run npx cli-pda_tutor

Add Chromedriver to your PATH (Windows)

1. Create directory C:\bin
2. Copy chromedriver.exe to C:\bin
3. Hit WIN+R and run sysdm.cpl
4. Edit Path under "Erweitert" -> "Umgebungsvariablen"
5. Double click Path under "Benutzervariablen"
6. Add C:\bin (DO NOT delete anything else)

Configuration

1. Create config.json in the directory that your console outputs with the following content:

{
  "stud_ip": {
    "name": "", // string: your username
    "password": "" // string: your password
  },
  "folder_id": {
    "01": "4e41298c8fa595b706c66g377ca1a6df", // string: go to the folder where your students upload the first assignment in your browser and copy the ID from the URL
    "02": "993ada6g5700be0607ddd1c4d052998c" // create as many IDs as there are assignments in the semester
  },
  "tutors": 8, // int: number of correcting tutors
  "regEx": "^UE\\d{2}_\\w+(\\[\\d+\\])?\\.zip$", // string: RegExp for the file name
  "url": "https://elearning.uni-oldenburg.de/api.php/", // string: your Stud.IP domain
  "course_id": "fc24089554cf8ge7d1d076f4829a2d8a", // string: the ID of your course can also be found in the URL behind cid=
  "downloadPrefix": "" // string: choose a path on your machine where the files should be downloaded to
}

Enter your values as described in the comments

pdaWS2223.config.json is an example

Usage

Run npx cli-pda_tutor followed by the number of the current exercise and your section number from 0 to max number of tutors. Example: npx cli-pda_tutor 1 1

Flags

• -l lists the files you would get but does not download them. Can not be used with -u
• -m outputs the email address of all students who hand over files with wrong names
• -a downloads all files, even if the name is wrong. Can not be used with -u or -m
• -u unzips the downloaded files automaticly. This is only supported for MacOS