Kotlin with API tests

Маринский Рома
Test Automation Engineer
• IT-тусовщик
• Творю добро
• Езжу на электровелике и самокате

В плане
• Как было
• Почему Kotlin
• Вооружаемся инструментами
• Бросаем в бой Kotlin с API тестами
• Выводы

https://github.com/rmarinsky/kotlinRestAssured

Как было
Java 1.8
Gradle
Rest-Assured
jsonschema2pojo.org &&
RoboPOJOGenerator
Jackson2

JPet testPet = new JPet(null,
"Pet_" + this.randomString,
this.randomNumber,
null, null,
Status.AVAILABLE);
JPet petResponse = new JPetController().addNewPet(testPet);
Assert.assertEquals(testPet, petResponse);
Добавляем питомца в магазин Java

JPet testPet = new JPet(***);
JPetController petCtrl = new JPetController();
petCtrl.addNewPet(testPet);
petCtrl.deletePet(testPet);
JMessage messageResponse = petCtrl.getPet(testPet);
Assert.assertTrue(messageResponse.getMessage()
.equals("Pet not found"));
Удаление питомца из магазинa Java

И дальше было
Java 1.8
Gradle
Rest-Assured
jsonschema2pojo.org &&
RoboPOJOGenerator
Jackson2
assertjGen-gradle-plugin

JPet petResponse = new JPetController().addNewPet(testPet);
JPetAssert.assertThat(petResponse).isEqualTo(testPet);
Добавляем питомца в магазин Java
Assertions generated

JPetController petCtrl = new JPetController(testPet);
petCtrl.addNewPet();
petCtrl.deletePet();
JMessage messageResponse = petCtrl.getPet();
JMessageAssert.assertThat(messageResponse)
.hasMessage("Pet not found");
Удаление питомца из магазинa Java
Assertions generated

Не нужно писать код…

Lombok – скажите вы мне
НЕТ – отвечу я вам

Kotlin от идеи до 1.0 – 6 лет
2010 2016

Меньше кода
data class Customer(val name: String, val email: String)
fun main(args: Array<String>) {
val oleg = Cutomer(name = “Oleg”, email =
println(“Name: ${oleg.name}nEmail: ${oleg.email}”)
}
object State {
val global =
“available"
}
Singleton
Именованные
аргументы
String
templates

var a: String = “abc”
a = null //compilation
error
var b: String? = “abc”
b = null //ok
val data = mapOf(1 to “one”)
data?.let {
// execute block if not null
}
Null Safety
val files = File("Test").listFiles()
println(files?.size ?: "empty")
files?.size ?: throw IllegalStateException(“File is missing!")

Null Safety
class Product {
private val name : String
init {
the()
name = “”
}
private fun the() {
println(name.lenght)
}
}
Product() //java.lang.NullPointerExeption

Null Safety
bookingList
.items[0]
.additionalInfo
.pricesList[0]
.baseAmount
.uah
bookingList
.items?
.get(0)?
.additionalInfo?
.pricesList?
.get(0)?
.baseAmount
.uah

Extension functions
fun WebElement.setValue(value: String): WebElement {
this.clear()
this.sendKeys(value)
return this
}
city.setValue(“Lviv”)
Расширяемый тип Наименование метода Возвращаемый тип

Если вы сейчас подумали написать новый
«фреймворк» - то укусите своё подсознание
- Бо он уже есть: Kirk
github.com/SergeyPirogov/kirk

Reified types
inline fun <reified T> String.toKotlinObject(): T {
val mapper = jacksonObjectMapper()
return mapper.readValue(JsonObject(this).encode(), T::class.java)
}
fun parseHardModel(): Product {
val resp = prepareResp()
return resp.toKotlinObject()
}
Передаваемый тип Расширяемый тип Возвращаемый тип

Вооружаемся инструментами

HTTP клиенты
Fuel Khttp
Что включает в
себя
Fuel-http, fuel-android, fuel-livedata,
fuel-rxJava, fuel-Gson, fuel-jackson
http-client
Написать тест
GET, 5 params,
check response
На разобраться и написать 1 час.
Требуется глубоко разобраться в
синтаксисе и возможностях
10 минут
Глобальные
конфигурации
Настраиваемый Не настраиваемый (можно написать)
Асинхронные
запросы
Поддерживает Поддерживает
Доступность Tutorials, хорошая документация,
большой комьюнити
Минимальная документация

Fuel.post("http://httpbin.org/post").response { request, response, result ->
println(request)
println(response)
val (bytes, error) = result
if (bytes != null) {
println(bytes)
}
}
"http://httpbin.org/get".httpGet().responseString { request, response, result ->
when (result) {
is Result.Failure -> {
error = result.getAs()
}
is Result.Success -> {
data = result.getAs()
}
}
}
Fuel

FuelManager.instance.basePath = “https://seleniumcamp.com”
Fuel.get("/get").response { request, response, result ->
}
FuelManager.instance.baseHeaders = mapOf("Device" to "Android")
Fuel.get("/get").response { request, response, result ->
}
Fuel

get("http://httpbin.org/ip").jsonObject.getString("origin")
post("http://httpbin.org/post", data = mapOf("key" to "value"))
get("https://my.api/some/endpoint", heads = mapOf("X-API-Key" to "secret"))
Khttp

json конверторы
JsonToKotlinClass RoboPOJOGenerator
Звёздочки 205 378
Поддержка
сериализации
GSON, Jackson, FastJSON, MoShi
LoganSquare, Custom
GSON, Jackson, FastJSON, MoShi, Logan
Square, AutoValue
Язык Kotlin Java, Kotlin
Настройки Базовая инициализация(null, type value,
none)
Коммент с примером значения
val / var тип переменной
Nullability
Только для Java (гетеры, сеттеры)

- in development
XML – только через консольку XJC с JAXB

Assert библиотеки
Kluent
~640 различных методов для проверок: Object, Boolean, Numeric,
CharSequence, String, Collections, Exception, Map, Iterable, Files,
Time + custom
Moking
Expekt
~ проверок, Object, Boolean, Numeric, CharSequence, Collections,
Exception, Map, Files
AssertK
~100 различных провероверок для Object, Numeric, Boolean,
CharSequence, Collections, Exception, Map, Files + custom

val alice = Person("Alice", "Bob")
val jon = Person("Jon", "Doe")
val list = listOf(alice, jon)
list shouldContain jon
"hello" `should not equal` "world"
kluent

23.should.equal(23)
"Kotlin".should.not.contain("Scala")
listOf(1, 2, 3).should.have.size.above(1)
Expekt

Дальше будет Kotlin код

RestAssured.given().baseUri(BASE_URI)
.`when`()
.delete(PET_ENDPOINT + id)
.then()
.extract()
.`as`(Message::class.java)

fun RequestSpecification.When(): RequestSpecification {
return this.`when`()
}
inline fun <reified T> Response.As(): T {
return this.`as`(T::class.java)
}
Extension functions with reified type functions

.When()
.then()
.extract()
.As()
.`when`()
.then()
.extract()
.`as`(Message::class.java)
Было
Стало

Kotlin, жги
Kotlin
Gradle
rest-assured
JsonToKotlinClass
jackson-kotlin

JsonToKotlinClass Plugin
Settings

Kotlin Pet model
data class Pet(
var photoUrls: List<String> = listOf(),
var category: Category = Category()
var name: String = “”,
var id: Long = “”,
var tags: List<Tag> = listOf(),
var status: String = “”
)

@Test fun `Add new pet to store test`() {
val testPet = KPet(id = randomNumber,
name = "Pet_${randomString}",
status = Status.AVAILABLE)
val petResponse = PetController(testPet).addNewPet()
Assert.assertEquals(testPet, petResponse)
}
Kotlin

@Test fun `Delete pet from store test`() {
val testPet = KPet(id = randomNumber,
name = "Pet_${randomString}",
status = Status.AVAILABLE)
PetController(testPet).apply {
addNewPet()
deletePet()
Assert.assertTrue(getPet()
.message.equals("Pet not found"))
}
}
Kotlin

Kotlin, жги
Kotlin
Gradle
rest-Assured
JsonToKotlinClass
jackson-kotlin
Kluent

val testPet = KPet(***)
val petResponse = KPetController(testPet).addNewPet()
petResponse shouldEqual testPet
Добавление питомца в магазин Kotlin
проверяем с kluent

KPetController(testPet).addNewPet() shouldEqual testPet
Добавление питомца в магазин Kotlin

KPetController(testPet).apply {
addNewPet()
deletePet()
getPet().message shouldEqual "Pet not found"
}
Удаление питомца из магазина Kotlin

Финалочка
• Быстрее пишешь код:
• Меньше кода -> быстрее понимаешь, что он делает
• Легкая расширяемость кода (extensions/reified)
• Осваивается за 2-4 недели
• Прагматичное саморазвитие -> фан фактор командный
• Привлекательность проекта
• Медленную сборку проекта + 2x - 6x
• org.gradle.caching=true (gradle.properties) – 4x – 10x

Thanks and Questions?
github.com/rmarinsky
linkedin.com/rmarinsky
medium.com/@newromka
facebook.com/newromka
t.me/newromka

Kotlin with API tests

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Kotlin with API tests

Similar to Kotlin with API tests (20)

Kotlin with API tests

Editor's Notes