cppcheck/tools/triage_py
Oliver Stöneberg 4807bffdbf
triage_version.py: added `--perf` to collect performance data in CSV format (#4833)
* removed old timing tracking code

* tools/triage_py/README.md: updated

* triage_version.py: fixed output when when stderr and stdout are not empty

* triage_version.py: added `--perf` to collect performance data in CSV format

* triage_version.py: added TODO about providing additional options

* triage_version.py: added `--start` to specify the first tag/commit to execute
2023-04-30 22:19:04 +02:00
..
README.md triage_version.py: added `--perf` to collect performance data in CSV format (#4833) 2023-04-30 22:19:04 +02:00
triage_version.py triage_version.py: added `--perf` to collect performance data in CSV format (#4833) 2023-04-30 22:19:04 +02:00

README.md

triage_version.py

A script to run a code sample against a given set of Cppcheck versions.

Usage

usage: triage_version.py [-h] [--compare] [--verbose] [--debug] [--debug-warnings] [--check-library]
                         [--timeout TIMEOUT] [--compact] [--no-quiet] [--perf] [--start START]
                         [--no-stderr | --no-stdout]
                         dir infile [repo]

positional arguments:
  dir                directory with versioned folders
  infile             the file to analyze
  repo               the git repository (for sorting commit hashes)

options:
  -h, --help         show this help message and exit
  --compare          compare output and only show when changed
  --verbose          verbose output for debugging
  --debug            passed through to binary if supported
  --debug-warnings   passed through to binary if supported
  --check-library    passed through to binary if supported
  --timeout TIMEOUT  the amount of seconds to wait for the analysis to finish
  --compact          only print versions with changes with --compare
  --no-quiet         do not specify -q
  --perf             output duration of execution in seconds (CSV format)
  --start START      specify the start version/commit
  --no-stderr        do not display stdout
  --no-stdout        do not display stderr

Structure of dir

It expects the given dir to contain folders which are either named after version numbers or commit hashes. These folders must each contain a cppcheck and the associated files for that version.

If the first folder is not a valid version the names are interpreted as commit hashes. These are internally sorted but that requires the repo parameter to be set.

It is not possible to mix versions and commit hashes.