Csense kotlin test (mpp)

Installation

add this maven repo (into your repositories, either in the root build.gradle og the application's build.gradle)

repositories {
    maven {
        url 'https://pkgs.dev.azure.com/csense-oss/csense-oss/_packaging/csense-oss/maven/v1'
        name 'csense-oss'
    }
}

Then add the dependency

dependencies {
    implementation 'csense.kotlin:csense-kotlin-tests:0.0.59'
}

Intro

This library's focus is to provide a short, simple and easy to use test assertions and like. Its MPP which means it does not have a lot of fancy JVM (or other platform) stuff, but instead relies on very simple assertions; it is a fluent api, meaning that: Before

@Test
fun test() {
    assertEqual("is this expected?", "or is this actual?")
}

After

@Test
fun test() {
    "is this expected?".assert("or is this actual?")
}

These makes code read more like a sentence. It further also removes the confusion about expected vs actual, as you always start with what you have(the actual), which is a lot closer to how you would think ("is this the right result?")

Showcases

Double & float

margins

Before

val doubleToTest = 0.0
val expected = 1.0
val margin = 0.01 //since doubles are imprecise 
assertTrue(doubleToTest >= (expected - margin) && doubleToTest <= (expected + margin))

After

val doubleToTest = 0.0
val expected = 1.0
val margin = 0.01
doubleToTest.assert(expected, margin = margin)
//even the default assert has a margin of 0.1 (very loose)

There is even an "assertNot" with margins as well.

Collections

Before

size

val collectionToTest = listOf<String>()
assertEquals(0, collectionToTest.size)

After

val collectionToTest = listOf<String>()
collectionToTest.assertEmpty()

ordering

Before

val collectionToTest = listOf<String>()
assertTrue(collectionToTest.contains("test"))
assertTrue(collectionToTest.contains("test2"))

After

val collectionToTest = listOf<String>()
collectionToTest.assertContainsAll("test", "test2")