Handle exceptions like a pro with Coroutines!

CoroutineResult.kt

package coroutines

/**
 * Calls the specified function [block] and returns its encapsulated result if invocation was
 * successful, catching any [Throwable] exception that was thrown from the block function execution
 * and encapsulating it as a failure.
 *
 * Unlike [runCatching], [suspendRunCatching] does not break structured concurrency by rethrowing
 * any [CancellationException].
 *
 * **Heads-up:** [TimeoutCancellationException] extends [CancellationException] but catching it does
 * not breaks structured concurrency and therefore, will not be rethrown. Therefore, you can use
 * [suspendRunCatching] with [withTimeout], and handle any timeout gracefully.
 *
 * @see <a href="https://github.com/Kotlin/kotlinx.coroutines/issues/1814">link</a>
 */
suspend inline fun <T> suspendRunCatching(crossinline block: suspend () -> T): Result<T> =
    try {
        Result.success(block())
    } catch (e: Throwable) {
        currentCoroutineContext().ensureActive()
        Result.failure(e)
    }

/**
 * Calls the specified function [block] and returns its encapsulated result if invocation was
 * successful, catching any [Throwable] exception that was thrown from the block function execution
 * and encapsulating it as a failure.
 *
 * Unlike [runCatching], [suspendRunCatching] does not break structured concurrency by rethrowing
 * any [CancellationException].
 *
 * **Heads-up:** [TimeoutCancellationException] extends [CancellationException] but catching it does
 * not breaks structured concurrency and therefore, will not be rethrown. Therefore, you can use
 * [suspendRunCatching] with [withTimeout], and handle any timeout gracefully.
 *
 * @see <a href="https://github.com/Kotlin/kotlinx.coroutines/issues/1814">link</a>
 */
suspend inline fun <T, R> T.suspendRunCatching(crossinline block: suspend T.() -> R): Result<R> =
    // Overload with a `this` receiver, matches with `kotlin.runCatching` functions.
    // Qualified name needs to be used to avoid a recursive call.
    coroutines.suspendRunCatching { block(this) }