The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

analizo-metrics-batch - processes several source code directories in batch

USAGE

  analizo metrics-batch [OPTIONS] [<input> [<input> ...]]

DESCRIPTION

Processes several source code directories in batch running analizo metrics for each and optionally consolidating the results in a single data file.

analizo metrics-batch is useful when you want to analyze several projects at once, or several different versions of the same project. You pass a list of directories in the command line and each one will be analyzed as a separate project. If no directories are passed in the command line, all of the subdirectories of the current directory will be analized.

For example, suppose you want to process 5 consecutive releases of myproject, from version 0.1.0 to 0.5.0.

  • First you unpack the release tarballs for those versions in a directory, say /tmp/analysis:

      $ ls -1 /tmp/analysis
      myproject-0.1.0
      myproject-0.2.0
      myproject-0.3.0
      myproject-0.4.0
      myproject-0.5.0
  • Then you change to that directory, and then run analizo metrics-batch:

      $ cd /tmp/analysis
      $ analizo metrics-batch
  • analizo metrics-batch will collect the metrics data in a single .csv file, that you can import in spreadsheet software or statistical packages.

analizo metrics-batch is part of the analizo suite.

OPTIONS

--parallel N, -p N

Activates support for parallel processing, using N concurrent worker processes. Usually you will want N to be less than or equal to the number of CPUs in your machine.

Note that analizo metrics extraction is a CPU-intensive process, so setting N as the exacty number of CPUs you have may bring your machine to an unusable state.

--output <file>, -o <file>

Write output to <file>. Default is to write to metrics.csv. That file can then be opened in data analysis programs.

--quiet, -q

Supresses messages to standard output.

COPYRIGHT AND AUTHORS

See analizo(1).