Implement new wiki api

Author: rubengees

library/src/main/kotlin/me/proxer/library/ProxerApi.kt

@@ -16,6 +16,7 @@ import me.proxer.library.api.messenger.MessengerApi
 import me.proxer.library.api.notifications.NotificationsApi
 import me.proxer.library.api.ucp.UcpApi
 import me.proxer.library.api.user.UserApi
+import me.proxer.library.api.wiki.WikiApi
 import me.proxer.library.internal.DefaultLoginTokenManager
 import me.proxer.library.internal.adapter.BooleanAdapterFactory
 import me.proxer.library.internal.adapter.ConferenceAdapter
@@ -146,6 +147,12 @@ class ProxerApi private constructor(retrofit: Retrofit) {
     val comment = CommentApi(retrofit)
         @JvmName("comment") get
 
+    /**
+     * The respective API.
+     */
+    val wiki = WikiApi(retrofit)
+        @JvmName("wiki") get
+
     /**
      *
      * You can set customized instances of the internally used libraries: Moshi, OkHttp and Retrofit.

library/src/main/kotlin/me/proxer/library/api/wiki/InternalApi.kt

@@ -0,0 +1,15 @@
+package me.proxer.library.api.wiki
+
+import me.proxer.library.ProxerCall
+import me.proxer.library.entity.wiki.WikiPage
+import retrofit2.http.GET
+import retrofit2.http.Query
+
+/**
+ * @author Ruben Gees
+ */
+internal interface InternalApi {
+
+    @GET("wiki/content")
+    fun content(@Query("title") title: String): ProxerCall<WikiPage>
+}

library/src/main/kotlin/me/proxer/library/api/wiki/WikiApi.kt

@@ -0,0 +1,20 @@
+package me.proxer.library.api.wiki
+
+import retrofit2.Retrofit
+
+/**
+ * API for the User class.
+ *
+ * @author Ruben Gees
+ */
+class WikiApi internal constructor(retrofit: Retrofit) {
+
+    private val internalApi = retrofit.create(InternalApi::class.java)
+
+    /**
+     * Returns the respective endpoint.
+     */
+    fun content(title: String): WikiContentEndpoint {
+        return WikiContentEndpoint(internalApi, title)
+    }
+}

library/src/main/kotlin/me/proxer/library/api/wiki/WikiContentEndpoint.kt

@@ -0,0 +1,20 @@
+package me.proxer.library.api.wiki
+
+import me.proxer.library.ProxerCall
+import me.proxer.library.api.Endpoint
+import me.proxer.library.entity.wiki.WikiPage
+
+/**
+ * Endpoint for requesting the content of a proxer wiki page.
+ *
+ * @author Ruben Gees
+ */
+class WikiContentEndpoint internal constructor(
+    private val internalApi: InternalApi,
+    private val title: String
+) : Endpoint<WikiPage> {
+
+    override fun build(): ProxerCall<WikiPage> {
+        return internalApi.content(title)
+    }
+}

library/src/main/kotlin/me/proxer/library/entity/wiki/WikiPage.kt

@@ -0,0 +1,16 @@
+package me.proxer.library.entity.wiki
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * Entity representing a page of the proxer wiki.
+ *
+ * @property type The type of the source content. Might be something like "html" or "markdown".
+ * @property content The content of the page as html.
+ */
+@JsonClass(generateAdapter = true)
+data class WikiPage(
+    @Json(name = "type") val type: String,
+    @Json(name = "content") val content: String
+)

library/src/test/kotlin/me/proxer/library/api/wiki/WikiContentEndpointTest.kt

@@ -0,0 +1,40 @@
+package me.proxer.library.api.wiki
+
+import me.proxer.library.ProxerTest
+import me.proxer.library.entity.wiki.WikiPage
+import me.proxer.library.runRequest
+import org.amshove.kluent.shouldEqual
+import org.junit.jupiter.api.Test
+
+/**
+ * @author Ruben Gees
+ */
+class WikiContentEndpointTest : ProxerTest() {
+
+    private val expectedContent = WikiPage(
+        "html",
+        "<b>Some content</b>"
+    )
+
+    @Test
+    fun testDefault() {
+        val (result, _) = server.runRequest("wiki_content.json") {
+            api.wiki.content("abc")
+                .build()
+                .execute()
+        }
+
+        result shouldEqual expectedContent
+    }
+
+    @Test
+    fun testPath() {
+        val (_, request) = server.runRequest("wiki_content.json") {
+            api.wiki.content("abc")
+                .build()
+                .execute()
+        }
+
+        request.path shouldEqual "/api/v1/wiki/content?title=abc"
+    }
+}

library/src/test/resources/wiki_content.json

@@ -0,0 +1,8 @@
+{
+  "error": 0,
+  "message": "Abfrage erfolgreich",
+  "data": {
+    "type": "html",
+    "content": "<b>Some content</b>"
+  }
+}