Deferred.toCompletableFuture renamed to asCompletableFuture

Author: elizarov

kotlinx-coroutines-jdk8/README.md

@@ -13,7 +13,7 @@ Extension functions:
 | **Name** | **Description**
 | -------- | ---------------
 | [CompletableFuture.await][java.util.concurrent.CompletableFuture.await] | Awaits for completion of the future
-| [Deferred.toCompletableFuture][kotlinx.coroutines.experimental.Deferred.toCompletableFuture] | Converts a deferred value to the future
+| [Deferred.asCompletableFuture][kotlinx.coroutines.experimental.Deferred.asCompletableFuture] | Converts a deferred value to the future
 
 # Package kotlinx.coroutines.experimental.future
 
@@ -29,5 +29,5 @@ Additional libraries for JDK8 [CompletableFuture][java.util.concurrent.Completab
 [future]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-jdk8/kotlinx.coroutines.experimental.future/future.html
 [java.util.concurrent.CompletableFuture]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-jdk8/kotlinx.coroutines.experimental.future/java.util.concurrent.-completable-future/index.html
 [java.util.concurrent.CompletableFuture.await]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-jdk8/kotlinx.coroutines.experimental.future/java.util.concurrent.-completable-future/await.html
-[kotlinx.coroutines.experimental.Deferred.toCompletableFuture]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-jdk8/kotlinx.coroutines.experimental.future/kotlinx.coroutines.experimental.-deferred/to-completable-future.html
+[kotlinx.coroutines.experimental.Deferred.asCompletableFuture]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-jdk8/kotlinx.coroutines.experimental.future/kotlinx.coroutines.experimental.-deferred/as-completable-future.html
 <!--- END -->

kotlinx-coroutines-jdk8/src/main/kotlin/kotlinx/coroutines/experimental/future/Future.kt

@@ -44,11 +44,21 @@ public fun <T> future(context: CoroutineContext = CommonPool, block: suspend ()
     return future
 }
 
+
+/**
+ * Converts this deferred value to the instance of [CompletableFuture].
+ * The deferred value is cancelled when the resulting future is cancelled or otherwise completed.
+ * @suppress: **Deprecated**: Renamed to [asCompletableFuture]
+ */
+@Deprecated("Renamed to `asCompletableFuture`",
+    replaceWith = ReplaceWith("asCompletableFuture()"))
+public fun <T> Deferred<T>.toCompletableFuture(): CompletableFuture<T> = asCompletableFuture()
+
 /**
  * Converts this deferred value to the instance of [CompletableFuture].
  * The deferred value is cancelled when the resulting future is cancelled or otherwise completed.
  */
-public fun <T> Deferred<T>.toCompletableFuture(): CompletableFuture<T> {
+public fun <T> Deferred<T>.asCompletableFuture(): CompletableFuture<T> {
     val future = CompletableFuture<T>()
     future.whenComplete { _, exception -> cancel(exception) }
     invokeOnCompletion {

kotlinx-coroutines-jdk8/src/test/kotlin/examples/ToFuture-example.kt

@@ -19,7 +19,7 @@ package examples
 import kotlinx.coroutines.experimental.CommonPool
 import kotlinx.coroutines.experimental.async
 import kotlinx.coroutines.experimental.delay
-import kotlinx.coroutines.experimental.future.toCompletableFuture
+import kotlinx.coroutines.experimental.future.asCompletableFuture
 import java.util.concurrent.TimeUnit
 
 fun main(args: Array<String>)  {
@@ -30,6 +30,6 @@ fun main(args: Array<String>)  {
         log("Done...")
         42
     }
-    val future = deferred.toCompletableFuture()
+    val future = deferred.asCompletableFuture()
     log("Got ${future.get()}")
 }