Introduce binary-compatibility-validator module

Update Kotlin to 1.2.41 (KT-23809)
Copy and slightly change binary-compatibility validator from Kotlin repository

Author: qwwdfsad

binary-compatibility-validator/README.md

@@ -0,0 +1,6 @@
+# Public API binary compatibility validator
+
+This module allows to dump and compare public binary API to ensure binary compatibility with a previous version.
+This tool is slightly adapted copy of [original Kotlin compatibility validator](https://github.com/JetBrains/kotlin/tree/master/libraries/tools/binary-compatibility-validator) by @ilya-g.
+
+Refer to the original readme for additional documentation.

binary-compatibility-validator/build.gradle

@@ -0,0 +1,52 @@
+configurations {
+    testArtifacts
+}
+
+dependencies {
+    compile 'org.ow2.asm:asm-debug-all:5.0.4'
+    compile 'com.google.code.gson:gson:2.6.2'
+
+    testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
+    testArtifacts project(':kotlinx-coroutines-core')
+    testArtifacts project(':kotlinx-coroutines-io')
+
+
+    testArtifacts project(':kotlinx-coroutines-reactive')
+    testArtifacts project(':kotlinx-coroutines-reactor')
+    testArtifacts project(':kotlinx-coroutines-rx1')
+    testArtifacts project(':kotlinx-coroutines-rx2')
+
+    testArtifacts project(':kotlinx-coroutines-guava')
+    testArtifacts project(':kotlinx-coroutines-jdk8')
+    testArtifacts project(':kotlinx-coroutines-nio')
+    testArtifacts project(':kotlinx-coroutines-quasar')
+
+    testArtifacts project(':kotlinx-coroutines-android')
+    testArtifacts project(':kotlinx-coroutines-javafx')
+    testArtifacts project(':kotlinx-coroutines-swing')
+}
+
+def testCasesDeclarationsDump = "${buildDir}/visibilities.json".toString()
+
+compileTestKotlin {
+    kotlinOptions {
+        freeCompilerArgs = ["-Xdump-declarations-to=$testCasesDeclarationsDump"]
+    }
+}
+
+sourceSets {
+    test {
+        java {
+            srcDir "src/test/kotlin"
+        }
+    }
+}
+
+test {
+    dependsOn cleanCompileTestKotlin
+    dependsOn configurations.testArtifacts
+
+    systemProperty 'testCasesClassesDirs', sourceSets.test.output.classesDirs.asPath
+    systemProperty 'testCasesDeclarations', testCasesDeclarationsDump
+    jvmArgs '-ea'
+}

binary-compatibility-validator/reference-public-api/kotlinx-coroutines-android.txt

@@ -0,0 +1,23 @@
+public final class kotlinx/coroutines/experimental/android/AndroidExceptionPreHandler : kotlin/coroutines/experimental/AbstractCoroutineContextElement, kotlinx/coroutines/experimental/CoroutineExceptionHandler {
+	public fun <init> ()V
+	public fun handleException (Lkotlin/coroutines/experimental/CoroutineContext;Ljava/lang/Throwable;)V
+}
+
+public final class kotlinx/coroutines/experimental/android/HandlerContext : kotlinx/coroutines/experimental/CoroutineDispatcher, kotlinx/coroutines/experimental/Delay {
+	public fun <init> (Landroid/os/Handler;Ljava/lang/String;)V
+	public synthetic fun <init> (Landroid/os/Handler;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public final fun awaitFrame (Lkotlin/coroutines/experimental/Continuation;)Ljava/lang/Object;
+	public fun delay (JLjava/util/concurrent/TimeUnit;Lkotlin/coroutines/experimental/Continuation;)Ljava/lang/Object;
+	public fun dispatch (Lkotlin/coroutines/experimental/CoroutineContext;Ljava/lang/Runnable;)V
+	public fun equals (Ljava/lang/Object;)Z
+	public fun hashCode ()I
+	public fun invokeOnTimeout (JLjava/util/concurrent/TimeUnit;Ljava/lang/Runnable;)Lkotlinx/coroutines/experimental/DisposableHandle;
+	public fun scheduleResumeAfterDelay (JLjava/util/concurrent/TimeUnit;Lkotlinx/coroutines/experimental/CancellableContinuation;)V
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class kotlinx/coroutines/experimental/android/HandlerContextKt {
+	public static final fun asCoroutineDispatcher (Landroid/os/Handler;)Lkotlinx/coroutines/experimental/android/HandlerContext;
+	public static final fun getUI ()Lkotlinx/coroutines/experimental/android/HandlerContext;
+}
+

binary-compatibility-validator/reference-public-api/kotlinx-coroutines-core.txt

@@ -0,0 +1,11 @@
+public final class kotlinx/coroutines/experimental/guava/ListenableFutureKt {
+	public static final fun asListenableFuture (Lkotlinx/coroutines/experimental/Deferred;)Lcom/google/common/util/concurrent/ListenableFuture;
+	public static final fun await (Lcom/google/common/util/concurrent/ListenableFuture;Lkotlin/coroutines/experimental/Continuation;)Ljava/lang/Object;
+	public static final synthetic fun future (Lkotlin/coroutines/experimental/CoroutineContext;Lkotlinx/coroutines/experimental/CoroutineStart;Lkotlin/jvm/functions/Function2;)Lcom/google/common/util/concurrent/ListenableFuture;
+	public static final fun future (Lkotlin/coroutines/experimental/CoroutineContext;Lkotlinx/coroutines/experimental/CoroutineStart;Lkotlinx/coroutines/experimental/Job;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function2;)Lcom/google/common/util/concurrent/ListenableFuture;
+	public static final synthetic fun future (Lkotlin/coroutines/experimental/CoroutineContext;Lkotlinx/coroutines/experimental/CoroutineStart;Lkotlinx/coroutines/experimental/Job;Lkotlin/jvm/functions/Function2;)Lcom/google/common/util/concurrent/ListenableFuture;
+	public static synthetic fun future$default (Lkotlin/coroutines/experimental/CoroutineContext;Lkotlinx/coroutines/experimental/CoroutineStart;Lkotlin/jvm/functions/Function2;ILjava/lang/Object;)Lcom/google/common/util/concurrent/ListenableFuture;
+	public static synthetic fun future$default (Lkotlin/coroutines/experimental/CoroutineContext;Lkotlinx/coroutines/experimental/CoroutineStart;Lkotlinx/coroutines/experimental/Job;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function2;ILjava/lang/Object;)Lcom/google/common/util/concurrent/ListenableFuture;
+	public static synthetic fun future$default (Lkotlin/coroutines/experimental/CoroutineContext;Lkotlinx/coroutines/experimental/CoroutineStart;Lkotlinx/coroutines/experimental/Job;Lkotlin/jvm/functions/Function2;ILjava/lang/Object;)Lcom/google/common/util/concurrent/ListenableFuture;
+}
+