feat(api): add a Retrofit service for search

api/src/test/kotlin/dev/msfjarvis/claw/api/ApiWrapper.kt

@@ -14,7 +14,7 @@ import dev.msfjarvis.claw.model.LobstersPost
 import dev.msfjarvis.claw.model.LobstersPostDetails
 import dev.msfjarvis.claw.model.Tags
 import dev.msfjarvis.claw.model.User
-import dev.msfjarvis.claw.util.TestUtils.getJson
+import dev.msfjarvis.claw.util.TestUtils.getResource
 import kotlinx.serialization.ExperimentalSerializationApi
 import kotlinx.serialization.json.Json
 import kotlinx.serialization.json.JsonNamingStrategy
@@ -25,13 +25,13 @@ class ApiWrapper(controller: EitherNetController<LobstersApi>) {
     ignoreUnknownKeys = true
     namingStrategy = JsonNamingStrategy.SnakeCase
   }
-  private val hottest: List<LobstersPost> = json.decodeFromString(getJson("hottest.json"))
+  private val hottest: List<LobstersPost> = json.decodeFromString(getResource("hottest.json"))
   private val postDetails: LobstersPostDetails =
-    json.decodeFromString(getJson("post_details_tdfoqh.json"))
-  private val user: User = json.decodeFromString(getJson("msfjarvis.json"))
-  private val metaPosts: List<LobstersPost> = json.decodeFromString(getJson("meta.json"))
+    json.decodeFromString(getResource("post_details_tdfoqh.json"))
+  private val user: User = json.decodeFromString(getResource("msfjarvis.json"))
+  private val metaPosts: List<LobstersPost> = json.decodeFromString(getResource("meta.json"))
   private val programmingRustPosts: List<LobstersPost> =
-    json.decodeFromString(getJson("programming_rust.json"))
+    json.decodeFromString(getResource("programming_rust.json"))
   private val getPostsBody = { args: Array<Any> ->
     val tags = args[0] as Tags
     if ("meta" in tags) {

api/src/test/kotlin/dev/msfjarvis/claw/api/SearchApiTest.kt

@@ -0,0 +1,59 @@
+/*
+ * Copyright © 2023 Harsh Shandilya.
+ * Use of this source code is governed by an MIT-style
+ * license that can be found in the LICENSE file or at
+ * https://opensource.org/licenses/MIT.
+ */
+package dev.msfjarvis.claw.api
+
+import com.google.common.truth.Truth.assertThat
+import com.slack.eithernet.ApiResult
+import com.slack.eithernet.test.newEitherNetController
+import dev.msfjarvis.claw.model.LobstersPost
+import dev.msfjarvis.claw.model.User
+import dev.msfjarvis.claw.util.TestUtils.assertIs
+import kotlinx.coroutines.test.runTest
+import org.junit.jupiter.api.Test
+
+class SearchApiTest {
+  private val wrapper = SearchApiWrapper(newEitherNetController())
+  private val api
+    get() = wrapper.api
+
+  @Test
+  fun `search is able to parse HTML`() = runTest {
+    val posts = api.searchPosts("ChatGPT", 1)
+    assertIs<ApiResult.Success<List<LobstersPost>>>(posts)
+    assertThat(posts.value).containsAtLeastElementsIn(results).inOrder()
+    assertThat(posts.value).hasSize(20)
+  }
+
+  private companion object {
+    private val results =
+      listOf(
+        LobstersPost(
+          shortId = "gjlsdg",
+          title = "ChatGPT visits the Emacs doctor",
+          url = "https://xenodium.com/chatgpt-visits-the-emacs-doctor/",
+          createdAt = "",
+          commentCount = 3,
+          commentsUrl = "/s/gjlsdg/chatgpt_visits_emacs_doctor",
+          submitter = User("xenodium", "", null, "/avatars/xenodium-16.png", ""),
+          tags = listOf("ai", "emacs"),
+          description = "",
+        ),
+        LobstersPost(
+          shortId = "astcqf",
+          title =
+            "Implementing a question-answering system for PDF documents using ChatGPT and Redis",
+          url = "https://mstack.nl/blog/20230623-chatgpt-question-pdf-document/",
+          createdAt = "",
+          commentCount = 0,
+          commentsUrl = "/s/astcqf/implementing_question_answering_system",
+          submitter = User("asteroid", "", null, "/avatars/asteroid-16.png", ""),
+          tags = listOf("ai"),
+          description = "",
+        ),
+      )
+  }
+}

api/src/test/kotlin/dev/msfjarvis/claw/api/SearchApiWrapper.kt

@@ -0,0 +1,30 @@
+/*
+ * Copyright © 2023 Harsh Shandilya.
+ * Use of this source code is governed by an MIT-style
+ * license that can be found in the LICENSE file or at
+ * https://opensource.org/licenses/MIT.
+ */
+package dev.msfjarvis.claw.api
+
+import com.slack.eithernet.ApiResult.Companion.success
+import com.slack.eithernet.test.EitherNetController
+import com.slack.eithernet.test.enqueue
+import dev.msfjarvis.claw.api.converters.SearchConverter
+import dev.msfjarvis.claw.util.TestUtils.getResource
+import okhttp3.MediaType
+import okhttp3.ResponseBody
+
+class SearchApiWrapper(controller: EitherNetController<LobstersSearchApi>) {
+  val api = controller.api
+
+  init {
+    controller.enqueue(LobstersSearchApi::searchPosts) {
+      success(
+        SearchConverter()
+          .convert(
+            ResponseBody.create(MediaType.get("text/html"), getResource("search_chatgpt_page.html"))
+          )
+      )
+    }
+  }
+}

api/src/test/kotlin/dev/msfjarvis/claw/util/TestUtils.kt

@@ -13,7 +13,7 @@ import kotlin.contracts.contract
 
 @OptIn(ExperimentalContracts::class)
 object TestUtils {
-  fun getJson(path: String): String {
+  fun getResource(path: String): String {
     // Load the JSON response
     val uri = javaClass.classLoader!!.getResource(path)
     val file = File(uri.path)