cppcheck/tools/triage_py
Long Radix c033c62190
Typos and stilistic updates (#5141)
2023-06-14 12:30:45 +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 Typos and stilistic updates (#5141) 2023-06-14 12:30:45 +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.