MetricFu

Metrics

Cane, Source
Churn, Source
Flog, Source
Flay, Source
Reek Source
Roodi, Source
Saikuro, Source
Rails-only
- Rails Best Practices, Source
- Rails rake stats task (see gem, Source )
Test Coverage
- 1.9: SimpleCov and SimpleCov-Rcov-Text
- 1.8 Rcov
Hotspots (a meta-metric of the above)

Installation

gem install metric_fu

If you have trouble installing the gem, try adding metric_fu to your Gemfile. You may also want to file a ticket on the issues page.

See documentation on the rubyforge page for how to customize your metrics. Otherwise, all current information is either in this repo or on the wiki.

Usage

By default, you can run all metrics from the root of an app with the command metric_fu -r

See metric_fu --help for more options

Compatibility

It is currently testing on MRI 1.9.2, 1.9.3 and 2.0.0. Ruby 1.8 is no longer supported due to the cane library.
For 1.8.7 support, see version 3.0.0 for partial support, or 2.1.3.7.18.1 (where Semantic Versioning goes to die)
The japgolly-Saikuro fork and metric_fu-roodi fork are a part of an attempt to get metric_fu working in a modern Ruby environment, specifically compatibility with Ruby 1.9 and Bundler.
metric_fu no longer runs rcov itself. You may still use rcov metrics as documented below
The Cane, Flog, and Rails Best Practices metrics are disabled in non-MRI rubies as they depend on ripper

Documentation

Cane code quality threshold checking is not included in the hotspots report

Configuration

see the .metrics file

Using Coverage Metrics

in your .metrics file add the below to run pre-generated metrics

MetricFu::Configuration.run do |config|
  coverage_file = File.expand_path("coverage/rcov/rcov.txt", Dir.pwd)
  config.add_metric(:rcov)
  config.add_graph(:rcov)
  config.configure_metric(:rcov, {:external => coverage_file})
end

if you want metric_fu to actually run rcov itself (1.8 only), just add

MetricFu.run_rcov

Rcov metrics with Ruby 1.8

To generate the same metrics metric_fu has been generating run from the root of your project before running metric_fu

RAILS_ENV=test rcov $(ruby -e "puts Dir['{spec,test}/**/*_{spec,test}.rb'].join(' ')") --sort coverage --no-html --text-coverage --no-color --profile --exclude-only '.*' --include-file "\Aapp,\Alib" -Ispec >> coverage/rcov/rcov.txt

Simplecov metrics with Ruby 1.9 and 2.0

Add to your Gemfile or otherwise install

gem 'simplecov'
# https://github.com/kina/simplecov-rcov-text
gem 'simplecov-rcov-text'

Modify your spec_helper as per the SimpleCov docs and run your tests before running metric_fu

#in your spec_helper
require 'simplecov'
require 'simplecov-rcov-text'
SimpleCov.formatter = SimpleCov::Formatter::RcovTextFormatter
SimpleCov.start
# SimpleCov.start 'rails'

Historical

There is some useful-but-out-of-date documentation about configuring metric_fu at http://metric-fu.rubyforge.org/ and a change log in the the HISTORY file.