Class: RSpec::Core::Example::ExecutionResult

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

Overview

Represents the result of executing an example. Behaves like a hash for backwards compatibility.

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#exceptionException?

Returns The failure, if there was one.

Returns:

  • (Exception, nil)

    The failure, if there was one.



469
470
471
# File 'lib/rspec/core/example.rb', line 469

def exception
  @exception
end

#finished_atTime

Returns When the example finished.

Returns:

  • (Time)

    When the example finished.



475
476
477
# File 'lib/rspec/core/example.rb', line 475

def finished_at
  @finished_at
end

#pending_exceptionException?

Returns The exception triggered while executing the pending example. If no exception was triggered it would no longer get a status of :pending unless it was tagged with :skip.

Returns:

  • (Exception, nil)

    The exception triggered while executing the pending example. If no exception was triggered it would no longer get a status of :pending unless it was tagged with :skip.



488
489
490
# File 'lib/rspec/core/example.rb', line 488

def pending_exception
  @pending_exception
end

#pending_fixedBoolean Also known as: pending_fixed?

Returns For examples tagged with :pending, this indicates whether or not it now passes.

Returns:

  • (Boolean)

    For examples tagged with :pending, this indicates whether or not it now passes.



492
493
494
# File 'lib/rspec/core/example.rb', line 492

def pending_fixed
  @pending_fixed
end

#pending_messageString?

Returns The reason the example was pending, or nil if the example was not pending.

Returns:

  • (String, nil)

    The reason the example was pending, or nil if the example was not pending.



482
483
484
# File 'lib/rspec/core/example.rb', line 482

def pending_message
  @pending_message
end

#run_timeFloat

Returns How long the example took in seconds.

Returns:

  • (Float)

    How long the example took in seconds.



478
479
480
# File 'lib/rspec/core/example.rb', line 478

def run_time
  @run_time
end

#started_atTime

Returns When the example started.

Returns:

  • (Time)

    When the example started.



472
473
474
# File 'lib/rspec/core/example.rb', line 472

def started_at
  @started_at
end

#statusSymbol

Returns :passed, :failed or :pending.

Returns:

  • (Symbol)

    :passed, :failed or :pending.



466
467
468
# File 'lib/rspec/core/example.rb', line 466

def status
  @status
end

Instance Method Details

#example_skipped?Boolean

Returns Indicates if the example was completely skipped (typically done via :skip metadata or the skip method). Skipped examples will have a :pending result. A :pending result can also come from examples that were marked as :pending, which causes them to be run, and produces a :failed result if the example passes.

Returns:

  • (Boolean)

    Indicates if the example was completely skipped (typically done via :skip metadata or the skip method). Skipped examples will have a :pending result. A :pending result can also come from examples that were marked as :pending, which causes them to be run, and produces a :failed result if the example passes.



501
502
503
# File 'lib/rspec/core/example.rb', line 501

def example_skipped?
  status == :pending && !pending_exception
end

#record_finished(status, finished_at) ⇒ void

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Records the finished status of the example.



507
508
509
510
511
# File 'lib/rspec/core/example.rb', line 507

def record_finished(status, finished_at)
  self.status      = status
  self.finished_at = finished_at
  self.run_time    = (finished_at - started_at).to_f
end