Jacquard is a Java autograder developed at Northeastern University with Gradescope integration. It has been used at multiple universities.
- Static analysis with Checkstyle and PMD.
- Syntactic analysis using JavaParser
- Test coverage and cyclomatic complexity measurement with JaCoCo.
- Unit testing with JUnit 5, including:
- running staff tests against student code
- running student tests against
- student code
- intentionally buggy staff-written code
- correct staff-written code
The best way to learn Jacquard is to review the examples, which include video explanations.
You should start with Jacquard Example 0, which shows how to grade based on Checkstyle, PMD, and JUnit 5 tests.
Jacquard Example 1 adds syntactic analysis based on the parse tree, such as whether students use certain language features and methods.
Jacquard Example 2 demonstrates:
- Changing the default configuration values:
- visibility level of results
- timeouts
- language level
- Running Checkstyle and PMD on multiple student files
- Measuring code coverage of student tests
- Running unit tests on student code
- Fine-grained control of visibility
- Cross-testing, i.e., running student tests against
- student code
- correct code
- buggy code
Example 2 does not depend on Example 1, which may be skipped if you are not interested in syntactic analysis.
There are low-volume Google groups jacquard-announce and jacquard-discuss.
I welcome contributors, especially ones interested in integrating Jacquard with learning management systems (LMSs) and GitHub Classroom. See tips for contributors.
I also welcome reports, including suggestions of how to improve Jacquard, the documentation, or examples.
Jacquard was influenced by Tim Kutcher's JGrade and
includes some of its Visibility
and GradedTest
code.