Ruby Tests Profiling Toolbox

TestProf is a collection of different tools to analyze your test suite performance.

Why does test suite performance matter? First of all, testing is a part of a developer's feedback loop (see @searls talk) and, secondly, it is a part of a deployment cycle.

Simply speaking, slow tests waste your time making you less productive.

TestProf toolbox aims to help you identify bottlenecks in your test suite. It contains:

• Plug'n'Play integrations for general Ruby profilers (ruby-prof, stackprof)

• Factories usage analyzers and profilers

• ActiveSupport-backed profilers

• RuboCop cops

• etc.

Of course, we have some solutions for common performance issues too, bundled into the gem.

See Table of Contents for more.

Supported Ruby versions:

• Ruby (MRI) >= 2.2.0

• JRuby >= 9.1.0.0

Resources

• RailsClub, Moscow, 2017, "Faster Tests" talk [video (RU), slides]

• TestProf: a good doctor for slow Ruby tests

• RubyConfBy, 2017, "Run Test Run" talk [video, slides]

• Tips to improve speed of your test suite by Benoit Tigeot

Installation

Add test-prof gem to your application:

group :test do
  gem 'test-prof'
end

And that's it)

Table of Contents

Checkout our guides for each specific tool:

• RubyProf Integration

• StackProf Integration

• Event Profiler (e.g. ActiveSupport notifications)

• Tag Profiler

• Factory Doctor

• Factory Profiler

• RSpecDissect Profiler

• RuboCop cops

Tips and Tricks (or Recipes)

We also want to share some small code tricks which can help you to improve your test suite performance and efficiency:

• before_all Hook

• let_it_be Helper

• AnyFixture

• FactoryDefault

• RSpec Stamp

• Tests Sampling

Configuration

TestProf global configuration is used by most of the profilers:

TestProf.configure do |config|
  # the directory to put artifacts (reports) in ("tmp/test_prof" by default)
  config.output_dir = "tmp/test_prof"

  # use unique filenames for reports (by simply appending current timestamp)
  config.timestamps = true

  # color output
  config.color = true
end

What's next?

Have an idea? Propose a feature request!

License

The gem is available as open source under the terms of the MIT License.