Base System

The package roger-base contains the Unix shell scripts at the cornerstone of the automated grading system.

The latest release is 1.2-2 (2025-01-09). Release Notes

Installation on macOS and Windows

Use the provided installers.

macOS Installer Windows Installer

Roger requires gettext to translate messages. You already have the software if you installed Git, notably on Windows. On macOS, just make sure to install Git through Homebrew and you are good to go.

Installation on Linux or manually

Use the .tar.gz archive option below and uncompress the archive into the root of the filesystem.

tar xzvf roger-base-1.2-2.zip -C /
Tarball Installer

What is included

The base system contains the following scripts.

  • roger is the unified interface to the tools below.

  • roger checkreq checks that all required software (command line utilities, R packages) is installed on a grader’s workstation.

  • roger clone fetches at once the students projects hosted in Git repositories.

  • roger grade is the true workhorse that grades the projects for the criteria that can be handled automatically.

  • roger harvest collects the grading results, computes summaries and returns a table of results in CSV format.

  • roger push sends the grading sheet to students directly in their Git repository once grading is complete.

  • roger switch switches the branches of Git repositories in batch.

  • roger validate allows students to validate their work (file and function names, structure of the Git repository, validity of code) prior to handing it in.

R Package

The R package roger provides an interface to the shell scripts and tools to grade the coding style and documentation of R scripts. It is distributed exclusively through CRAN.

The latest release is 1.5-1 (2023-10-24). News (from CRAN)

Install the package directly from R:

> install.packages("roger")

Source Code

The source code of Roger the Omni Grader is hosted on GitLab.

View on GitLab