Module: Shoulda::Context::Assertions

Defined in:
lib/shoulda/context/assertions.rb

Instance Method Summary collapse

Instance Method Details

#assert_accepts(matcher, target, options = {}) ⇒ Object

Asserts that the given matcher returns true when target is passed to #matches?


49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# File 'lib/shoulda/context/assertions.rb', line 49

def assert_accepts(matcher, target, options = {})
  if matcher.respond_to?(:in_context)
    matcher.in_context(self)
  end

  if matcher.matches?(target)
    safe_assert_block { true }
    if options[:message]
      message = matcher.respond_to?(:failure_message_for_should_not) ? matcher.failure_message_for_should_not : matcher.negative_failure_message
      assert_match options[:message], message
    end
  else
    message = matcher.respond_to?(:failure_message_for_should) ? matcher.failure_message_for_should : matcher.failure_message
    safe_assert_block(message) { false }
  end
end

#assert_contains(collection, x, extra_msg = "") ⇒ Object

Asserts that the given collection contains item x. If x is a regular expression, ensure that at least one element from the collection matches x. extra_msg is appended to the error message if the assertion fails.

assert_contains(['a', '1'], /\d/) => passes
assert_contains(['a', '1'], 'a') => passes
assert_contains(['a', '1'], /not there/) => fails

24
25
26
27
28
29
30
31
32
33
# File 'lib/shoulda/context/assertions.rb', line 24

def assert_contains(collection, x, extra_msg = "")
  collection = Array(collection)
  msg = "#{x.inspect} not found in #{collection.to_a.inspect} #{extra_msg}"
  case x
  when Regexp
    assert(collection.detect { |e| e =~ x }, msg)
  else
    assert(collection.include?(x), msg)
  end
end

#assert_does_not_contain(collection, x, extra_msg = "") ⇒ Object

Asserts that the given collection does not contain item x. If x is a regular expression, ensure that none of the elements from the collection match x.


37
38
39
40
41
42
43
44
45
46
# File 'lib/shoulda/context/assertions.rb', line 37

def assert_does_not_contain(collection, x, extra_msg = "")
  collection = Array(collection)
  msg = "#{x.inspect} found in #{collection.to_a.inspect} " + extra_msg
  case x
  when Regexp
    assert(!collection.detect { |e| e =~ x }, msg)
  else
    assert(!collection.include?(x), msg)
  end
end

#assert_rejects(matcher, target, options = {}) ⇒ Object

Asserts that the given matcher returns true when target is passed to #does_not_match? or false when target is passed to #matches? if #does_not_match? is not implemented


68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
# File 'lib/shoulda/context/assertions.rb', line 68

def assert_rejects(matcher, target, options = {})
  if matcher.respond_to?(:in_context)
    matcher.in_context(self)
  end

  not_match = matcher.respond_to?(:does_not_match?) ? matcher.does_not_match?(target) : !matcher.matches?(target)

  if not_match
    safe_assert_block { true }
    if options[:message]
      message = matcher.respond_to?(:failure_message_for_should) ? matcher.failure_message_for_should : matcher.failure_message
      assert_match options[:message], message
    end
  else
    message = matcher.respond_to?(:failure_message_for_should_not) ? matcher.failure_message_for_should_not : matcher.negative_failure_message
    safe_assert_block(message) { false }
  end
end

#assert_same_elements(a1, a2, msg = nil) ⇒ Object

Asserts that two arrays contain the same elements, the same number of times. Essentially ==, but unordered.

assert_same_elements([:a, :b, :c], [:c, :a, :b]) => passes

7
8
9
10
11
12
13
14
15
16
# File 'lib/shoulda/context/assertions.rb', line 7

def assert_same_elements(a1, a2, msg = nil)
  [:select, :inject, :size].each do |m|
    [a1, a2].each {|a| assert_respond_to(a, m, "Are you sure that #{a.inspect} is an array?  It doesn't respond to #{m}.") }
  end

  assert a1h = a1.inject({}) { |h,e| h[e] ||= a1.select { |i| i == e }.size; h }
  assert a2h = a2.inject({}) { |h,e| h[e] ||= a2.select { |i| i == e }.size; h }

  assert_equal(a1h, a2h, msg)
end

#safe_assert_block(message = "assert_block failed.", &block) ⇒ Object


87
88
89
90
91
92
93
# File 'lib/shoulda/context/assertions.rb', line 87

def safe_assert_block(message = "assert_block failed.", &block)
  if respond_to?(:assert_block)
    assert_block message, &block
  else
    assert yield, message
  end
end