Canvas Create Group Peer Review

IN DEVELOPMENT! Questions? Ask Alison - [email protected]

• "Works" - but does not handle errors well! Use at your discretion
• ⛔️ You cannot "undo" assignment of peer reviews! When you run the script it will delete any existing peer reviews even if there is an error (and no other peer reviews are assigned)

The jupyter notebook dash-app.ipynb allows the user to select an assignment, select canvas group sets and assigns X peer reviews.

Important Notes

1. You need to have created a .env file -> add your url, token, and course_id

API_TOKEN = ''
API_INSTANCE = 'https://ubc.instructure.com'
COURSE_ID = 

2. This process allows you to select an assignment and a group set from your course
3. You can then N peer reviews that will be applied within the groups in the selected group set

Note: you must set N to at least 1 less than members in the groups

4. ⚠️ Running this will delete ALL current peer reviews for the assignment (this cannot be undone)
5. The peer review assignment is random, so when you run will be different each time
6. The data for a course is pulled once, so you must Restart and Run All in Jupyter if any Canvas changes are made

▶️ If you make any changes you need to select Kernel -> Restart & Run All to refresh the data

▶️ When you are ready select Kernel -> Restart & Run All.

Getting Started

Sauder Operations

Are you Sauder Operations Staff? Please go here for detailed instructions to run in Jupyter. ("The Project", or "the-project" is "canvas-create-group-peer-review" or "Canvas Create Group Peer Review").

General (terminal instructions)

Project uses conda to manage environment (See official conda documentation here)

First Time

1. Ensure you have conda installed (Python 3.9 version)
2. Clone canvas-create-group-peer-review repository
3. Import environment (once): $ conda env create -f environment.yml
4. Create .env file and include:

API_TOKEN = ''
API_INSTANCE = 'https://ubc.instructure.com'
COURSE_ID = 

Your .env file should be in this project folder.

Every Time

1. Update your .env file

2. Run:

   1. navigate to your directory $ cd YOUR_PATH/canvas-create-group-peer-reviews
   2. activate the environment (see step 3 on first run) $ conda activate canvas-create-group-peer-review
   3. in terminal launch jupyter notebook $ jupyter notebook dash-app.ipynb
   4. follow prompts in jupyter notebook

---

authors: @alisonmyers