BBL JUnit 5

Juillet 2017

Erwann Thebault - @ethebault

Inspiré du quickie

Benoit Averty - @Kaidjin

Le doute est le signe de la certitude.

Citation de Alain, Propos sur l'éducation (1932)

JUnit 4

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.???</version>
</dependency>

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>

4.12 ->Décembre 2014
4.0 -> Février 2006

Nombre de projets utilisant le framework parmi les 3862 premiers projets sur github

JUnit 5

Kickstarter en 2015
Première milestone en Juillet 2016
Release prévue pour le troisième trimestre !

Text

API de test

Plateforme Junit

Retrocompatibilité JUnit 4

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.0.0-M4</version>
</dependency>

@Test
public void myFirstTest(){
    // Ça change pas trop !!!
}

@BeforeAll
static void initAll() {
}

@BeforeEach
void init() {
}

@Test
public void myFirstTest(){
    // Ça change pas trop !!!
}

@AfterEach
void tearDown() {
}

@AfterAll
static void tearDownAll() {
}

@BeforeAll
static void initAll() {
}

@BeforeEach
void init() {
}

@Test
public void myFirstTest(){
    // Ça change pas trop !!!
}

@AfterEach
void tearDown() {
}

@AfterAll
static void tearDownAll() {
}

BeforeClass

Before

After

AfterClass

@Test
@Ignore
public void myFirstTest(){
    // Ça change pas trop !!!
}

@Test
@Disabled
public void myFirstTest(){
    // Ça change pas trop !!!
}

JUnit4

JUnit5

@Test
public void shouldWorkBecauseItWorksOnMyComputer(){

}

@Test
public void should_work_because_it_works_on_my_computer(){

}

camelCase

snake_case

CamelCase ou snake_case ?

@Test
@DisplayName("Avec plein d'emoj, ca ne peut que marcher \uD83D\uDC30 \uD83D\uDC31 \uD83D\uDC3C \uD83D\uDC19")
public void shouldWorkBecauseThereAreEmoji(){

}

JUnit 5

public class MyTest {

    @BeforeEach
    public void setup() {}

    @Nested
    class NominalTest{

        @BeforeEach
        public void setup(){}

        @Test
        public void test(){}
    }

    @Nested
    class InvalidInputTest{

        @BeforeEach
        public void setup(){}

        @Test
        public void test(){}

    }

    @Test
    public void test(){
    }

}

Tests imbriqués

@RepeatedTest(10)
@DisplayName("Test en répétition")
public void isInferiorTo5(TestInfo testInfo, RepetitionInfo repetitionInfo){
    int value = 5;

    System.out.print("Test "+ testInfo.getTestMethod().get().getName()
            + "( " +  repetitionInfo.getCurrentRepetition() 
            + " de " + repetitionInfo.getTotalRepetitions() +" )");
    assertThat(5).isGreaterThan(repetitionInfo.getCurrentRepetition());
}

Repeated test

Test paramétrés

@RunWith(Parameterized.class)
public class FibonacciTest {

    @Parameterized.Parameters(name = "{index}: fib({0})={1}")
    public static Iterable<Object[]> data() {
        return Arrays.asList(new Object[][] {
                 { 0, 0 }, { 1, 1 }, { 2, 1 }, { 3, 2 },
                     { 4, 3 }, { 5, 5 }, { 6, 8 }
           });
    }

    private int input;
    private int expected;

    public FibonacciTest(int input, int expected) {
        this.input = input;
        this.expected = expected;
    }

    @Test
    public void test() {
        Assert.assertEquals(expected, Fibonacci.compute(input));
    }
}

JUnit 4 : Passage par constructeur

@RunWith(Parameterized.class)
public class Fibonacci2Test {

    @Parameterized.Parameters(name = "{index}: fib({0})={1}")
    public static Iterable<Object[]> data() {
        return Arrays.asList(new Object[][] {
                 { 0, 0 }, { 1, 1 }, { 2, 1 }, { 3, 2 }, { 4, 3 }, { 5, 5 }, { 6, 8 }
           });
    }

    @Parameterized.Parameter // first data value (0) is default
    public int fInput;

    @Parameterized.Parameter(1)
    public int fExpected;

    @Test
    public void test() {
        Assert.assertEquals(fExpected, Fibonacci.compute(fInput));
    }
}

JUnit 4 : Passage par injection

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-params</artifactId>
    <version>5.0.0-M4</version>
</dependency>

@ParameterizedTest
@ValueSource(ints = { 1, 2, 3 })
void testWithValueSource(int argument) {
    assertNotNull(argument);
}

JUnit 5 : Injection de valeurs primitives

@ParameterizedTest
@EnumSource(TimeUnit.class)
void testWithEnumSource(TimeUnit timeUnit) {
    assertNotNull(timeUnit.name());
}

JUnit 5 : Injection d'une énumération

@ParameterizedTest
@MethodSource(names = "stringAndIntProvider")
void testWithMultiArgMethodSource(int input, int expected) {
    assertEquals(expected, Fibonacci.compute(input));
}

static Stream<Arguments> stringAndIntProvider() {
    return Stream.of(
            new int[]{0, 0}, new int[]{1, 1}, new int[]{2, 1}, 
                new int[]{3, 2}, new int[]{4, 3}, new int[]{5, 5}, new int[]{6, 8})
        .map( prop ->  ObjectArrayArguments.create(prop[0],prop[1]));
}

JUnit5 : Injection par une méthode provider

@ParameterizedTest
@ArgumentsSource(MyArgumentsProvider.class)
void testWithMultiArgMethodSource(int input, int expected) {
    assertEquals(expected, Fibonacci.compute(input));
}

static class MyArgumentsProvider implements ArgumentsProvider {
    @Override
    public Stream<? extends Arguments> arguments(ContainerExtensionContext context) {
        return Stream.of(
                new int[]{0, 0}, new int[]{1, 1}, new int[]{2, 1},
                new int[]{3, 2}, new int[]{4, 3}, new int[]{5, 5}, new int[]{6, 8})
            .map( prop ->  ObjectArrayArguments.create(prop[0],prop[1]));
    }
}

JUnit5 : Injection par un provider d'argument

@ParameterizedTest
@CsvSource({ "0,0","1,1", "2,1", "3,2", "4,3", "5,5", "6,8"})
void testWithCsvSource(int input, int expected) {
    assertEquals(expected, Fibonacci.compute(input));
}

JUnit5 : Injection par CSV

JUnit5 : Injection par fichier CSV

@ParameterizedTest
@CsvFileSource(resources = "/fibo.csv")
void testWithCsvSource(int input, int expected) {
    assertEquals(expected, Fibonacci.compute(input));
}

Test Factory

@TestFactory
Stream<DynamicTest> dynamicTestsFromCollection() {

    Fibonacci fibo = new Fibonacci();
    return Stream.of(new int[]{0, 0}, new int[]{1, 1}, new int[]{2, 1},
             new int[]{3, 2}, new int[]{4, 3}, new int[]{5, 5}, new int[]{6, 8})
            .map(
                    input ->
                            dynamicTest("Compute fibonacci for " + input[0], 
                                () -> assertEquals(input[1], fibo.compute(input[0])))
            );

}

Evolution des assertions

@Test
public void myFirstTest(){
    org.junit.Assert.assertEquals(2, 1 + 1);
}

@Test
public void myFirstTest(){
    org.junit.jupiter.api.Assertions.assertEquals(2, 1 + 1);
}

JUnit4

JUnit5

@Test
void myFirstTest(){
    assertEquals("vendredi", "lundi",
         () -> "oh non, on est que lundi");
}

JUnit5

@Test
public void myFirstTest(){
    // base sur Hamcrest
    Assert.assertThat(Arrays.asList("Junit", "TestNG"), 
        CoreMatchers.hasItem("Junit"));
}

@Test
public void myFirstTest(){
    assertThat(Arrays.asList("JUnit", "TestNG")).contains("JUnit");
}

JUnit4

AssertJ

@Test
public void testURL() throws MalformedURLException {
    assertThat(new URL("http://google.fr")).hasNoPort();
    assertThat(new URL("http://google.fr")).hasHost("google.fr");
    assertThat(new URL("http://google.fr")).hasNoUserInfo();
}

@Test
public void testFile(){
    assertThat(new File("sampling.txt")).exists();
    assertThat(new File("sampling.txt")).isFile();
}

AssertJ

@Test
public void testInt(){
    assertThat(25).isBetween(12,45);
    assertThat(25).isCloseTo(20, Offset.offset(5));
}

AssertJ

@Test(expected = NullPointerException.class)
public void myFisrtTestWithException(){
    String value = null;
    value.split(";");
}

@Rule
public ExpectedException exception = ExpectedException.none();

@Test
public void myFirstTestException(){
    exception.expect(IllegalArgumentException.class);
    exception.expectMessage(
        CoreMatchers.containsString("Invalid age"));

    throw new IllegalArgumentException("Invalid age");
}

Junit 4 : gestion d'exception

Junit 4 : gestion d'exception avancée

Throwable exception = assertThrows(IllegalArgumentException.class, 
    () -> {
            throw new IllegalArgumentException("Invalid age");
    }
);
assertEquals("Invalid age", exception.getMessage());

JUnit 5 : gestion d'exception

@Test(timeout = 10000)
public void testLast10s(){
    // too long !!!        
}

JUnit 4 : timeout unitaire

@Rule
public Timeout timeout = Timeout.seconds(10);

@Test
public void testLast10s2() throws InterruptedException {
    TimeUnit.SECONDS.sleep(15);
}

JUnit 4 : timeout global

@Test
public void timeoutNotExceeded(){
    assertTimeout(ofSeconds(5), () -> {
        TimeUnit.SECONDS.sleep(10);
    });
}

JUnit 5 : timeout

@Test
void timeoutNotExceededWithResult() {
    String actualResult = assertTimeout(ofSeconds(5), () -> {
        return "a result";
    });
    assertEquals("a result", actualResult);
}

JUnit 5 : timeout avec retour de valeur

@Test
void timeoutExceededWithPreemptiveTermination() {
    assertTimeoutPreemptively(ofSeconds(2), () -> {
        TimeUnit.SECONDS.sleep(5);
    });
}

JUnit 5 : timeout avec arrêt préemptif

@Test
public void testAssertAll(){
    assertAll("address",
            () -> assertEquals("JUnit", "JUnit1"),
            () -> assertEquals("TestNG", "TestNG"),
            () -> assertEquals("EasyMock", "Mockito")
    );
}

Assertions groupées

Expected :JUnit
Actual   :JUnit1
 <Click to see difference>




Expected :EasyMock
Actual   :Mockito
 <Click to see difference>



org.opentest4j.MultipleFailuresError: address (2 failures)
	expected: <JUnit> but was: <JUnit1>
	expected: <EasyMock> but was: <Mockito>

Résultat

Extensions

@RunWith(MockitoJUnitRunner.class)
public class MyMockitoTest {

    @Mock
    private Fibonacci fiBoMock;

    @Test
    public void should_be_verified() {

        //Given
        Mockito.when(fiBoMock.compute(1)).thenReturn(1);
        
        //When
        int compute = fiBoMock.compute(1);

        //Then
        Assert.assertEquals(1, compute);
        Mockito.verify(fiBoMock, Mockito.times(1)).compute(1);

    }
}

JUnit 4 : Mockito

@RunWith(MockitoJUnitRunner.class)
@RunWith(SpringJUnit4ClassRunner.class)
public class MyMockitoTest {

    @Mock
    private Fibonacci fiBoMock;

    @Test
    public void should_be_verified() {

        //Given
        Mockito.when(fiBoMock.compute(1)).thenReturn(1);
        
        //When
        int compute = fiBoMock.compute(1);

        //Then
        Assert.assertEquals(1, compute);
        Mockito.verify(fiBoMock, Mockito.times(1)).compute(1);

    }
}

JUnit 4 : Mockito

Un seul runner a la fois

@RunWith(MockitoJUnitRunner.class)
@RunWith(SpringJUnit4ClassRunner.class)
public class MyMockitoTest {

    @Mock
    private Fibonacci fiBoMock;

    @Before
    public void setup() {
        MockitoAnnotations.initMocks(this);
    }

    @Test
    public void should_be_verified() {

        //Given
        Mockito.when(fiBoMock.compute(1)).thenReturn(1);
        
        //When
        int compute = fiBoMock.compute(1);

        //Then
        Assert.assertEquals(1, compute);
        Mockito.verify(fiBoMock, Mockito.times(1)).compute(1);

    }
}

JUnit 4 : Mockito

Initialisation manuelle

@ExtendWith(MockitoExtension.class)
public class MyMockitoTest {

    @Mock
    private Fibonacci fiBoMock;

    @Test
    public void should_be_verified() {

        //Given
        Mockito.when(fiBoMock.compute(1)).thenReturn(1);

        //When
        int compute = fiBoMock.compute(1);

        //Then
        Assertions.assertEquals(1, compute);
        Mockito.verify(fiBoMock, Mockito.times(1)).compute(1);

    }

}

JUnit 5 : Mockito

@ExtendWith(AnotherExtension.class)
@ExtendWith(MockitoExtension.class)
public class MyMockitoTest {

    @Mock
    private Fibonacci fiBoMock;

    @Test
    public void should_be_verified() {

        //Given
        Mockito.when(fiBoMock.compute(1)).thenReturn(1);

        //When
        int compute = fiBoMock.compute(1);

        //Then
        Assertions.assertEquals(1, compute);
        Mockito.verify(fiBoMock, Mockito.times(1)).compute(1);

    }

}

JUnit 5 : Mockito

Pas de limitation

à une extension

Intégration aux outils

Runtime

Java 8

IDE

Intellij Idea 2016.2
Eclipse 4.7 (Oxygen) (Beta)

Intégration à Maven

...
<build>
    <plugins>
        ...
        <plugin>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.19</version>
            <dependencies>
                <dependency>
                    <groupId>org.junit.platform</groupId>
                    <artifactId>junit-platform-surefire-provider</artifactId>
                    <version>1.0.0-M4</version>
                </dependency>
                <dependency>
                    <groupId>org.junit.jupiter</groupId>
                    <artifactId>junit-jupiter-engine</artifactId>
                    <version>5.0.0-M4</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>
...
<dependencies>
    ...
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.0.0-M4</version>
        <scope>test</scope>
    </dependency>
</dependencies>
...

Compatibilité JUnit4 avec JUnit5

<dependency>
    <groupId>org.junit.vintage</groupId>
    <artifactId>junit-vintage-engine</artifactId>
    <version>4.12.0-M4</version>
    <scope>test</scope>
</dependency>

Limitation au niveau des Rules

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-migrationsupport</artifactId>
    <version>5.0.0-M4</version>
</dependency>

Compatibilité JUnit5 avec JUnit4

<!-- run Junit5 tests with JUnit 4 -->
<dependency>
    <groupId>org.junit.platform</groupId>
    <artifactId>junit-platform-runner</artifactId>
    <version>1.0.0-M4</version>
</dependency>

@RunWith(JUnitPlatform.class)
public class JunitPlateformRunnerTest {

    @org.junit.jupiter.api.Test
    public void should_be_true(){
        Assertions.assertTrue(true);
    }

}

Conclusion

Pas de changement révolutionnaire
Sémantique plus claire
Mais
- API en évolution
- Intégrations incomplètes
- Extensions limitées

BBL JUnit 5

Inspiré du quickie

Le doute est le signe de la certitude.

JUnit 4

JUnit 5

JUnit 5

Test paramétrés

Test Factory

Evolution des assertions

Extensions

Intégration aux outils

Runtime

IDE

Intégration à Maven

Compatibilité JUnit4 avec JUnit5

Compatibilité JUnit5 avec JUnit4

Conclusion

Merci