Codehs_grades NPM

CodeHS Crawler

This is a NodeJS tool using the Puppeteer headless browser to crawl the CodeHS code teaching platform for a teacher's students' grades.

Installation

Preferred Method

Use the package manager npm to install CodeHS Crawler.

npm install codehs_grades

Note: Add the -g flag to use this tool anywhere; however, out files will have a different path from that of the working path.

Alternative(Repo) Method

Clone this repository.

git clone https://github.com/e-zhang09/CodeHS-HWCrawler.git
cd CodeHS-HWCrawler
npm link

Note: outputs will be in the 'out' sub-directory

Usage

codehs_grades

Grading Method

All assignments are out of 10 points.

If total time spent on assignment >= 45 minutes

Award 10/10 pts for the assignment.

If all exercises are completed (not "Not Submitted" or "Unopened")

Award 10/10 pts for the assignment.

If none of the above, loop through each exercise of the assignment (N is number of exercises in the assignment)

If time worked on exercise >= 45 / N minutes

Award the exercise 1 pt .

If time worked on exercise >= 45 / (N * 3) minutes

Award the exercise M / (45 / N) pt, where M is the minutes they worked on the exercise.
(Rounding to the 2nd decimal place)

If none of the above

Award the exercise 0 pt.

Note: 'Exercises' and 'assignments' are defined below.
Technical Details
Definition of Exercise vs Assignment
Exercises are the problems each student have to solve as an assignment.

Calculating time spent on each exercise

Using edit sessions

A session ends when there was more than 30 minutes between versions or when the last version is reached.
The duration of each session is the difference between the first and last version of the session.
Note: See TimeCalculations.md for example expected behaviors

Output file paths

Will have more options soon

If installed through npm install codehs_grades
In the node_modules/codehs_grades/ sub-folder of the install location

If installed through npm install codehs_grades -g
On unix systems: /usr/local/lib/node/codehs_grades/ or /usr/local/lib/node_modules/codehs_grades/
On windows: %USERPROFILE%\AppData\Roaming\npm\node_modules\codehs_grades\

If installed through git clone
In the out sub-folder of the project installation location