NAME

Code::Statistics - collects and reports statistics on perl code

VERSION

version 1.102351

SYNOPSIS

On a terminal:

# collect statistics on the current directory and sub-directories,
# then store results in codestat.out as json
codestat collect

# compile a report from codestat.out and print to the terminal
codestat report

DESCRIPTION

This is a framework to collect various metrics on a codebase and report them in a summarized manner. It is meant to be as extensible as possible.

The current collection workflows are as follow:

Collection

All files in the search path are collected.

Target constructs as defined by modules living under Code::Statistics::Target:: are collected for all files.

Metrics as defined by modules living under Code::Statistics::Metric:: are collected for all targets.

All data is dumped as json to codestat.out.

Reporting

Data from the local codestat.out is read.

Data is grouped by target and for each target type the following is printed:

Averages of all non-location metrics.

Tables with the top ten and bottom ten for each significant metric.

SUBROUTINES/METHODS

This module acts mostly as a dispatcher and collects configuration data, then forwards it to actual action modules. These are the methods it currently provides.

collect

Dispatches configuration to the statistics collector module.

report

Dispatches configuration to the statistics reporter module.

AUTHOR

Christian Walde <mithaldu@yahoo.de>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2010 by Christian Walde.

This is free software, licensed under:

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE, Version 2, December 2004