metrics

Fine-tuned metric_fu configuration, with vim protocol handler.

Description

Running metric_fu can be a little slow if you run on our whole product.

So, I found how to run the same suite only on specific subdirectory and only on the files we're interested on.

Also, I disabled some metrics I usually run separately (like Simplecov) or which I'm not interested in.

Url in reports will open the file using vim, just to edit it fast.

TODO: Support to open the file in the line referer in the report.

Installing in your project

Within your project directory, execute the following steps.

1. Install the Ruby gem:

   gem install metric_fu

   Note: At least metric_fu 4.4.1 is required.

2. Clone the repo:

   git clone https://github.com/ShogunPanda/metrics.git

3. Load the metric_fu configuration:

   ln -s metrics/metric_fu.rb .metrics

   Obviously this is not needed for manual execution.

4. Added some entries to .gitignore (optional, but recommended):

   echo "metrics/" >> .gitignore
   echo ".metrics" >> .gitignore
   echo "tmp/metric_fu" >> .gitignore

5. Configuring vim protocol handler sudo cp cvim /usr/local/bin/cvim sudo chmod a+x /usr/local/bin/cvim sudo cp cvim.desktop usr/share/applications/cvim.desktop sudo update-desktop-database

To execute the last three steps, you can also use the installer:

curl -s -L https://raw.githubusercontent.com/fhidalgo/metrics/master/installer | sh

Running metrics automatically

SOURCES is a list of directory of Ruby SOURCES. Point this to the actual implementation, not to the spec folder.

MF_SOURCES=$SOURCES metric_fu

Running metrics manually

From now on, SOURCES is a single directory of Ruby SOURCES. Point this to the actual implementation, not to the spec folder.

Sample configs, when applicable, can be found in this repository.

Saikuro

mf-saikuro --input_directory $SOURCES --cyclo "" --filter_cyclo 0 --error_cyclo 6 --formater text --output_directory metrics/saikuro --input_directory $SOURCES

The output will be in file metrics/saikuro/index_cyclo.html.

The maximum allowed complexity is 5 for a single method, and 50 for a class.

The command is set to show only complexities greater than or equal to 6.

### Rails Best Practices

rails_best_practices -f html --output metrics/rails-best-practices.html $SOURCES

The output will be in file metrics/rails-best-practices.html.

Most of the times, if you specify only a folder, many methods will be tagged as unused. Doublecheck before removing.

Flog

flog $SOURCES

The output will be on the terminal. The maximum allowed complexity is between 20/25.

Reek

reek -n -c $CONFIG $SOURCES

CONFIG is a YAML file (which documentation is here).

The output will be on the terminal.

Cane

cane --no-readme --no-doc --abc-glob $SOURCES/**/*.rb --style-glob $SOURCES/**/*.rb

The line length can be customized (--style-measure NUM).

The output will be on the terminal.

Flay

flay $SOURCES

The output will be on the terminal.

Roodi

mf-roodi -config=$CONFIG $SOURCES/**/*.rb

CONFIG is a YAML file.

The output will be on the terminal.

Contributing to metrics

• Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
• Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
• Fork the project.
• Start a feature/bugfix branch.
• Commit and push until you are happy with your contribution.
• Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
• Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (C) 2013 and above Shogun (shogun@cowtech.it).

Licensed under the MIT license, which can be found at http://www.openSOURCES.org/licenses/mit-license.php.