A code autograder for student homework submissions
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
пре 8 година
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. kgrader
  2. =======
  3. __kgrader__ is a code autograder, originally created by the course staff of
  4. [CS 296-41](https://cs.illinois.edu/courses/profile/CS296) (Systems Programming
  5. Honors) at the University of Illinois to grade student homework submissions.
  6. It is written in Ruby.
  7. Installation
  8. ------------
  9. Download kgrader over git:
  10. git clone https://github.com/earwig/kgrader.git kgrader
  11. cd kgrader
  12. If you want to use UIUC-specific assignment specifications (requires special
  13. permissions, but you have those if you want to grade our assignments, right?):
  14. git submodule update --init
  15. Usage
  16. -----
  17. kgrader uses rake as its command-line interface.
  18. ### Setup
  19. To show all known classes, semesters, and assignments:
  20. rake list
  21. To load a roster for a course semester:
  22. rake roster cs123 sp2016 myroster.csv
  23. ### Grading
  24. To grade a particular assignment (e.g., "mp1" for the "cs123" course):
  25. rake grade cs123 mp1
  26. After verifying that everything looks good, push the grade reports with:
  27. rake commit cs123 mp1
  28. ### Housekeeping
  29. To do some basic cleanup (i.e., trash uncommitted grading attempts, or reset
  30. messy internal state after a bad run):
  31. rake clean
  32. To restore kgrader to its "factory defaults" (i.e., everything `clean` does,
  33. but also delete checked-out student repos and roster files -- dangerous!):
  34. rake clobber
  35. ### Advanced
  36. `grade` has an extended syntax for different options.
  37. To specify the semester, instead of the inferred current one:
  38. rake grade cs123 mp1 semester=sp16
  39. To set a cutoff date after which commits will be ignored:
  40. rake grade cs123 mp1 due="March 20, 2016 11:59:59 PM CDT"
  41. To grade without fetching new student repo changes:
  42. rake grade cs123 mp1 fetch=no
  43. To grade specific students only:
  44. rake grade cs123 mp1 students=ksmith12
  45. rake grade cs123 mp1 students=ksmith12,bcooper3,mjones14
  46. Normally, kgrader will only regrade a particular student's assignment if their
  47. repo has changed since the last run. To forcibly regrade:
  48. rake grade cs123 mp1 regrade=yes
  49. You can combine these arguments in any meaningful way.