Module: TestProf::EventProf

Defined in:
lib/test_prof/event_prof.rb,
lib/test_prof/event_prof/rspec.rb,
lib/test_prof/event_prof/monitor.rb,
lib/test_prof/event_prof/profiler.rb,
lib/test_prof/event_prof/custom_events.rb,
lib/test_prof/event_prof/instrumentations/active_support.rb

Overview

EventProf profiles your tests and suites against custom events, such as ActiveSupport::Notifacations.

It works very similar to ‘rspec –profile` but can track arbitrary events.

Example:

# Collect SQL queries stats for every suite and example
EVENT_PROF='sql.active_record' rspec ...

By default it collects information only about top-level groups (aka suites), but you can also profile individual examples. Just set the configuration option:

TestProf::EventProf.configure do |config|
  config.per_example = true
end

Or provide the EVENT_PROF_EXAMPLES=1 env variable.

Defined Under Namespace

Modules: CustomEvents, Instrumentations, Monitor Classes: Configuration, Profiler, ProfilersGroup, RSpecListener

Class Method Summary collapse

Class Method Details

.build(event = config.event) ⇒ Object

Returns new configured instance of profilers group



79
80
81
82
83
84
85
86
87
 
# File 'lib/test_prof/event_prof.rb', line 79

def build(event = config.event)
  ProfilersGroup.new(
    event: event,
    instrumenter: instrumenter,
    rank_by: config.rank_by,
    top_count: config.top_count,
    per_example: config.per_example?
  )
end

.config ⇒ Object 



70
71
72
 
# File 'lib/test_prof/event_prof.rb', line 70

def config
  @config ||= Configuration.new
end

.configure {|config| ... } ⇒ Object

Yields:



74
75
76
 
# File 'lib/test_prof/event_prof.rb', line 74

def configure
  yield config
end

.instrumenter ⇒ Object 



89
90
91
 
# File 'lib/test_prof/event_prof.rb', line 89

def instrumenter
  @instrumenter ||= config.resolve_instrumenter
end

.monitor(mod, event, *mids) ⇒ Object

Instrument specified module methods. Wraps them with ‘instrumenter.instrument(event) { … }`.

Use it to profile arbitrary methods:

TestProf::EventProf.monitor(MyModule, "my_module.call", :call)



99
100
101
 
# File 'lib/test_prof/event_prof.rb', line 99

def monitor(mod, event, *mids)
  Monitor.call(mod, event, *mids)
end