Getting Started

Running a test from the commandline

All tests are run from a commandline using the rasta application. You can specify a number of options but you minimally need to indicate the root directory of your test fixtures and the spreadsheet you want to run

C:\rasta>rasta --help
Usage: rasta [options] [file(s) ...]
    -f, --fixture-path [path]  Location of test fixtures
    -r, --results-path [path]  Location of test results
    -c, --continue [bookmark]  Continue spreadsheet from bookmark
    -p, --pagecount [numpages] Number of pages to process
    --recordcount [numrecords] Number of records to process
    -n, --namespace [module]   Limit test fixture scope to module
    -h, --hide                 Hide the spreadsheet during run
        --help                 Show the detailed help and quit
fixture-path The fixture-path option is a required option that tells the program where to find your test fixtures. This should be the root directory and the code will search through the subdirectories and include any ruby files
results-path The results-path indicates the directory to store commandline, html and spreadsheet output (we push results to a copy of the input spreadsheet). This defaults to ./rasta_test_results
continue This feature has a few different modes of operation. As the spreadsheet runs, at the end of any row/column of data, a breadcrumb is dropped into a .bookmark file in the directory you’re running from. If for some reason the spreadsheet is not run to completion, you can automatically continue from the last checkpoint.

Additionally you can specify a specific tab with—continue TabName or even a specific row/column with

—continue TabName[column] (where column = A,B,C…)

—continue TabName[row] (where row = 1,2,3…)
pagecount Processsing will stop after this number of worksheets have been processed.
recordcount Processsing will stop after this number of records have been processed.
namespace You may want a little more control over the files that get loaded from the fixture path. This parameter will allow you to specify the namespace of the test fixtures.
hide This will suppress the spreadsheet from being visible during the test run

Examples

There are some spreadsheets in the /examples directory (you can get the zip from the rubyforge download page) that will give a very basic idea of how this tool can be used. Each of these use the commandline to launch. So to run the sample rasta fixture that uses MathFunctions you could use:

rasta examples\rasta_fixture.xls -f examples\fixtures