commonMain.com.saveourtool.save.utils.KotlinUtils.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of save-cloud-common Show documentation

save-cloud-common

The newest version!

/**
 * Utilities for Kotlin
 */

package com.saveourtool.save.utils

import kotlinx.coroutines.delay

typealias StringList = List

/**
 * @return true if [this] is not null
 */
fun  T?.isNotNull(): Boolean = this != null

/**
 * Run [action] several [times] with [delayMillis] milliseconds
 * Catches all the exceptions and retries [action] if [times] is not null
 *
 * [T] is just a non-nullable type
 *
 * @param times number of times to retry [action]
 * @param delayMillis number of milliseconds to wait until next retry
 * @param action action that should be invoked
 * @return Pair where first element is [T] if the result was fetched in [times] attempts, null otherwise,
 *  second element is list of [Throwable] caught in [retry]
 */
@Suppress("TooGenericExceptionCaught")
suspend fun  retry(
    times: Int,
    delayMillis: Long = 10_000L,
    action: suspend (Int) -> T?,
): Pair> {
    val caughtExceptions: MutableList = mutableListOf()
    times.downTo(1).map { iteration ->
        try {
            action(iteration)?.let { result ->
                return result to caughtExceptions
            }
            delay(delayMillis)
        } catch (e: Throwable) {
            caughtExceptions.add(e)
            delay(delayMillis)
        }
    }
    return null to caughtExceptions
}

/**
 * Run [action] several [times] with [delayMillis] milliseconds **ignoring** error logs
 * Catches all the exceptions and retries [action] if [times] is not null
 *
 * [T] is just a non-nullable type
 *
 * @see retry
 *
 * @param times number of times to retry [action]
 * @param delayMillis number of milliseconds to wait until next retry
 * @param action action that should be invoked
 * @return [T] if the result was fetched in [times] attempts, null otherwise
 */
suspend fun  retrySilently(
    times: Int,
    delayMillis: Long = 10_000L,
    action: suspend (Int) -> T?,
): T? = retry(times, delayMillis, action).first