Skip to content

HOOKS.md

Latest commit

 

History

History
13 lines (10 loc) · 1.38 KB

HOOKS.md

File metadata and controls

13 lines (10 loc) · 1.38 KB
Raw

Grade Hooks

Hooks are interfaces between grade and the grading scripts written by its users. Creating a hook involves creating a language-name directory in libexec/grade_hooks and placing an executable run script there. The run script should:

  1. Provide the functions problem and extra_credit; their signatures are arbitrary, but it's best to follow the conventions outlined on the man page. problem and extra_credit will call the add_grade executable, storing its stdout in the environment variable GRADE_TABLE. add_grade takes 4 arguments:
    1. "regular" for problem or "extra_credit" for extra_credit
    2. "success" on correct behavior or "failure" on incorrect behavior
    3. The number of points, a non-negative real number
    4. A description of the problem
  2. source (or the language equivalent) each grading script stored in the colon-delimited environment variable GRADE_SCRIPTS.
  3. Run print_grade, which will parse GRADE_TABLE and print it in human-readable form.

Using the provided Bash, Julia, and Python hooks as examples, it shouldn't be too hard to create a new one; for example, to create the Python hook, I just asked ChatGPT to translate the Julia hook and made a couple of minor modifications.