<<

NAME

run_randoop.pl -- generate test suites using Randoop.

SYNOPSIS

  run_randoop.pl -p project_id -v version_id -n test_id -o out_dir -b budget [-t tmp_dir] [-D]

OPTIONS

-p project_id

Generate tests for this project id. See Project module for available project IDs.

-v version_id

Generate tests for this version id. Format: \d+[bf].

-n test_id

The id of the generated test suite (i.e., which run of the same configuration).

-o out_dir

The root output directory for the generated test suite. The test suite and logs are written to: out_dir/project_id/version_id.

-b budget

The time in seconds allowed for test generation.

-t tmp_dir

The temporary root directory to be used to check out the program version (optional). The default is /tmp.

-D

Debug: Enable verbose logging and do not delete the temporary check-out directory (optional).

DESCRIPTION

This script runs Randoop for a particular program version. Tests are generated for all classes touched by the triggering tests.

Randoop configuration

The filename of an optional Randoop configuration file can be provided with the environment variable RANDOOP_CONFIG_FILE. The default configuration file of Randoop is: framework/util/randoop.config.

Logging

By default, the script logs all errors and warnings to run_randoop.log in the temporary project root. Upon success, the log of this script is appended to: out_dir/logs/project_id.version_id.log.

Test suites

The source files of the generated test suite are compressed into an archive with the following name: project_id-version_id-randoop.test_id.tar.bz2

Examples:

The test suite archive is written to: out_dir/project_id/randoop/test_id

<<