Package com.google.common.truth
Class Expect
- java.lang.Object
-
- com.google.common.truth.StandardSubjectBuilder
-
- com.google.common.truth.Expect
-
- All Implemented Interfaces:
org.junit.rules.TestRule
public final class Expect extends StandardSubjectBuilder implements org.junit.rules.TestRule
ATestRule
that batches up all failures encountered during a test, and reports them all together at the end (similar toErrorCollector
). It is also useful for making assertions from other threads or from within callbacks whose exceptions would be swallowed or logged, rather than propagated out to fail the test. (AssertJ has a similar feature called "soft assertions"; however, soft assertions are not safe for concurrent use.)Usage:
@Rule public final Expect expect = Expect.create();
...
expect.that(results).containsExactly(...);
expect.that(errors).isEmpty();
Expect
may be used concurrently from multiple threads. Note, however, thatExpect
has no way of knowing when all your other test threads are done. It simply checks for failures when the main thread finishes executing the test method. Thus, you must ensure that any background threads complete their assertions before then, or your test may ignore their results.To record failures for the purpose of testing that an assertion fails when it should, see
ExpectFailure
.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description private static class
Expect.ExpectationGatherer
(package private) static class
Expect.TestPhase
-
Field Summary
Fields Modifier and Type Field Description private Expect.ExpectationGatherer
gatherer
-
Constructor Summary
Constructors Modifier Constructor Description private
Expect(Expect.ExpectationGatherer gatherer)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description org.junit.runners.model.Statement
apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
(package private) void
checkStatePreconditions()
Extension point invoked before every assertion.static Expect
create()
Creates a new instance.boolean
hasFailures()
-
Methods inherited from class com.google.common.truth.StandardSubjectBuilder
about, about, fail, forCustomFailureStrategy, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, withMessage, withMessage
-
-
-
-
Field Detail
-
gatherer
private final Expect.ExpectationGatherer gatherer
-
-
Constructor Detail
-
Expect
private Expect(Expect.ExpectationGatherer gatherer)
-
-
Method Detail
-
create
public static Expect create()
Creates a new instance.
-
hasFailures
public boolean hasFailures()
-
checkStatePreconditions
void checkStatePreconditions()
Description copied from class:StandardSubjectBuilder
Extension point invoked before every assertion. This allowsExpect
to check that it's been set up properly as aTestRule
.- Overrides:
checkStatePreconditions
in classStandardSubjectBuilder
-
apply
public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
- Specified by:
apply
in interfaceorg.junit.rules.TestRule
-
-