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
|
require "test/unit"
require "test/unit/ui/console/testrunner"
# You can test whether an object is compliant with the ActiveModel API by
# calling ActiveModel::Compliance.test(object). It will emit a Test::Unit
# output that tells you whether your object is fully compliant, or if not,
# which aspects of the API are not implemented.
#
# These tests do not attempt to determine the semantic correctness of the
# returned values. For instance, you could implement valid? to always
# return true, and the tests would pass. It is up to you to ensure that
# the values are semantically meaningful.
#
# Objects you pass in are expected to return a compliant object from a
# call to to_model. It is perfectly fine for to_model to return self.
module ActiveModel
module Lint
def self.test(object, verbosity = 2, output = STDOUT)
test_class = Class.new(::Test::Unit::TestCase) do
include Test
define_method(:setup) do
assert object.respond_to?(:to_model), "The object should respond_to :to_model"
@object = object.to_model
super
end
end
::Test::Unit::UI::Console::TestRunner.new(test_class, verbosity, output).start
end
module Test
def assert_boolean(name, result)
assert result == true || result == false, "#{name} should be a boolean"
end
# valid?
# ------
#
# Returns a boolean that specifies whether the object is in a valid or invalid
# state.
def test_valid?
assert @object.respond_to?(:valid?), "The model should respond to valid?"
assert_boolean "valid?", @object.valid?
end
# new_record?
# -----------
#
# Returns a boolean that specifies whether the object has been persisted yet.
# This is used when calculating the URL for an object. If the object is
# not persisted, a form for that object, for instance, will be POSTed to the
# collection. If it is persisted, a form for the object will put PUTed to the
# URL for the object.
def test_new_record?
assert @object.respond_to?(:new_record?), "The model should respond to new_record?"
assert_boolean "new_record?", @object.new_record?
end
def test_destroyed?
assert @object.respond_to?(:new_record?), "The model should respond to destroyed?"
assert_boolean "destroyed?", @object.destroyed?
end
# errors
# ------
#
# Returns an object that has :[] and :full_messages defined on it. See below
# for more details.
def setup
assert @object.respond_to?(:errors), "The model should respond to errors"
@errors = @object.errors
end
# This module tests the #errors object
module Errors
# Returns an Array of Strings that are the errors for the attribute in
# question. If localization is used, the Strings should be localized
# for the current locale. If no error is present, this method should
# return an empty Array.
def test_errors_aref
assert @errors[:hello].is_a?(Array), "errors#[] should return an Array"
end
# Returns an Array of all error messages for the object. Each message
# should contain information about the field, if applicable.
def test_errors_full_messages
assert @errors.full_messages.is_a?(Array), "errors#full_messages should return an Array"
end
end
include Errors
end
end
end
|
