NAME

runtests - run one or more GSC test scripts

SYNOPSIS

# run everything in a given namespace
cd my_sandbox/GSC
ur test run --recurse

# run only selected tests
cd my_sandbox/GSC
ur test run My/Module.t Another/Module.t t/foo.t t/bar.t

# run only tests which load the GSC::DNA module
cd my_sandbox/GSC
ur test run --cover GSC/DNA.pm

# run only tests which cover the changes you have in Subversion
cd my_sandbox/GSC
ur test run --cover-svn-changes

DESCRIPTION

Runs a test harness around automated test cases, like "make test" in a make-oriented software distrbution, and similar to "prove" run in bulk.

When run w/o parameters, it looks for "t" directory in the current working directory, and runs ALL tests under that directory.

OPTIONS

--recurse

Run all tests in the current directory, and in sub-directories.

--long

Include "long" tests, which are otherwise skipped in test harness execution

-v

Be verbose, meaning that individual cases will appear instead of just a full-script summary

--cover My/Module.pm

Looks in a special sqlite database which is updated by the cron which runs tests,
to find all tests which load My/Module.pm at some point before they exit.  Only
these tests will be run.

* you will still need the --long flag to run long tests.

* if you specify tests on the command-line, only tests in both lists will run

* this can be specified multiple times

--cover-TOOL-changes

TOOL can be svn, svk, or cvs.

The script will run either "svn status", "svk status", or "cvs -q up" on a parent
directory with "GSC" in it, and get all of the changes in your perl_modules trunk.
It will behave as though those modules were listed as individual --cover options.

PENDING FEATURES

automatically running in parallel on a remote compute cluster

automatic remote execution for tests requiring a distinct hardware platform

logging profileing and coverage metrics with each test

Report bugs to <software@genome.wustl.edu>.