Quality -- code quality ratchet for Ruby
Quality is a tool that runs quality checks on code in git repos using different analysis tools and makes sure your numbers don't get any worse over time.
Quality makes use of the following other tools, which do the actual checking:
How to use - using Docker
See DOCKER.md for info.
How to use - as part of a Ruby-based Rakefile
pip install flake8 brew install cmake icu4c shellcheck scalastyle # macOS gem install quality
or in your Gemfile:
group :development do gem 'quality' end
Once you have the gem, configure your Rakefile like this:
require 'quality/rake/task' Quality::Rake::Task.new
If you're using Rails, you must check your environment in your Rakefile.
if Rails.env.development? require 'quality/rake/task' Quality::Rake::Task.new end
If you want to ratchet up the quality and force yourself to improve code, run:
To help better understand which warnings came from your current set of changes, consider using Pronto, which provides incremental reporting from different quality tools, and can add comments directly to PR reviews. You can see an example in this project's Rakefile
Quality uses GitHub's linguist
gem to find and classify source files to analyze. In addition to
options in Quality, you can refer to
Linguists's documentation on overrides
to use the
gitattributes file to mark files as vendored, at which point
Quality will not try to analyze them.
You can pull a similar trick with code coverage using SimpleCov in Ruby--put 'simplecov' in your Gemfile, and add the code below into your test_helper.rb or spec_helper.rb.
require 'simplecov' SimpleCov.start SimpleCov.refuse_coverage_drop
After your first run, check in your coverage/.last_run.json.
bundle config build.charlock_holmes --with-cxxflags=-std=c++11 --with-icu-dir=/usr/local/opt/icu4c
Quality uses semantic versioning--any incompatible changes (including new tools being added) will come out as major number updates.
This includes RuboCop upgrades - the quality gem locks in a specific minor version of RuboCop to avoid your metrics being bumped and breaking your build.
Expect your build to break on major upgrades if you use RuboCop.
Supported Ruby Versions
Tested against Ruby >=2.2--does not support Ruby 1.9.x or JRuby.
- Fork the repo
- Create a feature branch
- Submit a github pull request
Many thanks to all contributors, especially @andyw8, who has contributed some great improvements.
Licensed under the MIT license.