chore: create helper for re-throw CancellationException

Author: jvsena42

app/src/main/java/to/bitkit/ext/Coroutines.kt

@@ -1,8 +1,19 @@
 package to.bitkit.ext
 
+import kotlinx.coroutines.CancellationException
 import kotlinx.coroutines.Job
 import to.bitkit.utils.Logger
 
+@Suppress("TooGenericExceptionCaught")
+suspend inline fun <R> runSuspendCatching(block: () -> R): Result<R> =
+    try {
+        Result.success(block())
+    } catch (c: CancellationException) {
+        throw c
+    } catch (e: Throwable) {
+        Result.failure(e)
+    }
+
 fun Job.logCompletion(name: String = "") = invokeOnCompletion { err ->
     if (err != null) {
         Logger.verbose("Coroutine '$name' error: ${err.message}")

app/src/test/java/to/bitkit/ext/CoroutinesTest.kt

@@ -0,0 +1,35 @@
+package to.bitkit.ext
+
+import kotlinx.coroutines.CancellationException
+import org.junit.Test
+import to.bitkit.test.BaseUnitTest
+import kotlin.test.assertEquals
+import kotlin.test.assertFailsWith
+import kotlin.test.assertTrue
+
+class CoroutinesTest : BaseUnitTest() {
+
+    @Test
+    fun `runSuspendCatching wraps a successful result`() = test {
+        val result = runSuspendCatching { 42 }
+
+        assertEquals(42, result.getOrNull())
+    }
+
+    @Test
+    fun `runSuspendCatching wraps a thrown exception as failure`() = test {
+        val error = IllegalStateException("boom")
+
+        val result = runSuspendCatching { throw error }
+
+        assertTrue(result.isFailure)
+        assertEquals(error, result.exceptionOrNull())
+    }
+
+    @Test
+    fun `runSuspendCatching re-throws CancellationException`() = test {
+        assertFailsWith<CancellationException> {
+            runSuspendCatching { throw CancellationException("cancelled") }
+        }
+    }
+}