Assert return value of callable throwing exception #1652

@Test 
public void intendedApi() {
  int x = assertThatCode(this::doStuff)
    .describedAs("doing things")
    .doesNotThrowAnyException();
  assertThat(x).isEqualTo(3);
}

@Test
public void currentSolution1() {
  int x;
  try {
    x = doStuff();
  } catch (Exception e) {
    fail("doing things");
    return; // never reached; needed because fail() is not recognized by the java compiler as method exit
  }
  assertThat(x).isEqualTo(3);
}

@Test
public void currentSolution2() {
  AtomicReference<Integer> x = new AtomicReference<>();
  assertThatCode(() -> x.set(doStuff()))
    .describedAs("doing things")
    .doesNotThrowAnyException();
  assertThat(x.get()).isEqualTo(3);
}

// utility for demonstration purposes
public int doStuff() throws Exception {
  if (new Random().nextBoolean()) {
    throw new Exception();
  }
  return 3;
}