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 exactly 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

Suppresses messages to standard output.

COPYRIGHT AND AUTHORS¶

See analizo(1).