module TestTube

@param isolate [Boolean] Compute in a subprocess. @param matcher [#matches?] A matcher. @param negate [Boolean] Invert the matcher or not. @param input [Proc] The callable object to test.

@example

require "test_tube"

class BeTheAnswer
  def matches?
    42.equal?(yield)
  end
end

TestTube.invoke(isolate: false, matcher: BeTheAnswer.new, negate: false) do
  "101010".to_i(2)
end

@return [Invoker] A software experiment.

# File lib/test_tube.rb, line 29
def self.invoke(isolate:, matcher:, negate:, &input)
  Invoker.new(isolate: isolate, matcher: matcher, negate: negate, &input)
end

@param input [#object_id] The actual value to test. @param matcher [#matches?] A matcher. @param negate [Boolean] Invert the matcher or not.

@example

require "test_tube"

class BeTheAnswer
  def matches?
    42.equal?(yield)
  end
end

TestTube.pass("101010".to_i(2),
  matcher: BeTheAnswer.new,
  negate: false
)

@return [Passer] A software experiment.

# File lib/test_tube.rb, line 52
def self.pass(input, matcher:, negate:)
  Passer.new(input, matcher: matcher, negate: negate)
end