Command-Line Interface

The command-line interface allows checking (via test cases with provided aga_expect) the validity of golden solutions, as well as generating the autograder file from a problem.

CLI Reference

aga

aga [OPTIONS] COMMAND [ARGS]...

Options

--install-completion

Install completion for the current shell.

--show-completion

Show completion for the current shell, to copy it or customize the installation.

check

Check a problem against test cases with an aga_expect.

aga check [OPTIONS] SOURCE

Options

-c, --config <config_file>

The path to the aga config file.

Default

aga.toml

--inject <inject>

Inject a util file into the submission directory.

Default

--inject-all <inject_all>

Inject all util files in the specified folder into the submission directory.

Default

--injection-module <injection_module>

The name of the module to import from the injection directory.

Default

injection

--auto-inject

Find the first injection directory recursively and automatically.

Default

False

Arguments

SOURCE

Required argument

gen

Generate an autograder file for a problem.

aga gen [OPTIONS] SOURCE

Options

-f, --frontend <frontend>

The frontend to use. Currently only gradescope is supported.

Default

gradescope

-o, --output <output>

The path to place the output file(s).

-c, --config <config_file>

The path to the aga config file.

Default

aga.toml

--inject <inject>

Inject a util file into the submission directory.

Default

--inject-all <inject_all>

Inject all util files in the specified folder into the submission directory.

Default

--injection-module <injection_module>

The name of the module to import from the injection directory.

Default

injection

--auto-inject

Find the first injection directory recursively and automatically.

Default

False

Arguments

SOURCE

Required argument

run

Run the autograder on an example submission.

aga run [OPTIONS] SOURCE SUBMISSION

Options

-c, --config <config_file>

The path to the aga config file.

Default

aga.toml

--points <points>

The total number of points for the problem.

Default

20.0

--due <due>

The problem due date.

Default

now

--submitted <submitted>

The problem submission date.

Default

now

--previous_submissions <previous_submissions>

The number of previous submissions.

Default

0

--inject <inject>

Inject a util file into the submission directory.

Default

--inject-all <inject_all>

Inject all util files in the specified folder into the submission directory.

Default

--injection-module <injection_module>

The name of the module to import from the injection directory.

Default

injection

--auto-inject

Find the first injection directory recursively and automatically.

Default

False

Arguments

SOURCE

Required argument

SUBMISSION

Required argument