API underpinnings for Image Recommendations, part 2. (#3992)

Author: dbrant

app/src/main/java/org/wikipedia/dataclient/Service.kt

@@ -581,6 +581,11 @@ interface Service {
         @Query("pageids") pageIds: String? = null
     ): MwQueryResponse
 
+    @GET(MW_API_PREFIX + "action=paraminfo")
+    suspend fun getParamInfo(
+        @Query("modules") modules: String
+    ): ParamInfoResponse
+
     companion object {
         const val WIKIPEDIA_URL = "https://wikipedia.org/"
         const val WIKIDATA_URL = "https://www.wikidata.org/"

app/src/main/java/org/wikipedia/dataclient/mwapi/ParamInfoResponse.kt

@@ -0,0 +1,39 @@
+package org.wikipedia.dataclient.mwapi
+
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.JsonElement
+import kotlinx.serialization.json.jsonArray
+import kotlinx.serialization.json.jsonPrimitive
+
+@Suppress("unused")
+@Serializable
+class ParamInfoResponse : MwResponse() {
+
+    val paraminfo: ParamInfo? = null
+
+    @Serializable
+    class ParamInfo {
+        val modules: List<Module> = emptyList()
+    }
+
+    @Serializable
+    class Module {
+        val name = ""
+        val classname = ""
+        val path = ""
+        val source = ""
+        val parameters: List<Parameter> = emptyList()
+    }
+
+    @Serializable
+    class Parameter {
+        val index = 0
+        val name = ""
+        val required = false
+        val multi = false
+        val type: JsonElement? = null
+
+        val typeAsString get() = type?.jsonPrimitive?.content.orEmpty()
+        val typeAsEnum get() = type?.jsonArray?.map { it.jsonPrimitive.content } ?: emptyList()
+    }
+}