1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
module AE
require 'ae/subjunctive'
# Must
#
# "It is not enough to succeed. Others must fail."
# --Gore Vidal (1925 - )
#
# @note THIS IS AN OPTIONAL LIBRARY.
module Must
# The #must method is functionaly the same as #should.
#
# @example
# 4.must == 3 #=> Assertion Error
#
# @example
# 4.must do
# self == 4
# end
#
# @return [Assertor] Assertion functor.
def must(*args, &block)
Assertor.new(self, :backtrace=>caller).be(*args, &block)
end
# Same as 'object.must == other'.
#
# @return [Assertor] Assertion functor.
def must=(cmp)
Assertor.new(self, :backtrace=>caller) == cmp
end
# Designate a negated expectation via a *functor*.
# Read this as "must not".
#
# @example
# 4.must! == 4 #=> Assertion Error
#
# @return [Assertor] Assertion functor.
def must!(*args, &block)
Assertor.new(self, :backtrace=>caller).not.be(*args, &block)
end
# TODO: Are these negation methods needed now, since Ruby 1.9 allows for
# redefining `!` as a method?
# Perhaps not literally the counter-term to *must* (rather *will*),
# but close enough for our purposes, and conveys the appropriate
# semantics.
alias_method :wont, :must!
# Alias for #must! method.
alias_method :must_not, :must!
# Alias for #must! method.
alias_method :mustnt, :must!
end
end
class ::Object #:nodoc:
include AE::Must
end
# Copyright (c) 2008 Thomas Sawyer
|
