Class: RSpec::Core::Formatters::Protocol

Inherits:
Object
  • Object
show all
Defined in:
lib/rspec/core/formatters/protocol.rb

Overview

This class isn't loaded at runtime but serves to document all of the notifications implemented as part of the standard interface. The reporter will issue these during a normal test suite run, but a formatter will only receive those notifications it has registered itself to receive. To register a formatter call:

::RSpec::Core::Formatters.register class, :list, :of, :notifications

e.g.

::RSpec::Core::Formatters.register self, :start, :example_started

Suite Notifications collapse

Group Notifications collapse

Example Notifications collapse

Instance Method Summary collapse

Constructor Details

#initializevoid



# File 'lib/rspec/core/formatters/protocol.rb', line 20

Instance Method Details

#closevoid

Invoked at the very end, close allows the formatter to clean up resources, e.g. open streams, etc.



# File 'lib/rspec/core/formatters/protocol.rb', line 169

#dump_failuresvoid

Dumps detailed information about each example failure.



# File 'lib/rspec/core/formatters/protocol.rb', line 124

#dump_pendingvoid

Outputs a report of pending examples. This gets invoked after the summary if option is set to do so.



# File 'lib/rspec/core/formatters/protocol.rb', line 152

#dump_profilevoid

This method is invoked after the dumping the summary if profiling is enabled.



# File 'lib/rspec/core/formatters/protocol.rb', line 142

#dump_summaryvoid

This method is invoked after the dumping of examples and failures. Each parameter is assigned to a corresponding attribute.



# File 'lib/rspec/core/formatters/protocol.rb', line 132

#example_failedvoid

Invoked when an example fails.



# File 'lib/rspec/core/formatters/protocol.rb', line 87

#example_group_finishedvoid

Invoked at the end of the execution of each example group.



# File 'lib/rspec/core/formatters/protocol.rb', line 51

#example_group_startedvoid

This method is invoked at the beginning of the execution of each example group.

The next method to be invoked after this is #example_passed, #example_pending, or #example_group_finished.



# File 'lib/rspec/core/formatters/protocol.rb', line 38

#example_passedvoid

Invoked when an example passes.



# File 'lib/rspec/core/formatters/protocol.rb', line 69

#example_pendingvoid

Invoked when an example is pending.



# File 'lib/rspec/core/formatters/protocol.rb', line 78

#example_startedvoid

Invoked at the beginning of the execution of each example.



# File 'lib/rspec/core/formatters/protocol.rb', line 60

#messagevoid

Used by the reporter to send messages to the output stream.



# File 'lib/rspec/core/formatters/protocol.rb', line 96

#startvoid

This method is invoked before any examples are run, right after they have all been collected. This can be useful for special formatters that need to provide progress on feedback (graphical ones).

This will only be invoked once, and the next one to be invoked is #example_group_started.



# File 'lib/rspec/core/formatters/protocol.rb', line 25

#start_dumpvoid

This method is invoked after all of the examples have executed. The next method to be invoked after this one is #dump_failures (BaseTextFormatter then calls #dump_failures once for each failed example).



# File 'lib/rspec/core/formatters/protocol.rb', line 113

#stopvoid

Invoked after all examples have executed, before dumping post-run reports.



# File 'lib/rspec/core/formatters/protocol.rb', line 104