Kodein DI & KotlinTest

Transcript

2. Víctor González Android Developer @iSalud.com
3. Víctor González Android Developer @iSalud.com @vic.gonzi
4. KOtlin DEpendency INjection
5. KOtlin DEpendency INjection?
6. KOtlin DEpendency INjection?
7. • Dependency retrieval container • Funciona en JVM, Android, JS, y plataformas nativas (como iOS) • Uso extensivo de inline y Kotlin DSL • Versión 5.0.0 estable Introducción a Kodein-DI
8. val kodein = Kodein { bind<Random>() with singleton { Random() } }
 
 class MyKodeinClient(private val kodein: Kodein) { private val random: Random by kodein.instance() } Un ejemplo ‘hello world’
9. val kodein = Kodein { bind<Random>() with singleton { Random() } }
 
 class MyKodeinClient(private val kodein: Kodein) { private val random: Random by kodein.instance() } Un ejemplo básico
10. val randomModule = Kodein.Module { bind<Random>() with singleton { Random() } }
 
 fun retrofitModule(baseUrl: String) = Kodein.Module { bind<Retrofit>() with singleton { Retrofit.Builder() .baseUrl(baseUrl) .build() } } Módulos en Kodein Pueden depender unos de otros. No hay que preocuparse del orden de inicialización.
11. class App : Application(), KodeinAware { override val kodein = Kodein.lazy { import(androidModule(this@App)) import(retrofitModule(baseUrl) } } // No Android val kodein = Kodein { import(…) import(…) } Uso de módulos
12. class App : Application(), KodeinAware { override val kodein = Kodein.lazy { import(androidModule(this@App)) import(retrofitModule(baseUrl) } } // No Android val kodein = Kodein { import(…) import(…) } Uso de módulos
13. • Provee todos los SystemService • Directorios de caché • SharedPreferences • Resources y assets • ContentResolver, MainLooper, etc.. androidModule
14. class MyActivity : Activity(), KodeinAware { override val kodein by closestKodein() private val random: Random by kodein.instance() } Obtención de las dependencias • closestKodein() funciona directamente en cualquier clase Android. • Se usará closestKodein(context) para clases no Android
15. val randomModule = Kodein.Module { bind<Random>() with singleton { Random() } } val randomDirectModule = Kodein.Module { bind() from singleton { Random() } } Binding tipado vs directo
16. val module = Kodein.Module { bind<Random>() with singleton { Random() } bind<Int>("randomInt") with provider { instance<Random>().nextInt()} constant(“baseUrl") with "https://www.company.com/api" } Tagged bindings / constants
17. val dataModule = Kodein.Module { bind<OkHttpClient>() with singleton { OkHttpClient.newBuilder().build() } bind<Retrofit>() with singleton { Retrofit.Builder() .baseUrl(baseUrl) .client(instance()) .build() } } Dependencias transitivas
18. val randomModule = Kodein.Module { bind<Random>() with provider { Random() } } val retrofitModule = Kodein.Module { bind<Retrofit>() with factory { baseUrl: String -> Retrofit.Builder() .baseUrl(baseUrl) .build() } } Providers y factories
19. • eagerSingleton • multiton • instance • refSingleton (softReference, weakReference, threadLocal) Otros binders
20. class MyActivity : Activity(), KodeinAware { private val _parentKodein by closestKodein() override val kodein: Kodein = Kodein.lazy { extend(_parentKodein) bind() from provider { MainPresenter(this@MainActivity, instance(), instance(), instance()) } } val presenter: MainPresenter by instance() } Submódulos en Android
21. val randomModule = Kodein.Module { bind<MainPresenter>() with scoped(androidScope<Activity>()).singleton { MainPresenter(…) } bind<OtherPresenter>() with scoped(androidRetainedScope<Activity>()) .singleton { OtherPresenter(…) } } Scopes en Android
22. • Extensión de Kodein DI: Global & ConfigurableKodein. • Permite tener diferentes contenedores Kodein. • ConfigurableKodein permite añadir y quitar módulos dinámicamente: uso en tests. • Karumi ofrece un ejemplo en https://github.com/Karumi/ kodein-sample-testing Tests unitarios y de instrumentación
23. Ejemplo práctico
 Bandhook-Kotlin
 Dagger vs Kodein
24. • Ventajas frente a Dagger: • Drástica reducción de la verbosidad. • Aprendizaje más fácil para programadores no experimentados en DI. • Inconvenientes: • Se pierde la validación en tiempo de compilación. • Mayor coste de integración en código Java. Kodein vs Dagger
25. • Kodein ofrece una alternativa a Dagger, rápida y fácil de aprender y utilizar. • Dagger sigue siendo sólido y ofrece errores en tiempo de compilación cuando hay inyecciones mal hechas. Conclusiones
26. Q & A www.kodein.org https://kotlinlang.slack.com/messages/kodein/
28. @Test fun testTransformAlbums_withValidArtists() { // When val albums = albumMapper.transform(lastFmValidAlbums) // Then assertEquals(2, albums.size) assertEquals(lastFmValidAlbums[0].mbid, albums[0].id) assertEquals(lastFmValidAlbums[1].mbid, albums[1].id) } Motivación: tests en jUnit 4
29. @Test fun testTransformAlbums_withValidArtists() { // When val albums = albumMapper.transform(lastFmValidAlbums) // Then assertEquals(2, albums.size) assertEquals(lastFmValidAlbums[0].mbid, albums[0].id) assertEquals(lastFmValidAlbums[1].mbid, albums[1].id) } Motivación: tests en jUnit 4
30. • Spock • Spek framework • jUnit 5 (estable desde septiembre de 2017) Alternativas a jUnit 4
31. on("transforming two valid albums") { val albums = albumMapper.transform(lastFmValidAlbums) it("should get an album list with two items") { assert(albums.size == 2) } it("should get expected first item in albums list") { assert(albums[0].id == lastFmValidAlbums[0].mbid) } it("should get expected second item in albums list") { assert(albums[1].id == lastFmValidAlbums[1].mbid) } } Ejemplo en Spek
32. class AlbumMapperTest { @Before fun setUp() {…} @Test fun testA() {…} @Test fun testB() {…} @Test fun testC() {…} } jUnit 4 vs Spek
33. class AlbumMapperSpekTest : Spek({ given("some conditions")) { beforeEachTest {…} on(“doing something") { // Any action it("should meet assertion A") { // An assertion } it("should meet assertion B") { // Another assertion } } } }) jUnit 4 vs Spek
34. Ejemplo práctico
 Bandhook-Kotlin
 jUnit 4 vs Spek
35. • Funciona sobre jUnit5 • Integración fácil en Android Studio 3.2 
 (Canary 4) • Última versión lanzada 3.1.2
 Spek continúa en 1.1.5 KotlinTest
36. class MyStringSpec : StringSpec({ "strings.length should return size of string" { "hello".length shouldBe 5 } }) class MyFunSpec : FunSpec({ test("String.length should return the length of the string") { "sammy".length shouldBe 5 "".length shouldBe 0 } }) class MyShouldSpec : ShouldSpec({ should("return the length of the string") { "sammy".length shouldBe 5 "".length shouldBe 0 } }) Specs básicos
37. class AlbumMapperTest : BehaviorSpec({ given("some conditions")) { // Before all tests When(“doing something") { // Any action Then("should meet assertion A") { // An assertion } Then(“should meet assertion B") { // Another assertion } } } }) BehaviorSpec
38. class AlbumMapperTest : DescribeSpec({ describe("some conditions")) { // Before all tests context(“doing something") { // Any action it("should meet assertion A") { // An assertion } it(“should meet assertion B") { // Another assertion } } } }) DescribeSpec
39. • Como función de extensión “hello".length.shouldBe(5) • Como función infix "hello".length shouldBe 5 Matchers
40. • Lógicos (true/false) • Strings • Int, Long, Double, Float • Colecciones y mapas • … Matchers incluidos en KotlinTest
41. fun startsWithA() = object : Matcher<String> { override fun test(value: String) = Result( value.startsWith("a"), "String $value should start with a", "String $value should not start with a” )} "abc" should startsWithA() "xyz" shouldNot startsWithA() Custom matchers
42. val strings = listOf("abc", "def", "ghi") forAll(strings) { x -> x should haveLength(3) } forAll, forNone, forOne, forAtMostOne, forAny, forExactly(n)… Inspectores
43. "multiplication table" { val myTable = table( headers("a", "b", "result"), row(9, 1, 9), row(9, 2, 18), row(9, 3, 27) ) forAll(myTable) { a, b, result -> a * b shouldBe result } } Table-driven test
44. class PropertyExample: StringSpec( { "String size" { assertAll({ a: String, b: String -> (a + b).length shouldBe a.length + b.length }) } }) • Repeticiones generadas automáticamente • 1000 por defecto Property testing
45. • KotlinTest provee generadores para los tipos más comunes. • Permite crear generadores propios: class MyIntGenerator : Gen<Int> { override fun constants() = listOf(1, 2, 3) override fun random() = generateSequence { Math.random().toInt() } } Property testing
46. • Tags y grupos por tags • Tests de futuros • Extensiones para Arrow • … Y mucho más…
47. • El uso extensivo de DSL y funciones infix nos permite aumentar la legibilidad de los tests. • jUnit 5 (y todos los frameworks basados en él) ofrecen posibilidades mucho más potentes que jUnit 4. Conclusiones
48. Q & A