Contents

require 'ae/assertor'

module AE

  # Subjunctive
  #
  # Mixin for Assertor that provides additional English-eque verbage
  # such as 'be' and 'an'. This makes it easier to create assertor
  # methods of subjunctive terms like 'should'.
  #
  # @note THIS IS AN OPTIONAL LIBRARY.
  module Subjunctive

    # Like #assert, except if an argument is provided and no block,
    # uses #equate? to compare the argument to the receiver. This
    # allows for statements of the form:
    #
    #   5.should.be Numeric
    #
    def be(*args, &block)
      return self if args.empty? && !block
      block = args.shift if !block && ::Proc === args.first
      if block
        pass = block.arity > 0 ? block.call(@delegate) : block.call  #@delegate.instance_eval(&block)
        msg = args.shift || @message || block.inspect
      else
        pass = args.shift.equate?(@delegate)
        msg  = args.shift
      end
      __assert__(pass, msg)
    end

    # Alias of #be.
    #
    #   5.assert.is Numeric
    #
    alias_method :is  , :be
    alias_method :does, :be

    # The indefinite article is like #be, except that it compares a lone argument
    # with #case?, rather than #equate?
    #
    def a(*args, &block)
      return self if args.empty? && !block
      block = args.shift if !block && ::Proc === args.first
      if block
        pass = block.arity > 0 ? block.call(@delegate) : block.call  #@delegate.instance_eval(&block)
        msg = args.shift || @message || block.inspect
      else
        pass = (args.shift === @delegate) # case equality
        msg  = args.shift
      end
      __assert__(pass, msg)
    end

    alias_method :an, :a
  end

end#module AE

class AE::Assertor
  include ::AE::Subjunctive
end

# Copyright (c) 2008 Thomas Sawyer

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
ae-1.8.2	lib/ae/subjunctive.rb
ae-1.8.1	lib/ae/subjunctive.rb
ae-1.8.0	lib/ae/subjunctive.rb