{"id":37021738,"url":"https://github.com/sourcegrade/jagr","last_synced_at":"2026-01-14T02:35:00.183Z","repository":{"id":37976150,"uuid":"348132080","full_name":"sourcegrade/jagr","owner":"sourcegrade","description":"Java AutoGrader, Implemented in Kotlin","archived":false,"fork":false,"pushed_at":"2025-12-16T16:59:27.000Z","size":20068,"stargazers_count":27,"open_issues_count":37,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-20T07:55:42.554Z","etag":null,"topics":["grading","java","kotlin"],"latest_commit_sha":null,"homepage":"https://docs.sourcegrade.org/jagr/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sourcegrade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"authors","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-03-15T21:48:01.000Z","updated_at":"2025-08-21T19:38:37.000Z","dependencies_parsed_at":"2025-12-06T20:06:09.396Z","dependency_job_id":null,"html_url":"https://github.com/sourcegrade/jagr","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/sourcegrade/jagr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcegrade%2Fjagr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcegrade%2Fjagr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcegrade%2Fjagr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcegrade%2Fjagr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sourcegrade","download_url":"https://codeload.github.com/sourcegrade/jagr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcegrade%2Fjagr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28408711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T01:52:23.358Z","status":"online","status_checked_at":"2026-01-14T02:00:06.678Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["grading","java","kotlin"],"created_at":"2026-01-14T02:34:59.420Z","updated_at":"2026-01-14T02:35:00.171Z","avatar_url":"https://github.com/sourcegrade.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"logo.svg\" align=\"float\" width=\"75%\" alt=\"jagr logo\"\u003e\n    \u003ch1\u003eJava AutoGrader, Implemented in Kotlin\u003c/h1\u003e\n\u003c/div\u003e\n\nA tool used to grade Java programs.\nIt is designed to accept graders and submissions created with the `jagr-gradle` plugin.\n\n## Setup\n\nThis project's compiled, source and javadoc jars are hosted on [sonatype](https://s01.oss.sonatype.org).\n\nReleases are available from `mavenCentral()` and snapshots from the maven\nrepository `maven(\"https://s01.oss.sonatype.org/content/repositories/snapshots/\")`.\n\nFollow [this guide](https://docs.sourcegrade.org/development/getting-started/gradle-setup/) to set up your gradle buildscript.\n\n## Usage\n\nCreate a basic `Criterion`:\n\n```java\npublic static final Criterion H1_1 = Criterion.builder()\n    .shortDescription(\"Some short description\")\n    .maxPoints(3) // default maxPoints is 1\n    .minPoints(-1) // default minPoints is 0\n    .grader(Grader.testAwareBuilder()\n        .requirePass(JUnitTestRef.ofMethod(() -\u003e Tests.class.getMethod(\"testPositiveInts\")))\n        .requirePass(JUnitTestRef.ofMethod(() -\u003e Tests.class.getMethod(\"testNegativeInts\")))\n        .pointsPassedMax() // award maximum points if ALL tests passed\n        .pointsFailedMin() // award minimum points if ANY test failed\n        .build())\n    .build();\n```\n\nMake sure your JUnit test classes are annotated as follows, or they will not run:\n\n```java\n@TestForSubmission\npublic class Test {\n```\n\nA `Criterion` may be nested as follows:\n\n```java\npublic static final Criterion H1_1 = Criterion.builder()./*hidden*/.build();\npublic static final Criterion H1_2 = Criterion.builder()./*hidden*/.build();\n\npublic static final Criterion H1 = Criterion.builder()\n    .shortDescription(\"I have two child criteria!\")\n    .addChildCriteria(H1_1, H1_2) // maxPoints, minPoints and grading is inferred from child criteria\n    .build();\n```\n\nFinally, create a `Rubric` and implement `RubricProvider`:\n\n```java\npublic class H03_RubricProvider implements RubricProvider {\n    public static final Criterion H1_1 = Criterion.builder()./*hidden*/.build();\n    public static final Criterion H1_2 = Criterion.builder()./*hidden*/.build();\n    public static final Criterion H1 = Criterion.builder()./*hidden*/.build();\n\n    public static final Rubric RUBRIC = Rubric.builder()\n        .title(\"My example rubric\")\n        .addChildCriteria(H1)\n        .build();\n\n    @Override\n    public Rubric getRubric() {\n        return RUBRIC;\n    }\n}\n```\n\n## Running Jagr\n\nTo run Jagr, download the desired compiled release of Jagr from\n[releases](https://github.com/sourcegrade/jagr/releases) and place it in a (preferably empty) directory of your choice.\n\nThen either run the following command in a terminal of your choice (or write a batch/bash script that you can execute):\n\n```bash\njava -jar Jagr-VERSION.jar\n```\n\nAlternatively, you may run Jagr in-IDE via the Gradle `runShadow` task (the standard `run` task does not work).\n\nThe working directory used is `build/run`.\n\nThe following directories should have been created:\n\n```\n./graders // input folder for grader jars (tests and rubric providers)\n./libs // for libraries that are required on each submission's classpath\n./logs // saved log files\n./rubrics // the output folder for graded rubrics\n./submissions // input folder for submissions\n./submissions-export // output folder for submissions\n```\n\nPlace your grader jar(s) (tests and rubric providers) in `./graders` and the submission(s) you want to test\nin `./submissions` and rerun Jagr.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcegrade%2Fjagr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsourcegrade%2Fjagr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcegrade%2Fjagr/lists"}