History

liiir1985 7f62dcda9f initial		2024-06-22 20:45:49 +08:00
..
kotlinx-coroutines-guava	initial	2024-06-22 20:45:49 +08:00
kotlinx-coroutines-jdk8	initial	2024-06-22 20:45:49 +08:00
kotlinx-coroutines-play-services	initial	2024-06-22 20:45:49 +08:00
kotlinx-coroutines-slf4j	initial	2024-06-22 20:45:49 +08:00
README.md	initial	2024-06-22 20:45:49 +08:00

README.md

Coroutines integration

This directory contains modules that provide integration with various asynchronous callback- and future-based libraries. Module name below corresponds to the artifact name in Maven/Gradle.

Modules

kotlinx-coroutines-jdk8 -- integration with JDK8 CompletableFuture (Android API level 24).
kotlinx-coroutines-guava -- integration with Guava ListenableFuture.
kotlinx-coroutines-slf4j -- integration with SLF4J MDC.
kotlinx-coroutines-play-services -- integration with Google Play Services Tasks API.

Contributing

Follow the following simple guidelines when contributing integration with your favorite library:

Keep it simple and general. Ideally it should fit into a single file. If it does not fit, then consider a separate GitHub project to host this integration.
Follow the example of other modules. Cut-and-paste kotlinx-coroutines-guava module as a template.
Write tests and documentation, include top-level README.md with short overview and example.
Reference the new module from all the places:
- List of modules in this document.
- List of modules in top-level settings.gradle.
- List of modules at the root of documentation site in site/docs/index.md.
- List of integrations in the root README.md.
Update links to documentation website as explained here.
Squash your contribution to a single commit and create pull request to develop branch.