This page documents all flags available in Quick Test CLI, organized by category.
File Path Flags
These flags specify the files used during testing.
Target File
The solution file you want to test. This is required for all testing commands.
Type: PathBuf
Required in: stress, cmp, check, output
Example:
quicktest stress --target-file solution.cpp
Generator File
A program that generates random test cases. When not specified, Quick Test will look for existing test cases or use manual input.
Type: PathBuf
Default: "" (empty)
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp -g generator.cpp
Correct File
-c, --correct-file <FILE>
A known correct solution to compare against your target file.
Type: PathBuf
Required in: cmp
Example:
quicktest cmp -t solution.cpp -c correct.cpp
Checker File
-c, --checker-file <FILE>
A custom checker program that validates the output. Used for problems with multiple valid answers.
Type: PathBuf
Required in: check
Example:
quicktest check -t solution.cpp -c checker.cpp
Resource Limit Flags
These flags control execution limits for your programs.
Timeout
--timeout <MS>
--tout <MS>
Maximum execution time allowed in milliseconds. If exceeded, the test case receives a TLE (Time Limit Exceeded) status.
Type: u32
Default: 2000 (2 seconds)
Range: Any positive integer
Available in: stress, cmp, check, output
Examples:
# 3 second timeout
quicktest stress -t solution.cpp --timeout 3000
# Using alias
quicktest stress -t solution.cpp --tout 1500
Memory Limit
--memory-limit <BYTES>
--ml <BYTES>
Maximum memory allowed in bytes. If exceeded, the test case receives an MLE (Memory Limit Exceeded) status.
Type: u64
Default: 1000000000 (1GB)
Range: Any positive integer
Available in: stress, cmp, check, output
Examples:
# 512MB limit
quicktest stress -t solution.cpp --memory-limit 512000000
# Using alias
quicktest stress -t solution.cpp --ml 256000000
Test Control Flags
These flags control the number and selection of test cases.
Test Cases
--test-cases <NUMBER>
--tc <NUMBER>
Number of test cases to generate and run.
Type: u32
Default: 1000
Range: Any positive integer
Available in: stress, cmp, check
Examples:
# Run 500 test cases
quicktest stress -t solution.cpp --test-cases 500
# Using alias
quicktest stress -t solution.cpp --tc 100
Prefix
Prefix for saved test case files. Test cases will be saved with this prefix followed by the status and number.
Type: String
Default: "" (empty)
Available in: stress, cmp, check, output
Example:
quicktest stress -t solution.cpp --prefix my_test --save-bad
# Creates files like: my_test_testcase_wa_1.in, my_test_testcase_wa_1.out
Execution Control Flags
These flags modify the execution behavior.
Break on Bad
Stop execution immediately when a bad test case is found (WA, TLE, RTE, or MLE).
Type: boolean
Default: false
Available in: stress, cmp, check, output
Example:
quicktest stress -t solution.cpp --break-bad
quicktest cmp -t solution.cpp -c correct.cpp -b
Use this flag to quickly find the first failing test case without running all tests.
Saving Flags
These flags control which test cases are saved to disk.
Save Bad
Save only test cases that result in WA, TLE, RTE, or MLE status. Useful for debugging failures.
Type: boolean
Default: false
Conflicts with: --save-all
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --save-bad
Save All
Save all test cases regardless of status (AC, WA, TLE, RTE, MLE).
Type: boolean
Default: false
Conflicts with: --save-bad
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --save-all
Save Output
Save the output file for each test case when using the output command.
Type: boolean
Default: false
Available in: output
Example:
quicktest output -t solution.cpp -p test --save-out
--save-bad and --save-all are mutually exclusive. Use only one at a time.
Run Filter Flags
These flags allow you to run specific subsets of previously saved test cases.
Run All
Run all previously saved test cases regardless of their status.
Type: boolean
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --run-all
Run AC
Run only test cases that previously received Accepted status.
Type: boolean
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --run-ac
Run WA
Run only test cases that previously received Wrong Answer status.
Type: boolean
Available in: stress, cmp, check
Example:
quicktest cmp -t solution.cpp -c correct.cpp --run-wa --diff
Run TLE
Run only test cases that previously received Time Limit Exceeded status.
Type: boolean
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --run-tle
Run RTE
Run only test cases that previously received Runtime Error status.
Type: boolean
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --run-rte
Run MLE
Run only test cases that previously received Memory Limit Exceeded status.
Type: boolean
Available in: stress, cmp, check
Example:
quicktest stress -t solution.cpp --run-mle
Run filter flags can be combined to run multiple status types. For example, use both --run-wa and --run-tle to run all WA and TLE test cases.
Output Flags
These flags control how results are displayed.
Diff
Show differences between expected output and actual output when using the cmp command.
Type: boolean
Default: false
Available in: cmp
Example:
quicktest cmp -t solution.cpp -c correct.cpp --diff
The --diff flag provides a line-by-line comparison, making it easy to spot where your output differs from the expected output.
Setup Flags
These flags are used with the setup command for configuration.
Label
Configuration label to update. Format: Language.SETTING
Type: String
Required in: setup config
Example:
quicktest setup config --label "cpp.PROGRAM" --value "g++"
Value
New value for the configuration setting.
Type: String
Required in: setup config
Example:
quicktest setup config --label "cpp.STANDARD" --value "-std=c++17"
Example Flags
These flags are used with the example command to show usage examples.
--stress # Show stress command examples
--cmp # Show cmp command examples
--check # Show check command examples
--output # Show output command examples
--setup # Show setup command examples
Type: boolean
Mutually exclusive: Exactly one must be specified
Example:
quicktest example --stress
quicktest example --cmp