get_student_progress: Get the grades your students progress summary
In McClellandLegge/netmathtools: Automate NetMath Mentor Duties

Description Usage Arguments Value Examples

Get the grades your students progress summary

1 2	get_student_progress(h = NULL, user = NULL, passwd = NULL, student_list, all_students = TRUE, active = FALSE, outfile = NULL, ...)

`h`	A valid handle to a Mathable session (logged in and cookies in jar)
`user`	Your username, e.g. <netid>@netmath.illinois.edu
`passwd`	Your password Mathable password
`student_list`	A data.table (data.frame) of students with the structure LastName, FirstName, EndDate (in header) with the EndDate in the mm/dd/yyyy format
`all_students`	Boolean, should all of the grades be pulled, or just the logged in Mentor's?
`active`	Boolean, should only the active students be pulled?
`outfile`	A filename to write results to.
`...`	Arguments to 'merge' when combining the student list and the progress results

A data frame with columns:

FirstName The first name of the student
LastName The last name of the student
CourseId The fully qualified course ID in Mathable
CourseName The "short name" for the course
Mentor The mentor name
Status The status of the student, e.g. "Completed", "Active" or "Withdrawn"
Lesson The Lesson number
TryIt The Try It number
EndDate The student's end date
ProgressStatus The status of the student determined by the criteria set by the NetMath office
DaysLeft The number of days left in the course the student has
DaysBehind The number of days behind the recommended schedule the student is
TryItsBehind The number of Try Its behind the recommended schedule the student is
LessonsBehind The number of Lessons behind the recommended schedule the student is
CurrentPace The number of Try Its submitted per day the student is averaging
CurrentInterp A plain-english (approximate) interpretation of what the student's current pace means about their submission behavior
TryItsLeft The number of Try Its the student has left in the course
NeededPace The number of Try Its per day the student must average in order to complete the course on time
NeededInterp A plain-english (approximate) interpretation of what the NeededPace means in terms of needed submission behavior from the student. Intentionally rounded up to the half day

## Not run: 
# Read in a student list from a google sheet
netmath_students_rss <- googlesheets::gs_url("https://docs.google.com/spreadsheets/...")

# Format to data.table from data.frame and format the student's end date to
# the R datatype \code{Date}
netmath_students <- as.data.table(gs_read(netmath_students_rss))
netmath_students$EndDate <- as.Date(netmath_students$EndDate, format = "%m/%d/%Y")

# Get a progress update on the students in the student list.
# The 'all.y = TRUE' is telling the function to keep all students in the
# student list -- helps detect any possible mis-spellings of names
prog <- get_student_progress(user = "mkemp6@netmath.illinois.edu",
                            passwd = "<passwd>",
                            student_list = netmath_students[, .(LastName, FirstName, EndDate)],
                            all.y = TRUE,
                            active = TRUE)

## End(Not run)