Improve tests / KDoc (#79)

* Add test for decoding quoted string and fix content type in test

* Add method to get all values of a header that is defined as a list

Author: rfc2822

src/main/kotlin/at/bitfire/dav4jvm/HttpUtils.kt

@@ -49,6 +49,30 @@ object HttpUtils {
         return pathSegments.lastOrNull() ?: ""
     }
 
+    /**
+     * Gets all values of a header that is defined as a list [RFC 9110 5.6.1],
+     * regardless of they're sent as one line or as multiple lines.
+     *
+     * For instance, regardless of whether a server sends:
+     *
+     * ```
+     * DAV: 1
+     * DAV: 2
+     * ```
+     *
+     * or
+     *
+     * ```
+     * DAV: 1, 2
+     * ```
+     *
+     * this method would return `arrayOf("1","2")` for the `DAV` header.
+     *
+     * @param response  the HTTP response to evaluate
+     * @param name      header name (for instance: `DAV`)
+     *
+     * @return all values for the given header name
+     */
     fun listHeader(response: Response, name: String): Array<String> {
         val value = response.headers(name).joinToString(",")
         return value.split(',').filter { it.isNotEmpty() }.toTypedArray()

src/test/kotlin/at/bitfire/dav4jvm/DavResourceTest.kt

@@ -1116,15 +1116,14 @@ class DavResourceTest {
             .build())
     }
 
-    @Test
+    @Test(expected = DavException::class)
     fun testAssertMultiStatus_NonXML_ReallyNotXML() {
         val dav = DavResource(httpClient, "https://from.com".toHttpUrl())
         dav.assertMultiStatus(okhttp3.Response.Builder()
             .request(Request.Builder().url(dav.location).build())
             .protocol(Protocol.HTTP_1_1)
             .code(207).message("Multi-Status")
-            .addHeader("Content-Type", "text/plain")
-            .body("Some error occurred".toResponseBody())
+            .body("Some error occurred".toResponseBody("text/plain".toMediaType()))
             .build())
     }
 

src/test/kotlin/at/bitfire/dav4jvm/QuotedStringUtilsTest.kt

@@ -22,6 +22,7 @@ class QuotedStringUtilsTest {
         assertEquals("\"\\\\\"", QuotedStringUtils.asQuotedString("\\"))
     }
 
+    @Test
     fun testDecodeQuotedString() {
         assertEquals("\"", QuotedStringUtils.decodeQuotedString("\""))
         assertEquals("\\", QuotedStringUtils.decodeQuotedString("\"\\\""))