I don't know why, but last time I looked, but turning a callback into coroutines is in the internals...

# coroutines

[dave08]

I don't know why, but last time I looked, but turning a callback into coroutines is in the internals KEEP doc. on github kotlinx.coroutines, not in the guide there...

[mansonheart]

what is the doc?

[dave08]

https://github.com/Kotlin/kotlin-coroutines/blob/master/kotlin-coroutines-informal.md

[gildor]

kotlin-coroutines official specification and docs. Make sense do not put everything to kotlinx-coroutines, because it's library, not tutorial how to write coroutine libraries

[dave08]

Right, but KEEP is usually spec docs for planning features and explaining internals, not end user documentation... which gives the feeling that suspendCoroutine is a low level api not to be used, whereas in reality, I think that it's the best way to turn callbacks into suspend fun... a few people asked this, so it seems like either they didn't see the docs, or its not so obvious....

[gildor]

But this is end user documentation. Yes, it’s low level stuff and should be low level, because writing coroutines libraries is low level task
There is section about wrapping callbacks
https://github.com/Kotlin/kotlin-coroutines/blob/master/kotlin-coroutines-informal.md#wrapping-callbacks

[gildor]

But now I’m thinking that kotlinx-coroutines should have a separate section about wrapping callbacks. because provides more high level API for that with support of cancellation

[dave08]

That's exactly my point simple smile

[gildor]

https://github.com/Kotlin/kotlinx.coroutines/issues/new 😬

[dave08]

https://github.com/Kotlin/kotlinx.coroutines/issues/218