com.google.common.truth

Class StreamSubject

java.lang.Object

com.google.common.truth.Subject<StreamSubject,java.util.stream.Stream<?>>

com.google.common.truth.StreamSubject

public final class StreamSubject
extends Subject<StreamSubject,java.util.stream.Stream<?>>

Propositions for Stream subjects.

Note: the wrapped stream will be drained immediately into a private collection to provide more readable failure messages. You should not use this class if you intend to leave the stream un-consumed or if the stream is very large or infinite.

If you intend to make multiple assertions on the same stream of data you should instead first collect the contents of the stream into a collection, and then assert directly on that.

For very large or infinite streams you may want to first limit the stream before asserting on it.

Author:

Kurt Alfred Kluever

Nested Class Summary

Nested classes/interfaces inherited from class com.google.common.truth.Subject

Subject.Factory<SubjectT extends Subject<SubjectT,ActualT>,ActualT>

Method Summary

Modifier and Type	Method and Description
protected String	actualCustomStringRepresentation() Supplies the direct string representation of the actual value to other methods which may prefix or otherwise position it in an error message.
void	contains(Object element) Fails if the subject does not contain the given element.
Ordered	containsAllIn(Iterable<?> expected) Fails if the subject does not contain all of the given elements.
Ordered	containsAllOf(Object first, Object second, Object... rest) Fails if the subject does not contain all of the given elements.
void	containsAnyIn(Iterable<?> expected) Fails if the subject does not contain at least one of the given elements.
void	containsAnyOf(Object first, Object second, Object... rest) Fails if the subject does not contain at least one of the given elements.
Ordered	containsExactly(Object... varargs) Fails if the subject does not contain exactly the given elements.
Ordered	containsExactlyElementsIn(Iterable<?> expected) Fails if the subject does not contain exactly the given elements.
void	containsNoDuplicates() Fails if the subject contains duplicate elements.
void	containsNoneIn(Iterable<?> excluded) Fails if the subject contains any of the given elements.
void	containsNoneOf(Object first, Object second, Object... rest) Fails if the subject contains any of the given elements.
void	doesNotContain(Object element) Fails if the subject contains the given element.
void	hasSize(int expectedSize) Fails if the subject does not have the given size.
void	isEmpty() Fails if the subject is not empty.
void	isNotEmpty() Fails if the subject is empty.
static Subject.Factory<StreamSubject,java.util.stream.Stream<?>>	streams()

Methods inherited from class com.google.common.truth.Subject

actual, actualAsString, check, check, equals, fail, fail, fail, failComparing, failComparing, failWithActual, failWithActual, failWithBadResults, failWithCustomSubject, failWithoutActual, failWithoutActual, failWithoutSubject, failWithRawMessage, failWithRawMessageAndCause, getSubject, hashCode, ignoreCheck, internalCustomName, isAnyOf, isEqualTo, isIn, isInstanceOf, isNoneOf, isNotEqualTo, isNotIn, isNotInstanceOf, isNotNull, isNotSameAs, isNull, isSameAs, named, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

actualCustomStringRepresentation

protected String actualCustomStringRepresentation()

Description copied from class: Subject

Supplies the direct string representation of the actual value to other methods which may prefix or otherwise position it in an error message. This should only be overridden to provide an improved string representation of the value under test, as it would appear in any given error message, and should not be used for additional prefixing.

Subjects should override this with care.

By default, this returns String.ValueOf(getActualValue()).

Overrides:

actualCustomStringRepresentation in class Subject<StreamSubject,java.util.stream.Stream<?>>

streams

public static Subject.Factory<StreamSubject,java.util.stream.Stream<?>> streams()

isEmpty

public void isEmpty()

Fails if the subject is not empty.

isNotEmpty

public void isNotEmpty()

Fails if the subject is empty.

hasSize

public void hasSize(int expectedSize)

Fails if the subject does not have the given size.

If you'd like to check that your stream contains more than Integer.MAX_VALUE elements, use assertThat(stream.count()).isEqualTo(...).

contains

public void contains(@NullableDecl
                     Object element)

Fails if the subject does not contain the given element.

doesNotContain

public void doesNotContain(@NullableDecl
                           Object element)

Fails if the subject contains the given element.

containsNoDuplicates

public void containsNoDuplicates()

Fails if the subject contains duplicate elements.

containsAnyOf

public void containsAnyOf(@NullableDecl
                          Object first,
                          @NullableDecl
                          Object second,
                          @NullableDecl
                          Object... rest)

Fails if the subject does not contain at least one of the given elements.

containsAnyIn

public void containsAnyIn(Iterable<?> expected)

Fails if the subject does not contain at least one of the given elements.

containsAllOf

@CanIgnoreReturnValue
public Ordered containsAllOf(@NullableDecl
                                                   Object first,
                                                   @NullableDecl
                                                   Object second,
                                                   @NullableDecl
                                                   Object... rest)

Fails if the subject does not contain all of the given elements. If an element appears more than once in the given elements, then it must appear at least that number of times in the actual elements.

To also test that the contents appear in the given order, make a call to inOrder() on the object returned by this method. The expected elements must appear in the given order within the actual elements, but they are not required to be consecutive.

containsAllIn

@CanIgnoreReturnValue
public Ordered containsAllIn(Iterable<?> expected)

Fails if the subject does not contain all of the given elements. If an element appears more than once in the given elements, then it must appear at least that number of times in the actual elements.

To also test that the contents appear in the given order, make a call to inOrder() on the object returned by this method. The expected elements must appear in the given order within the actual elements, but they are not required to be consecutive.

containsExactly

@CanIgnoreReturnValue
public Ordered containsExactly(@NullableDecl
                                                     Object... varargs)

Fails if the subject does not contain exactly the given elements.

Multiplicity is respected. For example, an object duplicated exactly 3 times in the parameters asserts that the object must likewise be duplicated exactly 3 times in the subject.

To also test that the contents appear in the given order, make a call to inOrder() on the object returned by this method.

containsExactlyElementsIn

@CanIgnoreReturnValue
public Ordered containsExactlyElementsIn(Iterable<?> expected)

Fails if the subject does not contain exactly the given elements.

Multiplicity is respected. For example, an object duplicated exactly 3 times in the parameters asserts that the object must likewise be duplicated exactly 3 times in the subject.

To also test that the contents appear in the given order, make a call to inOrder() on the object returned by this method.

containsNoneOf

public void containsNoneOf(@NullableDecl
                           Object first,
                           @NullableDecl
                           Object second,
                           @NullableDecl
                           Object... rest)

Fails if the subject contains any of the given elements. (Duplicates are irrelevant to this test, which fails if any of the actual elements equal any of the excluded.)

containsNoneIn

public void containsNoneIn(Iterable<?> excluded)

Fails if the subject contains any of the given elements. (Duplicates are irrelevant to this test, which fails if any of the actual elements equal any of the excluded.)