groovy.util

## Class GroovyAssert

- java.lang.Object
- - groovy.util.GroovyAssert

    public class GroovyAssert
    extends java.lang.Object

### Constructor Summary

Constructors
Constructor and Description
`GroovyAssert()`

### Method Summary

Methods
`static java.lang.Throwable` `shouldFail(java.lang.Class clazz, Closure code)` Asserts that the given code closure fails when it is evaluated and that a particular exception is thrown.
`static java.lang.Throwable` `shouldFail(Closure code)` Asserts that the given code closure fails when it is evaluated
`static java.lang.Throwable` `shouldFailWithCause(java.lang.Class clazz, Closure code)` Asserts that the given code closure fails when it is evaluated and that a particular exception can be attributed to the cause.

### Methods inherited from class java.lang.Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

### Constructor Detail

#### GroovyAssert

    public GroovyAssert()

### Method Detail

#### shouldFail

    public static java.lang.Throwable shouldFail(Closure code)

Asserts that the given code closure fails when it is evaluated

Parameters:
  `code` - the code expected to throw the exception
Returns:
  the message of the thrown Throwable

#### shouldFail

    public static java.lang.Throwable shouldFail(java.lang.Class clazz,
                                 Closure code)

Asserts that the given code closure fails when it is evaluated and that a particular exception is thrown.

Parameters:
  `clazz` - the class of the expected exception
  `code` - the closure that should fail
Returns:
  the message of the expected Throwable

#### shouldFailWithCause

    public static java.lang.Throwable shouldFailWithCause(java.lang.Class clazz,
                                          Closure code)

Asserts that the given code closure fails when it is evaluated and that a particular exception can be attributed to the cause. The expected exception class is compared recursively with any nested exceptions using getCause() until either a match is found or no more nested exceptions exist.

If a match is found the error message associated with the matching exception is returned. If no match was found the method will fail.

Parameters:
  `clazz` - the class of the expected exception
  `code` - the closure that should fail
Returns:
  the message of the expected Throwable