JUnit Day

In February 16th, 2006, the library known as JUnit 4 is released.

JUnit4 is adopted quickly, and in geometric rate takes control of all unit testing in JAVA.

In September 10th of 2017, the Resistance sends back in time a reprogrammed version of JUnit to protect humanity.

This day is known as JUnit5 Day.

Transcript

1. In February 16th, 2006, the library known as JUnit 4 is released _
2. JUnit4 is adopted quickly, and in geometric rate takes control of all unit testing in JAVA _
3. In September 10th of 2017, the Resistance sends back in time a reprogrammed version of JUnit to protect humanity _
4. JUNIT 5 DAY
7. JUNIT 5 STRUCTURE
8. JUNIT 5 STRUCTURE JUnit 5 Platform JUnit 5 Jupiter JUnit 5 Launcher JUnit 5 Params JUnit 5 Vintage
9. 1. LIQUID MOLECULAR BRAIN
10. testImplementation "junit:junit:${junitVersion}"// JUnit4 Library testImplementation "org.junit.jupiter:junit-jupiter:${junit5Version}"
11. JUNIT 5 COMPONENTS
12. TOUCH THE LAND RUNNING Replace With import org.junit.Test import org.junit.jupiter.api.Test import org.junit.Before import org.junit.jupiter.api.BeforeEach @Before @BeforeEach import org.junit.After import org.junit.jupiter.api.AfterEach @After @AfterEach import org.junit.BeforeClass import org.junit.jupiter.api.BeforeAll @BeforeClass @BeforeAll import org.junit.AfterClass import org.junit.jupiter.api.AfterAll @AfterClass @AfterAll import org.junit.Ignore import org.junit.jupiter.api.Disabled @Ignore @Disabled
13. JUNIT 5 LIFECYCLE @BeforeAll @BeforeEach @Test @AfterEach @AfterAll
14. NO MORE RUNNERS
15. NO MORE RUNNERS @RunWith(MockitoJUnitRunner::class) class JUnit4RunnerTest { @Mock lateinit var mock : UserDao @Test fun `Whatever random test this is`() { /.../ } }
16. WHAT TO RUN WITH, THEN? testImplementation "junit:junit:${junitVersion}" testImplementation "org.junit.jupiter:junit-jupiter:${junit5Version}" testImplementation "org.mockito:mockito-junit-jupiter:${mockitoJupiterVersion}"
17. USING MOCKITO EXTENSION @ExtendWith(MockitoExtension::class) @MockitoSettings(strictness = LENIENT) class JUnit5ExtensionTest { @Mock lateinit var mock : UserDao @Test fun `Whatever random test this is`() { /.../ } }
18. HOW TO DEFINE AN EXTENSION class UTCExtension : BeforeEachCallback, AfterEachCallback { private lateinit var originalTimeZone: TimeZone override fun beforeEach(context: ExtensionContext?) { originalTimeZone = TimeZone.getDefault() TimeZone.setDefault(TimeZone.getTimeZone("UTC")) } override fun afterEach(context: ExtensionContext?) { TimeZone.setDefault(originalTimeZone) } }
19. HOW TO DEFINE AN EXTENSION AfterAllCallback AfterEachCallback AfterEachMethodAdapter AfterTestExecutionCallback BeforeAllCallback BeforeEachCallback BeforeEachMethodAdapter BeforeTestExecutionCallback ExecutionCondition InvocationInterceptor LifecycleMethodExecutionExceptionHandler ParameterResolver TestExecutionExceptionHandler TestInstanceFactory TestInstancePostProcessor TestInstancePreDestroyCallback TestTemplateInvocationContextProvider TestWatcher
20. APPLYING OUR EXTENSIONS @ExtendWith(MockitoExtension::class, UTCExtension::class) class JUnit5ExtensionTest { @Mock lateinit var mock : UserDao @Test fun `Whatever random test this is`() { /.../ } }
21. CHECKING FOR EXCEPTIONS // Java @Test public void throwsUnauthorizedException() throws Exception { enqueueMockResponseFromFile(401, "common/errors/error-unauthorized.json") assertThrows(UnauthorizedException.class, () -> apiClient.get("id")); } // Kotlin @Test fun `Throws unauthorized exception`() { enqueueMockResponseFromFile(401, "common/errors/error-unauthorized.json") assertThrows<UnauthorizedException> { apiClient.get("id") } }
22. 2. MIMETIC POLYALLOY
23. RUNNING TESTS testImplementation "junit:junit:${junitVersion}" testImplementation "org.junit.jupiter:junit-jupiter:${junit5Version}" testImplementation "org.mockito:mockito-junit-jupiter:${mockitoJupiterVersion}" testRuntimeOnly("org.junit.platform:junit-platform-launcher") testRuntimeOnly "org.junit.vintage:junit-vintage-engine:${junit5Version}"
24. ROBOLECTRIC & ESPRESSO @RunWith(RobolectricTestRunner::class) abstract class RobolectricTest @RunWith(AndroidJUnit4::class) abstract class EspressoTest
25. 3. FULLY AUTONOMY
26. PARALELLIZING TESTS src/test/resources/junit-platform.properties junit.jupiter.execution.parallel.enabled=true junit.jupiter.execution.parallel.mode.default=concurrent junit.jupiter.execution.parallel.mode.classes.default=concurrent junit.jupiter.execution.parallel.config.strategy=dynamic
27. PARALELLIZING TESTS @Execution(ExecutionMode.SAME_THREAD) class SequentialExecutingTest { @Test @Execution(ExecutionMode.CONCURRENT) fun `Parallel test A`() @Test @Execution(ExecutionMode.CONCURRENT) fun `Parallel test N`() }
28. Parallel enabled false true Classes default Same thread Concurrent Same thread Concurrent fixed dynamic Mode default strategy Disable parallelism Enable parallelism Execute test classes sequentially Parallelize test classes Execute test methods sequentially Parallelize test methods Fixed number of threads Dynamic number of threads
29. PARALELLIZING THE STAGE class A { @Test fun test1() {...} @Test fun test2() {...} } class B { @Test fun test1() {...} @Test fun test2() {...} }
30. COMPARISON BETWEEN CONFIGS A.test1 A.test2 B.test1 B.test2 A.test1 B.test1 A.test2 B.test2 A.test1 A.test2 B.test1 B.test2 A.test1 A.test2 B.test1 B.test2 Class: concurrent Method: same_thread Class: same_thread Method: concurrent Class: concurrent Method: concurrent Class: same_thread Method: same_thread
31. EASING THE DRAWBACKS OF PARALELLIZING @ExtendWith(UTCExtension::class, LocaleExtension::class) @ResourceLocks( ResourceLock(TIME_ZONE, mode = READ_WRITE), ResourceLock(LOCALE, mode = READ_WRITE) ) class ParallelTestWhichUsesTZAndLocale { /*...*/ }
32. EASING THE DRAWBACKS OF PARALELLIZING @Isolated @ExtendWith(UserAgentExtension::class) open class MockWebServerTest : RecordedRequests { protected lateinit var server: MockWebServer @BeforeEach open fun setUp() { this.server = MockWebServer() this.server.start() } /.../ }
33. 4. PARAMETRIC TESTS
34. NORMAL TESTS class ApiExceptionMapperTest { @Test fun `Throws Network exception when receiving a 400 status code`() @Test fun `Throws Network exception when receiving a 412 status code`() @Test fun `Throws Network exception when receiving a 418 status code`() @Test fun `Throws Network exception when receiving a 500 status code`() }
35. ADDING PARAMETRICS testImplementation "junit:junit:${junitVersion}" testImplementation "org.junit.jupiter:junit-jupiter:${junit5Version}" testImplementation "org.mockito:mockito-junit-jupiter:${mockitoJupiterVersion}" testImplementation "org.junit.jupiter:junit-jupiter-params:${junit5Version}" testRuntimeOnly("org.junit.platform:junit-platform-launcher") testRuntimeOnly "org.junit.vintage:junit-vintage-engine:${junit5Version}"
36. PARAMETRIC TESTS class ApiExceptionMapperTest { @ParameterizedTest(name = "Throws Network Exception when receiving {0} status code") @ValueSource( ints = [ HttpStatus.SC_BAD_REQUEST, HttpStatus.SC_REQUEST_TOO_LONG, HttpStatus.SC_IM_A_TEAPOT, HttpStatus.SC_INTERNAL_SERVER_ERROR ] ) fun `Throws Newtork Exception when receiving code `(status: Int) }
37. PARAMETRIC TESTS
38. TYPES OF DATA @ValueSource @ParameterizedTest @NullSource @EmptySource @NullAndEmptySource short byte int long float double char String Class @EnumSource @MethodSource
39. MORE COMPLICATED PARAMETRIC TESTS class FieldTypeMapperTest { @Test fun `Parses correctly string phone number subtype`() { val result = mapper.map("string", "phone number") result shouldBe FieldType.PHONE } }
40. MORE COMPLICATED PARAMETRIC TESTS class FieldTypeMapperTestParameter( val type: String, val hint: String, val expectation: FieldType ) private companion object { @JvmStatic fun fieldTypeTestProvider() = listOf( FieldTypeMapperTestParameter("string", "phone-number", FieldType.PHONE), /.../ ) }
41. MORE COMPLICATED PARAMETRIC TESTS class FieldTypeMapperTest { @ParameterizedTest @MethodSource("fieldTypeTestProvider") fun `Parses correctly field`(parameter: FieldTypeMapperTestParameter) { val result = mapper.map(parameter.type, parameter.hint) assertEquals(parameter.expectation, result) } /.../ }
42. 5. NOT ENOUGH?
43. TEST TAGGING @Tag("core") @Tag("domain") class LoginUseCaseTest { @Tag("login") @Test fun `Performs login successfully when the credentials are correct`() @Tag("login") @Tag("error case") @Test fun `Returns error when receiving incorrect credentials`() }
44. NESTED TESTS @DisplayName("Login") class LoginUseCaseTest { @DisplayName("performs successfully when the credentials are correct") @Test fun `Performs login successfully when the credentials are correct`() @DisplayName("returns error") class OnErrors { @DisplayName("when receiving incorrect credentials") @Test fun `Returns error when receiving incorrect credentials`() @DisplayName("when server is down") @Test fun `Returns error when server is down`() } }
45. NESTED TESTS
46. THERE’S NO TEST BUT WHAT WE MAKE
47. WRITTEN & DIRECTED BY Saúl Díaz
48. THANKS! Any questions?