Using the diff tool



HOW TO RUN THE DIFF TOOL

The diff tool is used to compare performance data from two different grinder
runs.  It accepts input from both grinder out_ files, and from the .html report
generated by Grinder Analyzer.  Output formats include tabular text report
or .csv.


To run the analyzer tool from Windows, Linux or OS X:

 1. Open a command-line shell and cd into the grinderAnalyzer directory.
 2. Execute the script like this:
        jython ./difftool.py [ options ] <file1> <file2>

Details on the filename parameters:

 * either file may be a grinder out_ file
 * either file may be the .html report generated by Grinder Analyzer
 * paths may be absolute or relative to the current directory


Details on the options:

        -h, --help        display usage

        -o, --output      text (default) | csv

        -r, --results     all (default) | union (squelches non-shared rows)

        -c, --columns     all (default) | time(only) | len(only)

        -d, --different   only show rows that differ by this percentage.

        -f, --file        by default difftool sends text output to standard out.
                          With this option you may specify a file for results to
                          be written to.  (csv output is only written to files,
                          so this option has no effect for that output type.)

EXAMPLES

    jython difftool.py 28.log 29.log

    jython difftool.py -o csv -r union -c time grinderReport/report.html 29.log
USAGE
