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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
# coding: utf-8
# Copyright 2019 DragonRuby LLC
# MIT License
# assert.rb has been released under MIT (*only this file*).
module GTK
=begin
This is a tiny assertion api for the unit testing portion of Game Toolkit.
@example
1. Create a file called tests.rb under mygame.
2. Any method that begins with the word test_ will be considered a test.
def test_this_works args, assert
assert.equal! 1, 1
end
3. To run a test, save the file while the game is running.
@example
To add an assertion open up this class and write:
class Assert
def custom_assertion actual, expected, message = nil
# this tells Game Toolkit that an assertion was performed (so that the test isn't marked inconclusive).
@assertion_performed = true
# perform your custom logic here and raise an exception to denote a failure.
raise "Some Error. #{message}."
end
end
=end
class Assert
attr :assertion_performed
=begin
Use this if you are throwing your own exceptions and you want to mark the tests as ran (so that it wont be marked as inconclusive).
=end
def ok!
@assertion_performed = true
end
=begin
Assert if a value is a truthy value. All assert methods take an optional final parameter that is the message to display to the user.
@example
def test_does_this_work args, assert
some_result = Person.new
assert.true! some_result
# OR
assert.true! some_result, "Person was not created."
end
=end
def true! value, message = nil
@assertion_performed = true
if !value
message = "#{value} was not truthy.\n#{message}"
raise "#{message}"
end
nil
end
=begin
Assert if a value is a falsey value.
@example
def test_does_this_work args, assert
some_result = nil
assert.false! some_result
end
=end
def false! value, message = nil
@assertion_performed = true
if value
message = "#{value} was not falsey.\n#{message}"
raise message
end
nil
end
=begin
Assert if two values are equal.
@example
def test_does_this_work args, assert
a = 1
b = 1
assert.equal! a, b
end
=end
def equal! actual, expected, message = nil
@assertion_performed = true
if actual != expected
actual_string = "#{actual}#{actual.nil? ? " (nil) " : " " }".strip
message = "actual:\n#{actual_string}\n\ndid not equal\n\nexpected:\n#{expected}\n#{message}"
raise message
end
nil
end
def not_equal! actual, expected, message = nil
@assertion_performed = true
if actual == expected
actual_string = "#{actual}#{actual.nil? ? " (nil) " : " " }".strip
message = "actual:\n#{actual_string}\n\nequaled\n\nexpected:\n#{expected}\n#{message}"
raise message
end
nil
end
=begin
Assert if a value is explicitly nil (not false).
@example
def test_does_this_work args, assert
a = nil
b = false
assert.nil! a # this will pass
assert.nil! b # this will throw an exception.
end
=end
def nil! value, message = nil
@assertion_performed = true
if !value.nil?
message = "#{value} was supposed to be nil, but wasn't.\n#{message}"
raise message
end
nil
end
end
end
|
