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
|
/*
* Copyright (c) 2014 Google, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.common.truth;
import com.google.common.collect.Range;
import org.checkerframework.checker.nullness.qual.Nullable;
/**
* Propositions for {@link Comparable} typed subjects.
*
* @author Kurt Alfred Kluever
* @param <T> the type of the object being tested by this {@code ComparableSubject}
*/
public abstract class ComparableSubject<T extends Comparable> extends Subject {
/**
* Constructor for use by subclasses. If you want to create an instance of this class itself, call
* {@link Subject#check(String, Object...) check(...)}{@code .that(actual)}.
*/
private final T actual;
protected ComparableSubject(FailureMetadata metadata, @Nullable T actual) {
super(metadata, actual);
this.actual = actual;
}
/** Checks that the subject is in {@code range}. */
public final void isIn(Range<T> range) {
if (!range.contains(actual)) {
failWithActual("expected to be in range", range);
}
}
/** Checks that the subject is <i>not</i> in {@code range}. */
public final void isNotIn(Range<T> range) {
if (range.contains(actual)) {
failWithActual("expected not to be in range", range);
}
}
/**
* Checks that the subject is equivalent to {@code other} according to {@link
* Comparable#compareTo}, (i.e., checks that {@code a.comparesTo(b) == 0}).
*
* <p><b>Note:</b> Do not use this method for checking object equality. Instead, use {@link
* #isEqualTo(Object)}.
*/
public void isEquivalentAccordingToCompareTo(T expected) {
if (actual.compareTo(expected) != 0) {
failWithActual("expected value that sorts equal to", expected);
}
}
/**
* Checks that the subject is greater than {@code other}.
*
* <p>To check that the subject is greater than <i>or equal to</i> {@code other}, use {@link
* #isAtLeast}.
*/
public final void isGreaterThan(T other) {
if (actual.compareTo(other) <= 0) {
failWithActual("expected to be greater than", other);
}
}
/**
* Checks that the subject is less than {@code other}.
*
* <p>To check that the subject is less than <i>or equal to</i> {@code other}, use {@link
* #isAtMost}.
*/
public final void isLessThan(T other) {
if (actual.compareTo(other) >= 0) {
failWithActual("expected to be less than", other);
}
}
/**
* Checks that the subject is less than or equal to {@code other}.
*
* <p>To check that the subject is <i>strictly</i> less than {@code other}, use {@link
* #isLessThan}.
*/
public final void isAtMost(T other) {
if (actual.compareTo(other) > 0) {
failWithActual("expected to be at most", other);
}
}
/**
* Checks that the subject is greater than or equal to {@code other}.
*
* <p>To check that the subject is <i>strictly</i> greater than {@code other}, use {@link
* #isGreaterThan}.
*/
public final void isAtLeast(T other) {
if (actual.compareTo(other) < 0) {
failWithActual("expected to be at least", other);
}
}
}
|
