xref: /aosp_15_r20/frameworks/base/packages/SystemUI/utils/kairos/src/com/android/systemui/kairos/internal/DeferScope.kt (revision d57664e9bc4670b3ecf6748a746a57c557b6bc9e)
1 /*
2  * Copyright (C) 2024 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.android.systemui.kairos.internal
18 
19 import com.android.systemui.kairos.internal.util.asyncImmediate
20 import com.android.systemui.kairos.internal.util.launchImmediate
21 import kotlinx.coroutines.CoroutineName
22 import kotlinx.coroutines.CoroutineScope
23 import kotlinx.coroutines.CoroutineStart
24 import kotlinx.coroutines.Deferred
25 import kotlinx.coroutines.Job
26 import kotlinx.coroutines.coroutineScope
27 import kotlinx.coroutines.isActive
28 
29 internal typealias DeferScope = CoroutineScope
30 
deferActionnull31 internal inline fun DeferScope.deferAction(
32     start: CoroutineStart = CoroutineStart.UNDISPATCHED,
33     crossinline block: suspend () -> Unit,
34 ): Job {
35     check(isActive) { "Cannot perform deferral, scope already closed." }
36     return launchImmediate(start, CoroutineName("deferAction")) { block() }
37 }
38 
deferAsyncnull39 internal inline fun <R> DeferScope.deferAsync(
40     start: CoroutineStart = CoroutineStart.UNDISPATCHED,
41     crossinline block: suspend () -> R,
42 ): Deferred<R> {
43     check(isActive) { "Cannot perform deferral, scope already closed." }
44     return asyncImmediate(start, CoroutineName("deferAsync")) { block() }
45 }
46 
deferScopenull47 internal suspend inline fun <A> deferScope(noinline block: suspend DeferScope.() -> A): A =
48     coroutineScope(block)
49