Update readme

Author: qwwdfsad

README.md

@@ -31,6 +31,8 @@ GlobalScope.launch {
 * [core](core/README.md) — Kotlin/JVM implementation of common coroutines with additional features:
   * `Dispatchers.IO` dispatcher for blocking coroutines;
   * `Executor.asCoroutineDispatcher()` extension, custom thread pools, and more.
+* [core-test](core/README.md) — test utilities for coroutines, currently with one feature:
+  * `MainDispatcherInjector.inject()` to override `Dispatchers.Main` in tests.
 * [js](js/README.md) — Kotlin/JS implementation of common coroutines with `Promise` support.
 * [native](native/README.md) — Kotlin/Native implementation of common coroutines with `runBlocking` single-threaded event loop.
 * [reactive](reactive/README.md) — modules that provide builders and iteration support for various reactive streams libraries:

RELEASE.md

@@ -12,7 +12,7 @@ To release new `<version>` of `kotlinx-coroutines`:
    `git merge origin/master`   
 
 4. Search & replace `<old-version>` with `<version>` across the project files. Should replace in:
-   * [`README.md`](README.md)
+   * [`README.md`](README.md) (native, core, core-test modules)
    * [`coroutines-guide.md`](docs/coroutines-guide.md)
    * [`gradle.properties`](gradle.properties)
    * [`ui/kotlinx-coroutines-android/example-app/gradle.properties`](ui/kotlinx-coroutines-android/example-app/gradle.properties)    

core/README.md

@@ -5,5 +5,6 @@ Module name below corresponds to the artifact name in Maven/Gradle.
 
 ## Modules
 
-* [kotlinx-coroutines-core](kotlinx-coroutines-core/README.md) -- core coroutine builders and synchronization primitives. 
+* [kotlinx-coroutines-core](kotlinx-coroutines-core/README.md) — core coroutine builders and synchronization primitives. 
+* [kotlinx-coroutines-core-test](kotlinx-coroutines-core-test/README.md) — coroutines test utilities such as Main dispatcher injection.
 

core/kotlinx-coroutines-core-test/README.md

@@ -0,0 +1,51 @@
+# Module kotlinx-coroutines-core-test
+
+Test utilities for `kotlinx.coroutines`. Provides `MainDispatcherInjector.inject` to override `Main` dispatcher.
+
+## Using in your project
+
+Add `kotlinx-coroutines-core-test` to your project test dependencies:
+```
+dependencies {
+    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core-test:1.0.0-RC1'
+}
+```
+
+**Do not** depend on this project in your main sources, all utilities are intended and designed to be used only from tests. 
+
+Once you have it in runtime, [`ServiceLoader`](https://docs.oracle.com/javase/8/docs/api/java/util/ServiceLoader.html) mechanism will
+overwrite [Dispatchers.Main] will injectable implementation, which uses `Dispatchers.Unconfined` default.
+
+You can override this implementation using [inject][MainDispatcherInjector.inject] method with any [CoroutineDispatcher] implementation, e.g.:
+
+```kotlin
+
+class SomeTest {
+    
+    private val mainThreadSurrogate = newSingleThreadContext("UI thread")
+
+    @Before
+    fun setUp() {
+        MainDispatcherInjector.inject(mainThreadSurrogate)
+    }
+
+    @After
+    fun tearDown() {
+        MainDispatcherInjector.reset() // reset main dispatcher to Unconfined
+        mainThreadSurrogate.close()
+    }
+    
+    @Test
+    fun testSomeUI() = runBlocking {
+        launch(Dispatchers.Main) {  
+            ...
+        }
+    }
+}
+```
+
+<!--- MODULE kotlinx-coroutines-core -->
+<!--- INDEX kotlinx.coroutines -->
+[Dispatchers.Main]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-dispatchers/-main.html
+[CoroutineDispatcher]: https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-coroutine-dispatcher/index.html
+<!--- END -->

knit/resources/knit.properties

@@ -4,6 +4,6 @@
 
 site.root=https://kotlin.github.io/kotlinx.coroutines
 
-module.roots=common js core integration native reactive ui
+module.roots=common js core core-test integration native reactive ui
 module.marker=build.gradle
 module.docs=build/dokka