Support thread interrupting blocking functions (#1947)

[jxdabc]

This is implementation of issue #57 #1947 and non-intrusive variant of #1922

Signed-off-by: Trol [email protected]

[jxdabc]

Amended as #1947:

• Added an optional context parameter to enable single-call conversion of interruptible Java methods into main-safe suspending functions.
• Added some more tests.
• Updated the PR title to match Support thread interrupting blocking functions #1947

[qwwdfsad]

#1947 (comment)
Here is our final design.

Thanks a lot for your valuable contribution and moving this almost abandoned issue forward!
I realize there is a lot to do (along with a regular code-review that may take a bunch of iterations), so feel free to leave the rest of the changes on us if you don't have time to go this extra mile.

[jxdabc]

@qwwdfsad The design seems sweet. Especially as with avoid cross-block (launch...) misuse.

Thanks a lot for you to finally make coroutine together with interruption possible. That really helps a lot at least for some common Android patterns as I could see and make some people's work easy. I'd like to help complete this helpful progress.

[jxdabc]

@qwwdfsad

I added DSL restriction just now with a draft commit (didn't amend the previous one).

I found this DSL restriction may break existing code, as I commented as a code review comment for an example. Existing code may need change to use explicit reference to outer scope in this situation. Is that expected or is there something I missed?

[qwwdfsad]

Regarding DSL restrictions, it is actually my oversight and it seems to be impossible to achieve desired behaviour. One more task for refining DslMarker :)

Please just get rid of it (scope receiver, new interfaces, dsl annotations), let's fallback to the original plan.

[jxdabc]

@qwwdfsad
Thanks a lot for detailed advice. I amended the patch as to code review comments.

[qwwdfsad]

Thanks for the high-quality contribution!

I've slightly adjusted it (mostly documentation and the code style we prefer) and opened #1972.
Will merge it soon if you don't have any objections

[jxdabc]

Thanks. Glad to see that.

[qwwdfsad]

Merged via #1972.
Thanks!