Merge branch 'master' into patch-16

Author: lor6

core-kotlin-modules/core-kotlin-advanced-3/README.md

@@ -4,4 +4,5 @@
 - [Passing a Type to Generic Method in Kotlin](https://www.baeldung.com/kotlin/generic-methods)
 - [Getting a Kotlin KClass from a Package Class Name String](https://www.baeldung.com/kotlin/kclass-fqn-string)
 - [A Guide to Kotlin Context Receivers](https://www.baeldung.com/kotlin/context-receivers)
+- [A Guide to Kotlin’s Any, Unit, Nothing](https://www.baeldung.com/kotlin/any-unit-nothing-tutorial)
 - More articles: [[<-- prev]](../core-kotlin-advanced-2)

core-kotlin-modules/core-kotlin-concurrency-4/README.md

@@ -0,0 +1,3 @@
+### Relevant Articles: 
+
+-  [Kotlin Coroutine Continuation](https://www.baeldung.com/kotlin/coroutine-continuation)

core-kotlin-modules/core-kotlin-io/src/test/kotlin/com/baeldung/okio/BufferUnitTest.kt

@@ -6,7 +6,7 @@ import org.junit.jupiter.api.Test
 
 class BufferUnitTest {
     @Test
-    fun readAndWriteStringWithLength() {
+    fun `when writing data to a buffer then we can read the data back out` () {
         val input = "Hello, World!"
 
         val buffer = Buffer()

core-kotlin-modules/core-kotlin-io/src/test/kotlin/com/baeldung/okio/ByteStringUnitTest.kt

@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 class ByteStringUnitTest {
     @Test
-    fun convertToFromUtf8() {
+    fun `when converting a string to utf-8 bytes then we can convert back to a string` () {
         val byteString = "Hello".encodeUtf8()
 
         assertEquals(5, byteString.size)
@@ -18,7 +18,7 @@ class ByteStringUnitTest {
     }
 
     @Test
-    fun convertToFromBase64() {
+    fun `given a base64 input string when decoding as base64 then we get the correct string out` () {
         val byteString = "SGVsbG8=".decodeBase64()
 
         assertEquals("Hello", byteString?.utf8())
@@ -27,7 +27,7 @@ class ByteStringUnitTest {
     }
 
     @Test
-    fun convertToFromHex() {
+    fun `given a hex input string when decoding as hex then we get the correct string out` () {
         val byteString = "48656c6c6f".decodeHex()
 
         assertEquals("Hello", byteString.utf8())
@@ -36,7 +36,7 @@ class ByteStringUnitTest {
     }
 
     @Test
-    fun convertToHash() {
+    fun `given an input string when generating various hashes then we get the correct result` () {
         val byteString = "Hello".encodeUtf8()
 
         assertEquals("8b1a9953c4611296a827abf8c47804d7", byteString.md5().hex())

core-kotlin-modules/core-kotlin-io/src/test/kotlin/com/baeldung/okio/FileSystemUnitTest.kt

@@ -9,13 +9,13 @@ import org.junit.jupiter.api.Test
 
 class FileSystemUnitTest {
     @Test
-    fun test() {
+    fun `given a filesystem when we list files then we find READMEmd` () {
         val files = FileSystem.SYSTEM.list(".".toPath())
         assertTrue(files.contains("README.md".toPath()))
     }
 
     @Test
-    fun readFile() {
+    fun `given a filesystem when we read READMEmd then we get the correct first line` () {
         val line = FileSystem.SYSTEM.source("README.md".toPath()).buffer().readUtf8()
         assertEquals("## Core Kotlin I/O", line.lines().first())
     }

core-kotlin-modules/core-kotlin-io/src/test/kotlin/com/baeldung/okio/SinkUnitTest.kt

@@ -11,7 +11,7 @@ import kotlin.test.assertEquals
 
 class SinkUnitTest {
     @Test
-    fun testOutputStream() {
+    fun `given an output stream when treating as a sink then we can write data to it` () {
         val inputBuffer = Buffer()
         inputBuffer.writeUtf8("Hello, World!")
 
@@ -24,7 +24,7 @@ class SinkUnitTest {
     }
 
     @Test
-    fun testBufferedSink() {
+    fun `given a sink when wrapping in a BufferedSink then we can write data to it` () {
         val outputStream = ByteArrayOutputStream()
         val sink = outputStream.sink().buffer()
         sink.writeUtf8("Hello, World!")
@@ -35,7 +35,7 @@ class SinkUnitTest {
     }
 
     @Test
-    fun testGzip() {
+    fun `given a sink when wrapping in a GzipSink then we can compress data as we write it` () {
         val inputBuffer = Buffer()
         inputBuffer.writeUtf8("Hello, World!")
 

core-kotlin-modules/core-kotlin-io/src/test/kotlin/com/baeldung/okio/SourceUnitTest.kt

@@ -8,7 +8,7 @@ import java.io.ByteArrayInputStream
 
 class SourceUnitTest {
     @Test
-    fun testInputStreamSource() {
+    fun `given an input stream when treating as a source then we can read the data from it` () {
         val inputStream = ByteArrayInputStream("Hello, World!".encodeUtf8().toByteArray())
 
         val source = inputStream.source()
@@ -21,7 +21,7 @@ class SourceUnitTest {
     }
 
     @Test
-    fun testBufferedSource() {
+    fun `given a source when wrapping in a BufferedSource then we can read the data from it` () {
         val inputStream = ByteArrayInputStream("Hello, World!".encodeUtf8().toByteArray())
 
         val source = inputStream.source().buffer()
@@ -30,7 +30,7 @@ class SourceUnitTest {
     }
 
     @Test
-    fun testGzipSource() {
+    fun `given a source of compressed data when wrapping in a GzipSource then we can read the data from it` () {
         val inputBuffer = Buffer()
         inputBuffer.writeUtf8("Hello, World!")
 

core-kotlin-modules/core-kotlin-lang-oop-4/README.md

@@ -1,3 +1,4 @@
 ### Relevant Articles
 
 - [Iterating All Fields of a Data Class Without Reflection in Kotlin](https://www.baeldung.com/kotlin/data-class-get-fields-no-reflection)
+- [Iterating Enum Entries in Kotlin](https://www.baeldung.com/kotlin/enum-iterate-entries)

k2-compiler/README.md

@@ -1,2 +1,3 @@
 ### Relevant Articles
 - [K2 Compiler Migration Guide](https://www.baeldung.com/kotlin/k2-compiler-migration-tutorial)
+- [Kotlin K2 Compiler Overview](https://www.baeldung.com/kotlin/k2-compiler-guide)

kotlin-libraries-data/README.md

@@ -5,3 +5,4 @@ This module contains articles about data manipulation libraries topics in Kotlin
 - [Class Inheritance with Kotlinx Serialization](https://www.baeldung.com/kotlin/kotlinx-serialization-inheritance)
 - [Mapstruct With Kotlin’s Data Classes](https://www.baeldung.com/kotlin/mapstruct-data-classes)
 - [Deserialize Enum While Ignoring Unknown Values in Kotlin](https://www.baeldung.com/kotlin/unknown-enums-deserialization)
+- [Serialize Enum in Retrofit With Kotlin](https://www.baeldung.com/kotlin/retrofit-enum)