Assertions (AssertJ fluent assertions 2.5.0 API)

java.lang.Object
- org.assertj.core.api.Assertions

Direct Known Subclasses:

BDDAssertions
```
public class Assertions
extends Object
```
Entry point for assertion methods for different data types. Each method in this class is a static factory for the type-specific assertion objects. The purpose of this class is to make test code more readable.
For example:
```
 int removed = employees.removeFired();
 assertThat(removed).isZero();

 List<Employee> newEmployees = employees.hired(TODAY);
 assertThat(newEmployees).hasSize(6);
```
Author:

Alex Ruiz, Yvonne Wang, David DIDIER, Ted Young, Joel Costigliola, Matthieu Baechler, Mikhail Mazursky, Nicolas François, Julien Meddah, William Delanoue, Turbo87, dorzey

Constructor Summary

Constructors
Modifier Constructor and Description

protected Assertions()
Creates a new Assertions.

Constructors
Modifier	Constructor and Description
`protected`	`Assertions()` Creates a new `Assertions`.

Method Summary

Methods
Modifier and Type	Method and Description
`static <T> Condition<T>`	`allOf(Condition<? super T>... conditions)` Creates a new `AllOf`
`static <T> Condition<T>`	`allOf(Iterable<? extends Condition<? super T>> conditions)` Creates a new `AllOf`
`static <T> Condition<T>`	`anyOf(Condition<? super T>... conditions)` Only delegate to `AnyOf.anyOf(Condition...)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `AnyOf` if you prefer).
`static <T> Condition<T>`	`anyOf(Iterable<? extends Condition<? super T>> conditions)` Creates a new `AnyOf`
`static <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> ClassBasedNavigableIterableAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT>`	`assertThat(ACTUAL actual, Class<ELEMENT_ASSERT> assertClass)` Creates a new instance of `ClassBasedNavigableIterableAssert` allowing to navigate to any `Iterable` element in order to perform assertions on it.
`static <T> T`	`assertThat(AssertProvider<T> component)` Delegates the creation of the `Assert` to the `AssertProvider.assertThat()` of the given component.
`static AbstractBigDecimalAssert<?>`	`assertThat(BigDecimal actual)` Creates a new instance of `BigDecimalAssert`.
`static AbstractBooleanAssert<?>`	`assertThat(boolean actual)` Creates a new instance of `BooleanAssert`.
`static AbstractBooleanAssert<?>`	`assertThat(Boolean actual)` Creates a new instance of `BooleanAssert`.
`static AbstractBooleanArrayAssert<?>`	`assertThat(boolean[] actual)` Creates a new instance of `BooleanArrayAssert`.
`static AbstractByteAssert<?>`	`assertThat(byte actual)` Creates a new instance of `ByteAssert`.
`static AbstractByteAssert<?>`	`assertThat(Byte actual)` Creates a new instance of `ByteAssert`.
`static AbstractByteArrayAssert<?>`	`assertThat(byte[] actual)` Creates a new instance of `ByteArrayAssert`.
`static AbstractCharacterAssert<?>`	`assertThat(char actual)` Creates a new instance of `CharacterAssert`.
`static AbstractCharArrayAssert<?>`	`assertThat(char[] actual)` Creates a new instance of `CharArrayAssert`.
`static AbstractCharacterAssert<?>`	`assertThat(Character actual)` Creates a new instance of `CharacterAssert`.
`static AbstractCharSequenceAssert<?,? extends CharSequence>`	`assertThat(CharSequence actual)` Creates a new instance of `CharSequenceAssert`.
`static AbstractClassAssert<?>`	`assertThat(Class<?> actual)` Creates a new instance of `ClassAssert`
`static AbstractDateAssert<?>`	`assertThat(Date actual)` Creates a new instance of `DateAssert`.
`static AbstractDoubleAssert<?>`	`assertThat(double actual)` Creates a new instance of `DoubleAssert`.
`static AbstractDoubleAssert<?>`	`assertThat(Double actual)` Creates a new instance of `DoubleAssert`.
`static AbstractDoubleArrayAssert<?>`	`assertThat(double[] actual)` Creates a new instance of `DoubleArrayAssert`.
`static AbstractFileAssert<?>`	`assertThat(File actual)` Creates a new instance of `FileAssert`.
`static AbstractFloatAssert<?>`	`assertThat(float actual)` Creates a new instance of `FloatAssert`.
`static AbstractFloatAssert<?>`	`assertThat(Float actual)` Creates a new instance of `FloatAssert`.
`static AbstractFloatArrayAssert<?>`	`assertThat(float[] actual)` Creates a new instance of `FloatArrayAssert`.
`static AbstractInputStreamAssert<?,? extends InputStream>`	`assertThat(InputStream actual)` Creates a new instance of `InputStreamAssert`.
`static AbstractIntegerAssert<?>`	`assertThat(int actual)` Creates a new instance of `IntegerAssert`.
`static AbstractIntArrayAssert<?>`	`assertThat(int[] actual)` Creates a new instance of `IntArrayAssert`.
`static AbstractIntegerAssert<?>`	`assertThat(Integer actual)` Creates a new instance of `IntegerAssert`.
`static <ELEMENT> AbstractIterableAssert<?,Iterable<? extends ELEMENT>,ELEMENT,ObjectAssert<ELEMENT>>`	`assertThat(Iterable<? extends ELEMENT> actual)` Creates a new instance of `IterableAssert`.
`static <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> FactoryBasedNavigableIterableAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT>`	`assertThat(Iterable<? extends ELEMENT> actual, AssertFactory<ELEMENT,ELEMENT_ASSERT> assertFactory)` Creates a new instance of `FactoryBasedNavigableIterableAssert` allowing to navigate to any `Iterable` element in order to perform assertions on it.
`static <ELEMENT> AbstractIterableAssert<?,Iterable<? extends ELEMENT>,ELEMENT,ObjectAssert<ELEMENT>>`	`assertThat(Iterator<? extends ELEMENT> actual)` Creates a new instance of `IterableAssert`.
`static <ELEMENT> AbstractListAssert<?,List<? extends ELEMENT>,ELEMENT,ObjectAssert<ELEMENT>>`	`assertThat(List<? extends ELEMENT> actual)` Creates a new instance of `ListAssert`.
`static <ACTUAL extends List<? extends ELEMENT>,ELEMENT,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> FactoryBasedNavigableListAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT>`	`assertThat(List<? extends ELEMENT> actual, AssertFactory<ELEMENT,ELEMENT_ASSERT> assertFactory)` Creates a new instance of `FactoryBasedNavigableListAssert` allowing to navigate to any `List` element in order to perform assertions on it.
`static <ELEMENT,ACTUAL extends List<? extends ELEMENT>,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> ClassBasedNavigableListAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT>`	`assertThat(List<? extends ELEMENT> actual, Class<ELEMENT_ASSERT> assertClass)` Creates a new instance of `ClassBasedNavigableListAssert` tallowing to navigate to any `List` element in order to perform assertions on it.
`static AbstractLongAssert<?>`	`assertThat(long actual)` Creates a new instance of `LongAssert`.
`static AbstractLongAssert<?>`	`assertThat(Long actual)` Creates a new instance of `LongAssert`.
`static AbstractLongArrayAssert<?>`	`assertThat(long[] actual)` Creates a new instance of `LongArrayAssert`.
`static <K,V> MapAssert<K,V>`	`assertThat(Map<K,V> actual)` Creates a new instance of `MapAssert`.
`static AbstractPathAssert<?>`	`assertThat(Path actual)` Creates a new instance of `PathAssert`
`static AbstractShortAssert<?>`	`assertThat(short actual)` Creates a new instance of `ShortAssert`.
`static AbstractShortAssert<?>`	`assertThat(Short actual)` Creates a new instance of `ShortAssert`.
`static AbstractShortArrayAssert<?>`	`assertThat(short[] actual)` Creates a new instance of `ShortArrayAssert`.
`static AbstractCharSequenceAssert<?,String>`	`assertThat(String actual)` Creates a new instance of `StringAssert`.
`static <T> AbstractObjectAssert<?,T>`	`assertThat(T actual)` Creates a new instance of `ObjectAssert`.
`static <T extends Comparable<? super T>> AbstractComparableAssert<?,T>`	`assertThat(T actual)` Creates a new instance of `GenericComparableAssert` with standard comparison semantics.
`static <T extends AssertDelegateTarget> T`	`assertThat(T assertion)` Returns the given assertion.
`static <T> AbstractObjectArrayAssert<?,T>`	`assertThat(T[] actual)` Creates a new instance of `ObjectArrayAssert`.
`static AbstractThrowableAssert<?,? extends Throwable>`	`assertThat(Throwable actual)` Creates a new instance of `ThrowableAssert`.
`static AbstractUriAssert<?>`	`assertThat(URI actual)` Creates a new instance of `UriAssert`.
`static AbstractUrlAssert<?>`	`assertThat(URL actual)` Creates a new instance of `UrlAssert`.
`static AbstractThrowableAssert<?,? extends Throwable>`	`assertThatThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)` Allows to capture and then assert on a `Throwable` more easily when used with Java 8 lambdas.
`static Index`	`atIndex(int index)` Only delegate to `Index.atIndex(int)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `Index` if you prefer).
`static Throwable`	`catchThrowable(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)` Allows to catch an `Throwable` more easily when used with Java 8 lambdas.
`static String`	`contentOf(File file)` Loads the text content of a file with the default character set, so that it can be passed to `assertThat(String)`.
`static String`	`contentOf(File file, Charset charset)` Loads the text content of a file, so that it can be passed to `assertThat(String)`.
`static String`	`contentOf(File file, String charsetName)` Loads the text content of a file, so that it can be passed to `assertThat(String)`.
`static String`	`contentOf(URL url)` Loads the text content of a URL with the default character set, so that it can be passed to `assertThat(String)`.
`static String`	`contentOf(URL url, Charset charset)` Loads the text content of a URL, so that it can be passed to `assertThat(String)`.
`static String`	`contentOf(URL url, String charsetName)` Loads the text content of a URL, so that it can be passed to `assertThat(String)`.
`static <T> DoesNotHave<T>`	`doesNotHave(Condition<? super T> condition)` Creates a new `DoesNotHave`.
`static <K,V> MapEntry<K,V>`	`entry(K key, V value)` Only delegate to `MapEntry#entry(K key, V value)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `MapEntry` if you prefer).
`static Properties<Object>`	`extractProperty(String propertyName)` Only delegate to `Properties.extractProperty(String)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `Properties` if you prefer).
`static <T> Properties<T>`	`extractProperty(String propertyName, Class<T> propertyType)` Only delegate to `Properties.extractProperty(String)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `Properties` if you prefer).
`static void`	`fail(String failureMessage)` Only delegate to `Fail.fail(String)` so that Assertions offers a full feature entry point to all Assertj Assert features (but you can use Fail if you prefer).
`static void`	`fail(String failureMessage, Throwable realCause)` Only delegate to `Fail.fail(String, Throwable)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
`static void`	`failBecauseExceptionWasNotThrown(Class<? extends Throwable> exceptionClass)` Only delegate to `Fail.failBecauseExceptionWasNotThrown(Class)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
`static <E> Filters<E>`	`filter(E[] array)` Only delegate to `Filters.filter(Object[])` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `Filters` if you prefer).
`static <E> Filters<E>`	`filter(Iterable<E> iterableToFilter)` Only delegate to `Filters.filter(Object[])` so that Assertions offers a full feature entry point to all AssertJ features (but you can use `Filters` if you prefer).
`static InFilter`	`in(Object... values)` Create a `FilterOperator` to use in `filteredOn(String, FilterOperation)` to express a filter keeping all Iterable elements whose property/field value matches one of the given values.
`static List<String>`	`linesOf(File file)` Loads the text content of a file into a list of strings with the default charset, each string corresponding to a line.
`static List<String>`	`linesOf(File file, Charset charset)` Loads the text content of a file into a list of strings, each string corresponding to a line.
`static List<String>`	`linesOf(File file, String charsetName)` Loads the text content of a file into a list of strings, each string corresponding to a line.
`static List<String>`	`linesOf(URL url)` Loads the text content of a URL into a list of strings with the default charset, each string corresponding to a line.
`static List<String>`	`linesOf(URL url, Charset charset)` Loads the text content of a URL into a list of strings, each string corresponding to a line.
`static List<String>`	`linesOf(URL url, String charsetName)` Loads the text content of a URL into a list of strings, each string corresponding to a line.
`static <T> Not<T>`	`not(Condition<? super T> condition)` Creates a new `Not`.
`static NotFilter`	`not(Object valueNotToMatch)` Create a `FilterOperator` to use in `filteredOn(String, FilterOperation)` to express a filter keeping all Iterable elements whose property/field value matches does not match the given value.
`static NotInFilter`	`notIn(Object... valuesNotToMatch)` Create a `FilterOperator` to use in `filteredOn(String, FilterOperation)` to express a filter keeping all Iterable elements whose property/field value matches does not match any of the given values.
`static Offset<Double>`	`offset(Double value)` Assertions entry point for double `Offset`.
`static Offset<Float>`	`offset(Float value)` Assertions entry point for float `Offset`.
`static void`	`registerCustomDateFormat(DateFormat userCustomDateFormat)` Add the given date format to the ones used to parse date String in String based Date assertions like `AbstractDateAssert.isEqualTo(String)`.
`static void`	`registerCustomDateFormat(String userCustomDateFormatPattern)` Add the given date format to the ones used to parse date String in String based Date assertions like `AbstractDateAssert.isEqualTo(String)`.
`static void`	`setAllowComparingPrivateFields(boolean allowComparingPrivateFields)` Globally sets whether the use of private fields is allowed for comparison.
`static void`	`setAllowExtractingPrivateFields(boolean allowExtractingPrivateFields)` Globally sets whether `IterableAssert#extracting(String)` and `ObjectArrayAssert#extracting(String)` should be allowed to extract private fields, if not and they try it fails with exception.
`static void`	`setLenientDateParsing(boolean value)` Instead of using default strict date/time parsing, it is possible to use lenient parsing mode for default date formats parser to interpret inputs that do not precisely match supported date formats (lenient parsing).
`static void`	`setMaxLengthForSingleLineDescription(int maxLengthForSingleLineDescription)` In error messages, sets the threshold when iterable/array formatting will on one line (if their String description is less than this parameter) or it will be formatted with one element per line.
`static void`	`setRemoveAssertJRelatedElementsFromStackTrace(boolean removeAssertJRelatedElementsFromStackTrace)` Only delegate to `Fail.setRemoveAssertJRelatedElementsFromStackTrace(boolean)` so that Assertions offers a full feature entry point to all AssertJ Assert features (but you can use `Fail` if you prefer).
`static void`	`shouldHaveThrown(Class<? extends Throwable> exceptionClass)` Only delegate to `Fail.shouldHaveThrown(Class)` so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
`static Tuple`	`tuple(Object... values)` Utility method to build nicely a `Tuple` when working with `AbstractIterableAssert.extracting(String...)` or `AbstractObjectArrayAssert.extracting(String...)`
`static void`	`useDefaultDateFormatsOnly()` Remove all registered custom date formats => use only the defaults date formats to parse string as date.
`static void`	`useDefaultRepresentation()` Fallback to use `StandardRepresentation` to revert the effect of calling `useRepresentation(Representation)`.
`static void`	`useRepresentation(Representation customRepresentation)` Register a `Representation` that will be used in all following assertions.
`static Offset<BigDecimal>`	`within(BigDecimal value)` Assertions entry point for BigDecimal `Offset` to use with isCloseTo assertions.
`static Offset<Byte>`	`within(Byte value)` Assertions entry point for Byte `Offset` to use with isCloseTo assertions.
`static Offset<Double>`	`within(Double value)` Alias for `offset(Double)` to use with isCloseTo assertions.
`static Offset<Float>`	`within(Float value)` Alias for `offset(Float)` to use with isCloseTo assertions.
`static Offset<Integer>`	`within(Integer value)` Assertions entry point for Integer `Offset` to use with isCloseTo assertions.
`static Offset<Long>`	`within(Long value)` Assertions entry point for Long `Offset` to use with isCloseTo assertions.
`static Offset<Short>`	`within(Short value)` Assertions entry point for Short `Offset` to use with isCloseTo assertions.
`static Percentage`	`withinPercentage(Double value)` Assertions entry point for Double `Percentage` to use with isCloseTo assertions for percentages.
`static Percentage`	`withinPercentage(Integer value)` Assertions entry point for Integer `Percentage` to use with isCloseTo assertions for percentages.
`static Percentage`	`withinPercentage(Long value)` Assertions entry point for Long `Percentage` to use with isCloseTo assertions for percentages.
`static Offset<Double>`	`withPrecision(Double value)` Alias for `offset(Double)` to use with real number assertions.
`static Offset<Float>`	`withPrecision(Float value)` Alias for `offset(Float)` to use with real number assertions.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Assertions
```
protected Assertions()
```
    Creates a new Assertions.
- Method Detail
  - assertThat
```
public static AbstractBigDecimalAssert<?> assertThat(BigDecimal actual)
```
    Creates a new instance of BigDecimalAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractUriAssert<?> assertThat(URI actual)
```
    Creates a new instance of UriAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractUrlAssert<?> assertThat(URL actual)
```
    Creates a new instance of UrlAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractBooleanAssert<?> assertThat(boolean actual)
```
    Creates a new instance of BooleanAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractBooleanAssert<?> assertThat(Boolean actual)
```
    Creates a new instance of BooleanAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractBooleanArrayAssert<?> assertThat(boolean[] actual)
```
    Creates a new instance of BooleanArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractByteAssert<?> assertThat(byte actual)
```
    Creates a new instance of ByteAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractByteAssert<?> assertThat(Byte actual)
```
    Creates a new instance of ByteAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractByteArrayAssert<?> assertThat(byte[] actual)
```
    Creates a new instance of ByteArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractCharacterAssert<?> assertThat(char actual)
```
    Creates a new instance of CharacterAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractCharArrayAssert<?> assertThat(char[] actual)
```
    Creates a new instance of CharArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractCharacterAssert<?> assertThat(Character actual)
```
    Creates a new instance of CharacterAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractClassAssert<?> assertThat(Class<?> actual)
```
    Creates a new instance of ClassAssert
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <T extends Comparable<? super T>> AbstractComparableAssert<?,T> assertThat(T actual)
```
    Creates a new instance of GenericComparableAssert with standard comparison semantics.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractDoubleAssert<?> assertThat(double actual)
```
    Creates a new instance of DoubleAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractDoubleAssert<?> assertThat(Double actual)
```
    Creates a new instance of DoubleAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractDoubleArrayAssert<?> assertThat(double[] actual)
```
    Creates a new instance of DoubleArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractFileAssert<?> assertThat(File actual)
```
    Creates a new instance of FileAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractPathAssert<?> assertThat(Path actual)
```
    Creates a new instance of PathAssert
    
    Parameters:
    actual - the path to test
    
    Returns:
    the created assertion object
  - assertThat
```
public static AbstractInputStreamAssert<?,? extends InputStream> assertThat(InputStream actual)
```
    Creates a new instance of InputStreamAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractFloatAssert<?> assertThat(float actual)
```
    Creates a new instance of FloatAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractFloatAssert<?> assertThat(Float actual)
```
    Creates a new instance of FloatAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractFloatArrayAssert<?> assertThat(float[] actual)
```
    Creates a new instance of FloatArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractIntegerAssert<?> assertThat(int actual)
```
    Creates a new instance of IntegerAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractIntArrayAssert<?> assertThat(int[] actual)
```
    Creates a new instance of IntArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractIntegerAssert<?> assertThat(Integer actual)
```
    Creates a new instance of IntegerAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <ELEMENT> AbstractIterableAssert<?,Iterable<? extends ELEMENT>,ELEMENT,ObjectAssert<ELEMENT>> assertThat(Iterable<? extends ELEMENT> actual)
```
    Creates a new instance of IterableAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <ELEMENT> AbstractIterableAssert<?,Iterable<? extends ELEMENT>,ELEMENT,ObjectAssert<ELEMENT>> assertThat(Iterator<? extends ELEMENT> actual)
```
    Creates a new instance of IterableAssert.
    Be aware that calls to most methods on returned IterableAssert will consume Iterator so it won't be possible to iterate over it again. Calling multiple methods on returned IterableAssert is safe as Iterator's elements are cached by IterableAssert first time Iterator is consumed.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <ELEMENT> AbstractListAssert<?,List<? extends ELEMENT>,ELEMENT,ObjectAssert<ELEMENT>> assertThat(List<? extends ELEMENT> actual)
```
    Creates a new instance of ListAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> FactoryBasedNavigableIterableAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT> assertThat(Iterable<? extends ELEMENT> actual,
                                                                                                                                                                                                 AssertFactory<ELEMENT,ELEMENT_ASSERT> assertFactory)
```
    Creates a new instance of FactoryBasedNavigableIterableAssert allowing to navigate to any Iterable element in order to perform assertions on it.
    Navigational methods provided:
    The available assertions after navigating to an element depend on the ELEMENT_ASSERT parameter of the given AssertFactory<ELEMENT, ELEMENT_ASSERT> (AssertJ can't figure it out because of Java type erasure).
    Example with String element assertions:
```
 Iterable<String> hobbits = newHashSet("frodo", "sam", "pippin");
 
 // build an AssertFactory for StringAssert (much nicer with Java 8 lambdas)
 AssertFactory<String, StringAssert> stringAssertFactory = new AssertFactory<String, StringAssert>() {
   @Override
   public StringAssert createAssert(String string) {
     return new StringAssert(string);
   }
 };
 
 // assertion succeeds with String assertions chained after first()
 assertThat(hobbits, stringAssertFactory).first()
                                         .startsWith("fro")
                                         .endsWith("do");
```
    Parameters:
    actual - the actual value.
    assertFactory - the factory used to create the elements assert instance.
    
    Returns:
    the created assertion object.
    Since:
    
    2.5.0 / 3.5.0
  - assertThat
```
public static <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> ClassBasedNavigableIterableAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT> assertThat(ACTUAL actual,
                                                                                                                                                                                               Class<ELEMENT_ASSERT> assertClass)
```
    Creates a new instance of ClassBasedNavigableIterableAssert allowing to navigate to any Iterable element in order to perform assertions on it.
    Navigational methods provided:
    The available assertions after navigating to an element depend on the given assertClass (AssertJ can't find the element assert type by itself because of Java type erasure).
    Example with String element assertions:
```
 Iterable<String> hobbits = newHashSet("frodo", "sam", "pippin");
 
 // assertion succeeds with String assertions chained after first()
 assertThat(hobbits, StringAssert.class).first()
                                        .startsWith("fro")
                                        .endsWith("do");
```
    Parameters:
    actual - the actual value.
    assertClass - the class used to create the elements assert instance.
    
    Returns:
    the created assertion object.
    Since:
    
    2.5.0 / 3.5.0
  - assertThat
```
public static <ACTUAL extends List<? extends ELEMENT>,ELEMENT,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> FactoryBasedNavigableListAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT> assertThat(List<? extends ELEMENT> actual,
                                                                                                                                                                                         AssertFactory<ELEMENT,ELEMENT_ASSERT> assertFactory)
```
    Creates a new instance of FactoryBasedNavigableListAssert allowing to navigate to any List element in order to perform assertions on it.
    Navigational methods provided:
    The available assertions after navigating to an element depend on the ELEMENT_ASSERT parameter of the given AssertFactory<ELEMENT, ELEMENT_ASSERT> (AssertJ can't figure it out because of Java type erasure).
    Example with String element assertions:
```
 List<String> hobbits = newArrayList("frodo", "sam", "pippin");
 
 // build an AssertFactory for StringAssert (much nicer with Java 8 lambdas)
 AssertFactory<String, StringAssert> stringAssertFactory = new AssertFactory<String, StringAssert>() {
   @Override
   public StringAssert createAssert(String string) {
     return new StringAssert(string);
   }
 };
 
 // assertion succeeds with String assertions chained after first()
 assertThat(hobbits, stringAssertFactory).first()
                                         .startsWith("fro")
                                         .endsWith("do");
```
    Parameters:
    actual - the actual value.
    assertFactory - the factory used to create the elements assert instance.
    
    Returns:
    the created assertion object.
    Since:
    
    2.5.0 / 3.5.0
  - assertThat
```
public static <ELEMENT,ACTUAL extends List<? extends ELEMENT>,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,ELEMENT>> ClassBasedNavigableListAssert<?,ACTUAL,ELEMENT,ELEMENT_ASSERT> assertThat(List<? extends ELEMENT> actual,
                                                                                                                                                                                       Class<ELEMENT_ASSERT> assertClass)
```
    Creates a new instance of ClassBasedNavigableListAssert tallowing to navigate to any List element in order to perform assertions on it.
    Navigational methods provided:
    The available assertions after navigating to an element depend on the given assertClass (AssertJ can't find the element assert type by itself because of Java type erasure).
    Example with String element assertions:
```
 List<String> hobbits = newArrayList("frodo", "sam", "pippin");
 
 // assertion succeeds with String assertions chained after first()
 assertThat(hobbits, StringAssert.class).first()
                                        .startsWith("fro")
                                        .endsWith("do");
```
    Parameters:
    actual - the actual value.
    assertClass - the class used to create the elements assert instance.
    
    Returns:
    the created assertion object.
    Since:
    
    2.5.0 / 3.5.0
  - assertThat
```
public static AbstractLongAssert<?> assertThat(long actual)
```
    Creates a new instance of LongAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractLongAssert<?> assertThat(Long actual)
```
    Creates a new instance of LongAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractLongArrayAssert<?> assertThat(long[] actual)
```
    Creates a new instance of LongArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <T> AbstractObjectAssert<?,T> assertThat(T actual)
```
    Creates a new instance of ObjectAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <T extends AssertDelegateTarget> T assertThat(T assertion)
```
    Returns the given assertion. This method improves code readability by surrounding the given assertion with assertThat.
    Consider for example the following MyButton and MyButtonAssert classes:
```
 public class MyButton extends JButton {

   private boolean blinking;

   public boolean isBlinking() { return this.blinking; }

   public void setBlinking(boolean blink) { this.blinking = blink; }

 }

 private static class MyButtonAssert implements AssertDelegateTarget {

   private MyButton button;
   MyButtonAssert(MyButton button) { this.button = button; }

   void isBlinking() {
     // standard assertion from core Assertions.assertThat
     assertThat(button.isBlinking()).isTrue();
   }

   void isNotBlinking() {
     // standard assertion from core Assertions.assertThat
     assertThat(button.isBlinking()).isFalse();
   }
 }
```
    As MyButtonAssert implements AssertDelegateTarget, you can use assertThat(buttonAssert).isBlinking(); instead of buttonAssert.isBlinking(); to have easier to read assertions:
```
 @Test
 public void AssertDelegateTarget_example() {

   MyButton button = new MyButton();
   MyButtonAssert buttonAssert = new MyButtonAssert(button);

   // you can encapsulate MyButtonAssert assertions methods within assertThat
   assertThat(buttonAssert).isNotBlinking(); // same as : buttonAssert.isNotBlinking();

   button.setBlinking(true);

   assertThat(buttonAssert).isBlinking(); // same as : buttonAssert.isBlinking();
 }
```
    Type Parameters:
    T - the generic type of the user-defined assert.
    Parameters:
    assertion - the assertion to return.
    
    Returns:
    the given assertion.
  - assertThat
```
public static <T> T assertThat(AssertProvider<T> component)
```
    Delegates the creation of the Assert to the AssertProvider.assertThat() of the given component.
    Read the comments on AssertProvider for an example of its usage.
    
    Parameters:
    component - the component that creates its own assert
    
    Returns:
    the associated Assert of the given component
  - assertThat
```
public static <T> AbstractObjectArrayAssert<?,T> assertThat(T[] actual)
```
    Creates a new instance of ObjectArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static <K,V> MapAssert<K,V> assertThat(Map<K,V> actual)
```
    Creates a new instance of MapAssert.
    Returned type is MapAssert as it overrides method to annotate them with SafeVarargs avoiding annoying warnings.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractShortAssert<?> assertThat(short actual)
```
    Creates a new instance of ShortAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractShortAssert<?> assertThat(Short actual)
```
    Creates a new instance of ShortAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractShortArrayAssert<?> assertThat(short[] actual)
```
    Creates a new instance of ShortArrayAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractCharSequenceAssert<?,? extends CharSequence> assertThat(CharSequence actual)
```
    Creates a new instance of CharSequenceAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractCharSequenceAssert<?,String> assertThat(String actual)
```
    Creates a new instance of StringAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractDateAssert<?> assertThat(Date actual)
```
    Creates a new instance of DateAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created assertion object.
  - assertThat
```
public static AbstractThrowableAssert<?,? extends Throwable> assertThat(Throwable actual)
```
    Creates a new instance of ThrowableAssert.
    
    Parameters:
    actual - the actual value.
    
    Returns:
    the created ThrowableAssert.
  - assertThatThrownBy
```
public static AbstractThrowableAssert<?,? extends Throwable> assertThatThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)
```
    Allows to capture and then assert on a Throwable more easily when used with Java 8 lambdas.
    Java 8 example :
```
  @Test
  public void testException() {
    assertThatThrownBy(() -> { throw new Exception("boom!") }).isInstanceOf(Exception.class)
                                                              .hasMessageContaining("boom");
  }
```
    Java 7 example :
```
 assertThatThrownBy(new ThrowingCallable() {
 
   @Override
   public void call() throws Exception {
     throw new Exception("boom!");
   }
   
 }).isInstanceOf(Exception.class)
   .hasMessageContaining("boom");
```
    If the provided ThrowableAssert.ThrowingCallable does not raise an exception, an error is immediately raised, in that case the test description provided with as(String, Object...) is not honored. To use a test description, use catchThrowable as shown below.
```
 // assertion will fail but "display me" won't appear in the error 
 assertThatThrownBy(() -> { // do nothing }).as("display me").isInstanceOf(Exception.class);
 
 // assertion will fail AND "display me" will appear in the error
 Throwable thrown = catchThrowable(() -> { // do nothing });
 assertThat(thrown).as("display me").isInstanceOf(Exception.class); 
```
    Parameters:
    shouldRaiseThrowable - The ThrowableAssert.ThrowingCallable or lambda with the code that should raise the throwable.
    
    Returns:
    The captured exception or null if none was raised by the callable.
  - catchThrowable
```
public static Throwable catchThrowable(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)
```
    Allows to catch an Throwable more easily when used with Java 8 lambdas.
    This caught Throwable can then be asserted.
    
    Java 8 example:
```
 @Test
  public void testException() {
    // when
    Throwable thrown = catchThrowable(() -> { throw new Exception("boom!") });

    // then
    assertThat(thrown).isInstanceOf(Exception.class)
                      .hasMessageContaining("boom");
  }
```
    Java 7 example:
```
 @Test
 public void testException() {
   // when
   Throwable thrown = catchThrowable(new ThrowingCallable() {
   
     @Override
     public void call() throws Exception {
       throw new Exception("boom!");
     }
     
   })
   // then
   assertThat(thrown).isInstanceOf(Exception.class)
                     .hasMessageContaining("boom");
 }
```
    Parameters:
    shouldRaiseThrowable - The lambda with the code that should raise the exception.
    
    Returns:
    The captured exception or null if none was raised by the callable.
  - setRemoveAssertJRelatedElementsFromStackTrace
```
public static void setRemoveAssertJRelatedElementsFromStackTrace(boolean removeAssertJRelatedElementsFromStackTrace)
```
    Only delegate to Fail.setRemoveAssertJRelatedElementsFromStackTrace(boolean) so that Assertions offers a full feature entry point to all AssertJ Assert features (but you can use Fail if you prefer).
  - fail
```
public static void fail(String failureMessage)
```
    Only delegate to Fail.fail(String) so that Assertions offers a full feature entry point to all Assertj Assert features (but you can use Fail if you prefer).
  - fail
```
public static void fail(String failureMessage,
        Throwable realCause)
```
    Only delegate to Fail.fail(String, Throwable) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
  - failBecauseExceptionWasNotThrown
```
public static void failBecauseExceptionWasNotThrown(Class<? extends Throwable> exceptionClass)
```
    Only delegate to Fail.failBecauseExceptionWasNotThrown(Class) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer). shouldHaveThrown(Class) can be used as a replacement.
  - shouldHaveThrown
```
public static void shouldHaveThrown(Class<? extends Throwable> exceptionClass)
```
    Only delegate to Fail.shouldHaveThrown(Class) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
  - setMaxLengthForSingleLineDescription
```
public static void setMaxLengthForSingleLineDescription(int maxLengthForSingleLineDescription)
```
    In error messages, sets the threshold when iterable/array formatting will on one line (if their String description is less than this parameter) or it will be formatted with one element per line.
    The following array will be formatted on one line as its length < 80:
```
 String[] greatBooks = array("A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice");
 
 // formatted as:
 
 ["A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice"]
```
    whereas this array is formatted on multiple lines (one element per line):
```
 String[] greatBooks = array("A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice", "Guards! Guards! (Discworld)");
 
 // formatted as:
 
 ["A Game of Thrones",
  "The Lord of the Rings",
  "Assassin's Apprentice",
  "Guards! Guards! (Discworld)"]
```
    Parameters:
    maxLengthForSingleLineDescription - the maximum lenght for an iterable/array to be displayed on one line
  - extractProperty
```
public static <T> Properties<T> extractProperty(String propertyName,
                                Class<T> propertyType)
```
    Only delegate to Properties.extractProperty(String) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Properties if you prefer).
    Typical usage is to chain extractProperty with from method, see examples below :
```
 // extract simple property values having a java standard type (here String)
 assertThat(extractProperty("name", String.class).from(fellowshipOfTheRing)).contains("
 Boromir", "Gandalf", "Frodo",
     "Legolas").doesNotContain("Sauron", "Elrond");

 // extracting property works also with user's types (here Race)
 assertThat(extractProperty("race", String.class).from(fellowshipOfTheRing)).contains(HOBBIT,
 ELF).doesNotContain(ORC);

 // extract nested property on Race
 assertThat(extractProperty("race.name", String.class).from(fellowshipOfTheRing)).contains("
 Hobbit", "Elf")
     .doesNotContain("Orc");
```
  - extractProperty
```
public static Properties<Object> extractProperty(String propertyName)
```
    Only delegate to Properties.extractProperty(String) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Properties if you prefer).
    Typical usage is to chain extractProperty with from method, see examples below :
```
 // extract simple property values, as no type has been defined the extracted property will be considered as Object
 // to define the real property type (here String) use extractProperty("name", String.class) instead.
 assertThat(extractProperty("name").from(fellowshipOfTheRing)).contains("Boromir",
 "Gandalf", "Frodo", "Legolas")
     .doesNotContain("Sauron", "Elrond");

 // extracting property works also with user's types (here Race), even though it will be considered as Object
 // to define the real property type (here String) use extractProperty("name", Race.class) instead.
 assertThat(extractProperty("race").from(fellowshipOfTheRing)).contains(HOBBIT, ELF).doesNotContain(ORC);

 // extract nested property on Race
 assertThat(extractProperty("race.name").from(fellowshipOfTheRing)).contains("Hobbit",
 "Elf").doesNotContain("Orc");
```
  - tuple
```
public static Tuple tuple(Object... values)
```
    Utility method to build nicely a Tuple when working with AbstractIterableAssert.extracting(String...) or AbstractObjectArrayAssert.extracting(String...)
    
    Parameters:
    values - the values stored in the Tuple
    
    Returns:
    the built Tuple
  - setAllowExtractingPrivateFields
```
public static void setAllowExtractingPrivateFields(boolean allowExtractingPrivateFields)
```
    Globally sets whether IterableAssert#extracting(String) and ObjectArrayAssert#extracting(String) should be allowed to extract private fields, if not and they try it fails with exception.
    
    Parameters:
    allowExtractingPrivateFields - allow private fields extraction. Default true.
  - setAllowComparingPrivateFields
```
public static void setAllowComparingPrivateFields(boolean allowComparingPrivateFields)
```
    Globally sets whether the use of private fields is allowed for comparison. The following (incomplete) list of methods will be impacted by this change :
    - AbstractIterableAssert.usingElementComparatorOnFields(java.lang.String...)
    If the value is false and these methods try to compare private fields, it will fail with an exception.
    Parameters: allowComparingPrivateFields - allow private fields comparison. Default true.
  entry public static <K,V> MapEntry<K,V> entry(K key, V value) Only delegate to MapEntry#entry(K key, V value) so that Assertions offers a full feature entry point to all AssertJ features (but you can use MapEntry if you prefer). Typical usage is to call entry in MapAssert contains assertion, see examples below : Map ringBearers = ... // init omitted assertThat(ringBearers).contains(entry(oneRing, frodo), entry(nenya, galadriel)); atIndex public static Index atIndex(int index) Only delegate to Index.atIndex(int) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Index if you prefer). Typical usage : List<Ring> elvesRings = newArrayList(vilya, nenya, narya); assertThat(elvesRings).contains(vilya, atIndex(0)).contains(nenya, atIndex(1)).contains(narya, atIndex(2)); offset public static Offset<Double> offset(Double value) Assertions entry point for double Offset. Typical usage : assertThat(8.1).isEqualTo(8.0, offset(0.1)); offset public static Offset<Float> offset(Float value) Assertions entry point for float Offset. Typical usage : assertThat(8.2f).isCloseTo(8.0f, offset(0.2f)); within public static Offset<Double> within(Double value) Alias for offset(Double) to use with isCloseTo assertions. Typical usage : assertThat(8.1).isCloseTo(8.0, within(0.1)); withPrecision public static Offset<Double> withPrecision(Double value) Alias for offset(Double) to use with real number assertions. Typical usage : assertThat(8.1).isEqualTo(8.0, withPrecision(0.1)); within public static Offset<Float> within(Float value) Alias for offset(Float) to use with isCloseTo assertions. Typical usage : assertThat(8.2f).isCloseTo(8.0f, within(0.2f)); withPrecision public static Offset<Float> withPrecision(Float value) Alias for offset(Float) to use with real number assertions. Typical usage : assertThat(8.2f).isEqualTo(8.0f, withPrecision(0.2f)); within public static Offset<BigDecimal> within(BigDecimal value) Assertions entry point for BigDecimal Offset to use with isCloseTo assertions. Typical usage : assertThat(BigDecimal.TEN).isCloseTo(new BigDecimal("10.5"), within(BigDecimal.ONE)); within public static Offset<Byte> within(Byte value) Assertions entry point for Byte Offset to use with isCloseTo assertions. Typical usage : assertThat((byte)10).isCloseTo((byte)11, within((byte)1)); within public static Offset<Integer> within(Integer value) Assertions entry point for Integer Offset to use with isCloseTo assertions. Typical usage : assertThat(10).isCloseTo(11, within(1)); within public static Offset<Short> within(Short value) Assertions entry point for Short Offset to use with isCloseTo assertions. Typical usage : assertThat(10).isCloseTo(11, within(1)); within public static Offset<Long> within(Long value) Assertions entry point for Long Offset to use with isCloseTo assertions. Typical usage : assertThat(5l).isCloseTo(7l, within(2l)); withinPercentage public static Percentage withinPercentage(Double value) Assertions entry point for Double Percentage to use with isCloseTo assertions for percentages. Typical usage : assertThat(11.0).isCloseTo(10.0, withinPercentage(10.0)); withinPercentage public static Percentage withinPercentage(Integer value) Assertions entry point for Integer Percentage to use with isCloseTo assertions for percentages. Typical usage : assertThat(11).isCloseTo(10, withinPercentage(10)); withinPercentage public static Percentage withinPercentage(Long value) Assertions entry point for Long Percentage to use with isCloseTo assertions for percentages. Typical usage : assertThat(11L).isCloseTo(10L, withinPercentage(10L)); allOf @SafeVarargs public static <T> Condition<T> allOf(Condition<? super T>... conditions) Creates a new AllOf Type Parameters: T - the type of object the given condition accept. Parameters: conditions - the conditions to evaluate. Returns: the created AnyOf. Throws: NullPointerException - if the given array is null. NullPointerException - if any of the elements in the given array is null. allOf public static <T> Condition<T> allOf(Iterable<? extends Condition<? super T>> conditions) Creates a new AllOf Type Parameters: T - the type of object the given condition accept. Parameters: conditions - the conditions to evaluate. Returns: the created AnyOf. Throws: NullPointerException - if the given iterable is null. NullPointerException - if any of the elements in the given iterable is null. anyOf @SafeVarargs public static <T> Condition<T> anyOf(Condition<? super T>... conditions) Only delegate to AnyOf.anyOf(Condition...) so that Assertions offers a full feature entry point to all AssertJ features (but you can use AnyOf if you prefer). Typical usage (jedi and sith are Condition) : assertThat("Vader").is(anyOf(jedi, sith)); anyOf public static <T> Condition<T> anyOf(Iterable<? extends Condition<? super T>> conditions) Creates a new AnyOf Type Parameters: T - the type of object the given condition accept. Parameters: conditions - the conditions to evaluate. Returns: the created AnyOf. Throws: NullPointerException - if the given iterable is null. NullPointerException - if any of the elements in the given iterable is null.
  - doesNotHave public static <T> DoesNotHave<T> doesNotHave(Condition<? super T> condition)
    Creates a new DoesNotHave.
    
    Parameters:
    condition - the condition to inverse.
    
    Returns:
    The Not condition created.
  - not
```
public static <T> Not<T> not(Condition<? super T> condition)
```
    Creates a new Not.
    
    Parameters:
    condition - the condition to inverse.
    
    Returns:
    The Not condition created.
  - filter
```
public static <E> Filters<E> filter(E[] array)
```
    Only delegate to Filters.filter(Object[]) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Filters if you prefer).
    Note that the given array is not modified, the filters are performed on an Iterable copy of the array.
    Typical usage with Condition :
```
 assertThat(filter(players).being(potentialMVP).get()).containsOnly(james, rose);
```
    and with filter language based on java bean property :
```
 assertThat(filter(players).with("pointsPerGame").greaterThan(20).and("assistsPerGame").greaterThan(7).get())
           .containsOnly(james, rose);
```
  - filter
```
public static <E> Filters<E> filter(Iterable<E> iterableToFilter)
```
    Only delegate to Filters.filter(Object[]) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Filters if you prefer).
    Note that the given Iterable is not modified, the filters are performed on a copy.
    Typical usage with Condition :
```
 assertThat(filter(players).being(potentialMVP).get()).containsOnly(james, rose);
```
    and with filter language based on java bean property :
```
 assertThat(filter(players).with("pointsPerGame").greaterThan(20).and("assistsPerGame").greaterThan(7).get())
            .containsOnly(james, rose);
```
  - in
```
public static InFilter in(Object... values)
```
    Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches one of the given values.
    As often, an example helps:
```
 Employee yoda   = new Employee(1L, new Name("Yoda"), 800);
 Employee obiwan = new Employee(2L, new Name("Obiwan"), 800);
 Employee luke   = new Employee(3L, new Name("Luke", "Skywalker"), 26);
 Employee noname = new Employee(4L, null, 50);
 
 List<Employee> employees = newArrayList(yoda, luke, obiwan, noname);
 
 assertThat(employees).filteredOn("age", in(800, 26))
                      .containsOnly(yoda, obiwan, luke);
```
    Parameters:
    values - values to match (one match is sufficient)
    
    Returns:
    the created "in" filter
  - notIn
```
public static NotInFilter notIn(Object... valuesNotToMatch)
```
    Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches does not match any of the given values.
    As often, an example helps:
```
 Employee yoda   = new Employee(1L, new Name("Yoda"), 800);
 Employee obiwan = new Employee(2L, new Name("Obiwan"), 800);
 Employee luke   = new Employee(3L, new Name("Luke", "Skywalker"), 26);
 Employee noname = new Employee(4L, null, 50);
 
 List<Employee> employees = newArrayList(yoda, luke, obiwan, noname);
 
 assertThat(employees).filteredOn("age", notIn(800, 50))
                      .containsOnly(luke);
```
    Parameters:
    valuesNotToMatch - values not to match (none of the values must match)
    
    Returns:
    the created "not in" filter
  - not
```
public static NotFilter not(Object valueNotToMatch)
```
    Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches does not match the given value.
    As often, an example helps:
```
 Employee yoda   = new Employee(1L, new Name("Yoda"), 800);
 Employee obiwan = new Employee(2L, new Name("Obiwan"), 800);
 Employee luke   = new Employee(3L, new Name("Luke", "Skywalker"), 26);
 Employee noname = new Employee(4L, null, 50);
 
 List<Employee> employees = newArrayList(yoda, luke, obiwan, noname);
 
 assertThat(employees).filteredOn("age", not(800))
                      .containsOnly(luke, noname);
```
    Parameters:
    valueNotToMatch - the value not to match
    
    Returns:
    the created "not" filter
  - contentOf
```
public static String contentOf(File file,
               Charset charset)
```
    Loads the text content of a file, so that it can be passed to assertThat(String).
    Note that this will load the entire file in memory; for larger files, there might be a more efficient alternative with assertThat(File).
    
    Parameters:
    file - the file.
    charset - the character set to use.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - contentOf
```
public static String contentOf(File file,
               String charsetName)
```
    Loads the text content of a file, so that it can be passed to assertThat(String).
    Note that this will load the entire file in memory; for larger files, there might be a more efficient alternative with assertThat(File).
    
    Parameters:
    file - the file.
    charsetName - the name of the character set to use.
    
    Returns:
    the content of the file.
    
    Throws:
    
    IllegalArgumentException - if the given character set is not supported on this platform.
    
    RuntimeIOException - if an I/O exception occurs.
  - contentOf
```
public static String contentOf(File file)
```
    Loads the text content of a file with the default character set, so that it can be passed to assertThat(String).
    Note that this will load the entire file in memory; for larger files, there might be a more efficient alternative with assertThat(File).
    
    Parameters:
    file - the file.
    
    Returns:
    the content of the file.
    
    Throws:
    
    RuntimeIOException - if an I/O exception occurs.
  - linesOf
```
public static List<String> linesOf(File file)
```
    Loads the text content of a file into a list of strings with the default charset, each string corresponding to a line. The line endings are either \n, \r or \r\n.
    
    Parameters:
    file - the file.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - linesOf
```
public static List<String> linesOf(File file,
                   Charset charset)
```
    Loads the text content of a file into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.
    
    Parameters:
    file - the file.
    charset - the character set to use.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - linesOf
```
public static List<String> linesOf(File file,
                   String charsetName)
```
    Loads the text content of a file into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.
    
    Parameters:
    file - the file.
    charsetName - the name of the character set to use.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - contentOf
```
public static String contentOf(URL url,
               Charset charset)
```
    Loads the text content of a URL, so that it can be passed to assertThat(String).
    Note that this will load the entire contents in memory.
    
    Parameters:
    url - the URL.
    charset - the character set to use.
    
    Returns:
    the content of the URL.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - contentOf
```
public static String contentOf(URL url,
               String charsetName)
```
    Loads the text content of a URL, so that it can be passed to assertThat(String).
    Note that this will load the entire contents in memory.
    
    Parameters:
    url - the URL.
    charsetName - the name of the character set to use.
    
    Returns:
    the content of the URL.
    
    Throws:
    
    IllegalArgumentException - if the given character set is not supported on this platform.
    
    RuntimeIOException - if an I/O exception occurs.
  - contentOf
```
public static String contentOf(URL url)
```
    Loads the text content of a URL with the default character set, so that it can be passed to assertThat(String).
    Note that this will load the entire file in memory; for larger files.
    
    Parameters:
    url - the URL.
    
    Returns:
    the content of the file.
    
    Throws:
    
    RuntimeIOException - if an I/O exception occurs.
  - linesOf
```
public static List<String> linesOf(URL url)
```
    Loads the text content of a URL into a list of strings with the default charset, each string corresponding to a line. The line endings are either \n, \r or \r\n.
    
    Parameters:
    url - the URL.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - linesOf
```
public static List<String> linesOf(URL url,
                   Charset charset)
```
    Loads the text content of a URL into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.
    
    Parameters:
    url - the URL.
    charset - the character set to use.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - linesOf
```
public static List<String> linesOf(URL url,
                   String charsetName)
```
    Loads the text content of a URL into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.
    
    Parameters:
    url - the URL.
    charsetName - the name of the character set to use.
    
    Returns:
    the content of the file.
    
    Throws:
    
    NullPointerException - if the given charset is null.
    
    RuntimeIOException - if an I/O exception occurs.
  - setLenientDateParsing
```
public static void setLenientDateParsing(boolean value)
```
    Instead of using default strict date/time parsing, it is possible to use lenient parsing mode for default date formats parser to interpret inputs that do not precisely match supported date formats (lenient parsing).
    With strict parsing, inputs must match exactly date/time format.
    Example:
```
 final Date date = Dates.parse("2001-02-03");
 final Date dateTime = parseDatetime("2001-02-03T04:05:06");
 final Date dateTimeWithMs = parseDatetimeWithMs("2001-02-03T04:05:06.700");

 Assertions.setLenientDateParsing(true);

 // assertions will pass
 assertThat(date).isEqualTo("2001-01-34");
 assertThat(date).isEqualTo("2001-02-02T24:00:00");
 assertThat(date).isEqualTo("2001-02-04T-24:00:00.000");
 assertThat(dateTime).isEqualTo("2001-02-03T04:05:05.1000");
 assertThat(dateTime).isEqualTo("2001-02-03T04:04:66");
 assertThat(dateTimeWithMs).isEqualTo("2001-02-03T04:05:07.-300");

 // assertions will fail
 assertThat(date).hasSameTimeAs("2001-02-04"); // different date
 assertThat(dateTime).hasSameTimeAs("2001-02-03 04:05:06"); // leniency does not help here
```
    To revert to default strict date parsing, call setLenientDateParsing(false).
    Parameters:
    value - whether lenient parsing mode should be enabled or not
  - registerCustomDateFormat
```
public static void registerCustomDateFormat(DateFormat userCustomDateFormat)
```
    Add the given date format to the ones used to parse date String in String based Date assertions like AbstractDateAssert.isEqualTo(String).
    User date formats are used before default ones in the order they have been registered (first registered, first used).
    AssertJ is gonna use any date formats registered with one of these methods :
    Beware that AssertJ will use the newly registered format for all remaining Date assertions in the test suite
    To revert to default formats only, call useDefaultDateFormatsOnly() or AbstractDateAssert.withDefaultDateFormatsOnly().
    Code examples:
```
 Date date = ... // set to 2003 April the 26th
 assertThat(date).isEqualTo("2003-04-26");

 try {
   // date with a custom format : failure since the default formats don't match.
   assertThat(date).isEqualTo("2003/04/26");
 } catch (AssertionError e) {
   assertThat(e).hasMessage("Failed to parse 2003/04/26 with any of these date formats: " +
                            "[yyyy-MM-dd'T'HH:mm:ss.SSS, yyyy-MM-dd'T'HH:mm:ss, yyyy-MM-dd]");
 }

 // registering a custom date format to make the assertion pass
 registerCustomDateFormat(new SimpleDateFormat("yyyy/MM/dd")); // registerCustomDateFormat("yyyy/MM/dd") would work to.
 assertThat(date).isEqualTo("2003/04/26");

 // the default formats are still available and should work
 assertThat(date).isEqualTo("2003-04-26");
```
    Parameters:
    userCustomDateFormat - the new Date format used for String based Date assertions.
  - registerCustomDateFormat
```
public static void registerCustomDateFormat(String userCustomDateFormatPattern)
```
    Add the given date format to the ones used to parse date String in String based Date assertions like AbstractDateAssert.isEqualTo(String).
    User date formats are used before default ones in the order they have been registered (first registered, first used).
    AssertJ is gonna use any date formats registered with one of these methods :
    Beware that AssertJ will use the newly registered format for all remaining Date assertions in the test suite
    To revert to default formats only, call useDefaultDateFormatsOnly() or AbstractDateAssert.withDefaultDateFormatsOnly().
    Code examples:
```
 Date date = ... // set to 2003 April the 26th
 assertThat(date).isEqualTo("2003-04-26");

 try {
   // date with a custom format : failure since the default formats don't match.
   assertThat(date).isEqualTo("2003/04/26");
 } catch (AssertionError e) {
   assertThat(e).hasMessage("Failed to parse 2003/04/26 with any of these date formats: " +
                            "[yyyy-MM-dd'T'HH:mm:ss.SSS, yyyy-MM-dd'T'HH:mm:ss, yyyy-MM-dd]");
 }

 // registering a custom date format to make the assertion pass
 registerCustomDateFormat("yyyy/MM/dd");
 assertThat(date).isEqualTo("2003/04/26");

 // the default formats are still available and should work
 assertThat(date).isEqualTo("2003-04-26");
```
    Parameters:
    userCustomDateFormatPattern - the new Date format pattern used for String based Date assertions.
  - useDefaultDateFormatsOnly
```
public static void useDefaultDateFormatsOnly()
```
    Remove all registered custom date formats => use only the defaults date formats to parse string as date.
    Beware that the default formats are expressed in the current local timezone.
    Defaults date format are:
    - yyyy-MM-dd'T'HH:mm:ss.SSS
    - yyyy-MM-dd HH:mm:ss.SSS (for Timestamp String representation support)
    - yyyy-MM-dd'T'HH:mm:ss
    - yyyy-MM-dd
    Example of valid string date representations:
    - 2003-04-26T03:01:02.999
    - 2003-04-26 03:01:02.999
    - 2003-04-26T13:01:02
    - 2003-04-26
  - useRepresentation
```
public static void useRepresentation(Representation customRepresentation)
```
    Register a Representation that will be used in all following assertions.
    Representation are used to format types in assertions error messages.
    Example :
```
 private class Example {}

 private class CustomRepresentation extends StandardRepresentation {
 
   // override needed to hook specific formatting  
   @Override
   public String toStringOf(Object o) {
     if (o instanceof Example) return "Example";
     // fallback to default formatting.  
     return super.toStringOf(o);
   }
   
   // change String representation  
   @Override
   protected String toStringOf(String s) {
     return "$" + s + "$";
   }
 }
 
 Assertions.useRepresentation(new CustomRepresentation());
 
 // this assertion fails ...  
 assertThat(new Example()).isNull();
 // ... with error :
 // "expected:<[null]> but was:<[Example]>"
 
 // this one fails ... 
 assertThat("foo").startsWith("bar");
 // ... with error :
 // Expecting:
 //   <$foo$>
 // to start with:
 //   <$bar$>
```
    Since:
    
    2.5.0 / 3.5.0
  - useDefaultRepresentation
```
public static void useDefaultRepresentation()
```
    Fallback to use StandardRepresentation to revert the effect of calling useRepresentation(Representation).
    
    Since:
    
    2.5.0 / 3.5.0

Class Assertions

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Assertions

Method Detail

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThat

assertThatThrownBy

catchThrowable

setRemoveAssertJRelatedElementsFromStackTrace

fail

fail

failBecauseExceptionWasNotThrown

shouldHaveThrown

setMaxLengthForSingleLineDescription

extractProperty

extractProperty

tuple

setAllowExtractingPrivateFields

setAllowComparingPrivateFields

entry

atIndex

offset

offset

within

withPrecision

within

withPrecision

within

within

within

within