Deprecated API

Contents

• Deprecated Methods

Deprecated Methods

Method and Description
com.google.common.truth.ComparableSubject.comparesEqualTo(T) Use ComparableSubject.isEquivalentAccordingToCompareTo(T) instead.
com.google.common.truth.Correspondence.equals(Object) Object.equals(Object) is not supported. If you meant to compare objects using this Correspondence, use Correspondence.compare(A, E).
com.google.common.truth.FloatSubject.TolerantFloatComparison.equals(Object) Object.equals(Object) is not supported on TolerantFloatComparison. If you meant to compare floats, use FloatSubject.TolerantFloatComparison.of(float) instead.
com.google.common.truth.PrimitiveDoubleArraySubject.TolerantPrimitiveDoubleArrayComparison.equals(Object) Object.equals(Object) is not supported on TolerantPrimitiveDoubleArrayComparison. If you meant to compare double arrays, use PrimitiveDoubleArraySubject.TolerantPrimitiveDoubleArrayComparison.of(double...) or PrimitiveDoubleArraySubject.TolerantPrimitiveDoubleArrayComparison.ofElementsIn(java.lang.Iterable<? extends java.lang.Number>) instead.
com.google.common.truth.Subject.equals(Object) Object.equals(Object) is not supported on Truth subjects. If you meant to test object equality between an expected and the actual value, use Subject.isEqualTo(Object) instead.
com.google.common.truth.DoubleSubject.TolerantDoubleComparison.equals(Object) Object.equals(Object) is not supported on TolerantDoubleComparison. If you meant to compare doubles, use DoubleSubject.TolerantDoubleComparison.of(double) instead.
com.google.common.truth.PrimitiveFloatArraySubject.TolerantPrimitiveFloatArrayComparison.equals(Object) Object.equals(Object) is not supported on TolerantPrimitiveFloatArrayComparison. If you meant to compare float arrays, use PrimitiveFloatArraySubject.TolerantPrimitiveFloatArrayComparison.of(float...) or PrimitiveFloatArraySubject.TolerantPrimitiveFloatArrayComparison.ofElementsIn(java.lang.Iterable<? extends java.lang.Number>) instead.
com.google.common.truth.Subject.fail(String) Prefer to construct Fact-style methods, typically by using failWithActual(simpleFact(...)). However, if you want to preserve your exact failure message as a migration aid, you can inline this method (and then inline the resulting method call, as well).
com.google.common.truth.Subject.fail(String, Object...) Prefer to construct Fact-style methods, typically by using Subject.failWithActual(Fact, Fact...). However, if you want to preserve your exact failure message as a migration aid, you can inline this method.
com.google.common.truth.Subject.fail(String, Object) Prefer to construct Fact-style methods, typically by using Subject.failWithActual(String, Object). However, if you want to preserve your exact failure message as a migration aid, you can inline this method (and then inline the resulting method call, as well).
com.google.common.truth.Subject.failWithBadResults(String, Object, String, Object) Prefer to construct Fact-style methods, typically by using Subject.failWithActual(Fact, Fact...). However, if you want to preserve your exact failure message as a migration aid, you can inline this method.
com.google.common.truth.Subject.failWithCustomSubject(String, Object, Object) Prefer to construct Fact-style methods, typically by using Subject.failWithoutActual(Fact, Fact...). However, if you want to preserve your exact failure message as a migration aid, you can inline this method.
com.google.common.truth.Subject.failWithoutActual(String) Prefer to construct Fact-style methods, typically by using failWithoutActual(simpleFact(...)). However, if you want to preserve your exact failure message as a migration aid, you can inline this method (and then inline the resulting method call, as well).
com.google.common.truth.Subject.failWithoutSubject(String) Prefer to construct Fact-style methods, typically by using failWithoutActual(simpleFact(...)). However, if you want to preserve your exact failure message as a migration aid, you can inline this method.
com.google.common.truth.Subject.getSubject() Prefer #actual() for direct access to the subject.
com.google.common.truth.Correspondence.hashCode() Object.hashCode() is not supported.
com.google.common.truth.FloatSubject.TolerantFloatComparison.hashCode() Object.hashCode() is not supported on TolerantFloatComparison
com.google.common.truth.PrimitiveDoubleArraySubject.TolerantPrimitiveDoubleArrayComparison.hashCode() Object.hashCode() is not supported on TolerantPrimitiveDoubleArrayComparison
com.google.common.truth.Subject.hashCode() Object.hashCode() is not supported on Truth subjects.
com.google.common.truth.DoubleSubject.TolerantDoubleComparison.hashCode() Object.hashCode() is not supported on TolerantDoubleComparison
com.google.common.truth.PrimitiveFloatArraySubject.TolerantPrimitiveFloatArrayComparison.hashCode() Object.hashCode() is not supported on TolerantPrimitiveFloatArrayComparison
com.google.common.truth.ThrowableSubject.hasMessage(String) Use hasMessageThat().isEqualTo(expected) instead. You may also consider using inexact matching of the message (e.g. hasMessageThat().contains(substring)) for less brittle tests.
com.google.common.truth.PrimitiveDoubleArraySubject.hasValuesNotWithin(double) Write a for loop over the values looking for mismatches (see this implementation for an example)
com.google.common.truth.PrimitiveFloatArraySubject.hasValuesNotWithin(float) Write a for loop over the values looking for mismatches (see this implementation for an example)
com.google.common.truth.PrimitiveDoubleArraySubject.hasValuesWithin(double) Use PrimitiveDoubleArraySubject.usingTolerance(double), e.g. assertThat(doubleArray).usingTolerance(1e-5).containsExactly(1.2, 3.4, 5.6).inOrder();
com.google.common.truth.PrimitiveFloatArraySubject.hasValuesWithin(float) Use PrimitiveFloatArraySubject.usingTolerance(double), e.g. assertThat(floatArray).usingTolerance(1e-5).containsExactly(1.2f, 3.4f, 5.6f).inOrder();
com.google.common.truth.SetMultimapSubject.isEqualTo(ListMultimap<?, ?>) A ListMultimap can never compare equal with a SetMultimap if either Multimap is non-empty, because List and Set can never compare equal. Prefer MultimapSubject.containsExactlyEntriesIn(com.google.common.collect.Multimap) instead. Consult Multimap.equals(java.lang.Object) for more information.
com.google.common.truth.AtomicLongMapSubject.isEqualTo(Object) AtomicLongMap does not define equality (i.e., it does not implement equals()), so you probably don't want to call this method. Instead, perform your assertion on the map view (e.g., assertThat(atomicLongMap.asMap()).isEqualTo(EXPECTED_MAP)).
com.google.common.truth.ListMultimapSubject.isEqualTo(SetMultimap<?, ?>) A SetMultimap can never compare equal with a ListMultimap if either Multimap is non-empty, because Set and List can never compare equal. Prefer MultimapSubject.containsExactlyEntriesIn(com.google.common.collect.Multimap) instead. Consult Multimap.equals(java.lang.Object) for more information.
com.google.common.truth.DoubleSubject.isEquivalentAccordingToCompareTo(Double) Use DoubleSubject.isWithin(double) or DoubleSubject.isEqualTo(java.lang.Double) instead (see documentation for advice).
com.google.common.truth.FloatSubject.isEquivalentAccordingToCompareTo(Float) Use FloatSubject.isWithin(float) or FloatSubject.isEqualTo(java.lang.Float) instead (see documentation for advice).
com.google.common.truth.IntegerSubject.isEquivalentAccordingToCompareTo(Integer) Use Subject.isEqualTo(java.lang.Object) instead. Integer comparison is consistent with equality.
com.google.common.truth.LongSubject.isEquivalentAccordingToCompareTo(Long) Use Subject.isEqualTo(java.lang.Object) instead. Long comparison is consistent with equality.
com.google.common.truth.StringSubject.isEquivalentAccordingToCompareTo(String) Use Subject.isEqualTo(java.lang.Object) instead. String comparison is consistent with equality.
com.google.common.truth.IterableSubject.isNoneOf(Object, Object, Object...) You probably meant to call IterableSubject.containsNoneOf(java.lang.Object, java.lang.Object, java.lang.Object...) instead.
com.google.common.truth.AtomicLongMapSubject.isNotEqualTo(Object) AtomicLongMap does not define equality (i.e., it does not implement equals()), so you probably don't want to call this method. Instead, perform your assertion on the map view (e.g., assertThat(atomicLongMap.asMap()).isNotEqualTo(UNEXPECTED_MAP)).
com.google.common.truth.IterableSubject.isNotIn(Iterable<?>) You probably meant to call IterableSubject.containsNoneIn(java.lang.Iterable<?>) instead.