shard-spectator/src/spectator/result.cr

module Spectator
  # Base class that represents the outcome of running an example.
  # Sub-classes contain additional information specific to the type of result.
  abstract class Result
    # Example that was run that this result is for.
    getter example : Example

    # Constructs the base of the result.
    # The *example* should refer to the example that was run
    # and that this result is for.
    def initialize(@example)
    end

    # Calls the corresponding method for the type of result.
    # This is used to avoid placing if or case-statements everywhere based on type.
    # Each sub-class implements this method by calling the correct method on *interface*.
    abstract def call(interface)

    # Calls the corresponding method for the type of result.
    # This is used to avoid placing if or case-statements everywhere based on type.
    # Each sub-class implements this method by calling the correct method on *interface*.
    # This variation takes a block, which is passed the result.
    # The value returned from the block will be returned by this method.
    abstract def call(interface, &block : Result -> _)
  end
end