plasticscm-statistics 0.0.14

Python command line library to generate Plastic SCM activities reports

Plastic SCM Repository Activities Reporting

Python command line library to generate Plastic SCM repository activities reports.

Usage

Prerequisite

Our command line utility relies on the following other utilities:

• cm: Plastic SCM command line.
• diff: Unix utility that computes and displays the differences between the contents of files
• diffstat: Unix utility that provides statistics based on the output of diff.

Make sure that you have configured Plastic SCM client application so that it uses the Unix command-line utility diff for comparing text files. This setting needs to be written in the Plastic SCM client application's configuration file $USER/.plastic4/client.conf:

<DiffTools>
  <DiffToolData>
    <FileType>enTextFile</FileType>
    <FileExtensions>*</FileExtensions>
    <Tools>
      <string>/usr/bin/diff -u "@sourcefile" "@destinationfile"</string>
    </Tools>
  </DiffToolData>
  ...
</DiffTools>

Installation

pip install plasticscm-statistics

Execution

usage: cmstats [-h] [--end-time ISO8601] [--logging-level LEVEL] [--server NAME] [-o PATH]
               [--start-time ISO8601]

Plastic SCM repository activities reporting

options:
  -h, --help            show this help message and exit
  --end-time ISO8601
                        specify the latest date of changesets to return. This date is exclusive, so changesets that
                        were made at this date are not returned.
  --logging-level LEVEL
                        specify the logging level (critical, error, warning, info, debug)
  --server NAME         specify the Plastic SCM server to connect to
  -o PATH, --output-file PATH
                        specify the path and name of the file to write in the activity statistics of the Plastic SCM
                        repositories
  --start-time ISO8601
                        specify the earliest date of changesets to return. This date is inclusive, so changesets that
                        were made at this date are returned.