feat: add support for wallpaper cave

Author: Bnyro

app/src/main/java/com/bnyro/wallpaper/App.kt

@@ -5,6 +5,7 @@ import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Air
 import androidx.compose.material.icons.filled.AreaChart
 import androidx.compose.material.icons.filled.Book
+import androidx.compose.material.icons.filled.Deblur
 import androidx.compose.material.icons.filled.Forum
 import androidx.compose.material.icons.filled.Landscape
 import androidx.compose.material.icons.filled.LightMode
@@ -34,6 +35,7 @@ import net.youapps.wallpaper_apis.px.GooglePixelApi
 import net.youapps.wallpaper_apis.re.RedditApi
 import net.youapps.wallpaper_apis.sp.MicrosoftSpotlightApi
 import net.youapps.wallpaper_apis.us.UnsplashApi
+import net.youapps.wallpaper_apis.wc.WallpaperCaveApi
 import net.youapps.wallpaper_apis.wh.WallhavenApi
 import net.youapps.wallpaper_apis.wi.WikipediaPotdApi
 import net.youapps.wallpaper_apis.ze.ZedgeApi
@@ -76,14 +78,15 @@ class App : Application(), ImageLoaderFactory {
                 WallpaperApiWrapper(UnsplashApi(), Icons.Default.WaterDrop),
                 WallpaperApiWrapper(PixabayApi(), Icons.Default.Palette),
                 WallpaperApiWrapper(ZedgeApi(), Icons.Default.ScreenLockLandscape),
+                WallpaperApiWrapper(WallpaperCaveApi(), Icons.Default.Deblur),
                 WallpaperApiWrapper(BingApi(), Icons.Default.Nightlight),
                 WallpaperApiWrapper(RedditApi(), Icons.Default.Forum),
                 WallpaperApiWrapper(LemmyApi(), Icons.Default.Book),
                 WallpaperApiWrapper(GooglePixelApi(), Icons.Default.Pix),
                 WallpaperApiWrapper(MicrosoftSpotlightApi(), Icons.Default.LightMode),
                 WallpaperApiWrapper(NasaPotdApi(), Icons.Default.Star),
                 WallpaperApiWrapper(WikipediaPotdApi(), Icons.Default.Today),
-                WallpaperApiWrapper(PicsumApi(), Icons.Default.AreaChart)
+                WallpaperApiWrapper(PicsumApi(), Icons.Default.AreaChart),
             )
         }
     }

wallpaper-apis/src/main/java/net/youapps/wallpaper_apis/wc/WallpaperCave.kt

@@ -1,4 +1,20 @@
 package net.youapps.wallpaper_apis.wc
 
-class WallpaperCave {
+import net.youapps.wallpaper_apis.wc.obj.WallpaperCaveMoreResponse
+import retrofit2.http.Multipart
+import retrofit2.http.POST
+import retrofit2.http.Part
+
+interface WallpaperCave {
+    @POST("/morefeatured")
+    @Multipart
+    suspend fun getFeaturedWallpapers(
+        @Part("page") page: Int
+    ): List<WallpaperCaveMoreResponse>
+
+    @POST("/morelatest")
+    @Multipart
+    suspend fun getLatestWallpapers(
+        @Part("page") page: Int
+    ): List<WallpaperCaveMoreResponse>
 }

wallpaper-apis/src/main/java/net/youapps/wallpaper_apis/wc/WallpaperCaveApi.kt

@@ -1,4 +1,57 @@
 package net.youapps.wallpaper_apis.wc
 
-class WallpaperCaveApi {
+import com.fleeksoft.ksoup.Ksoup
+import net.youapps.wallpaper_apis.RetrofitHelper
+import net.youapps.wallpaper_apis.Wallpaper
+import net.youapps.wallpaper_apis.WallpaperApi
+
+class WallpaperCaveApi: WallpaperApi() {
+    override val name: String = "WallpaperCave"
+    override val baseUrl: String = "https://wallpapercave.com"
+
+    override val availableFilters: Map<String, List<String>> = mapOf("page" to listOf("featured", "latest"))
+
+    private val api: WallpaperCave by lazy {
+        RetrofitHelper.create(baseUrl)
+    }
+
+    private fun parseHtml(html: String): List<Wallpaper> {
+        val doc = Ksoup.parse(html)
+
+        return doc.select("a.wpimg").map {
+            val thumbSrc = baseUrl + it.select("img").attr("src")
+            println(thumbSrc)
+
+            Wallpaper(
+                // "/wpr" seems to be for thumbs, "/wp" for full-res images
+                imgSrc = thumbSrc.replace("/wpr/", "/wp/"),
+                url = baseUrl + it.attr("href"),
+                title = it.attr("title"),
+                thumb = thumbSrc
+            )
+        }
+    }
+
+    override suspend fun getWallpapers(page: Int): List<Wallpaper> {
+        // page is 0-based
+        val pageType = selectedFilters["page"]!!
+        val responseHtml = when (pageType) {
+            "featured" -> {
+                api.getFeaturedWallpapers(page - 1).first().imgs
+            }
+            "latest" -> {
+                api.getLatestWallpapers(page - 1).first().imgs
+            }
+            else -> {
+                throw IllegalArgumentException("unsupported page type")
+            }
+        }
+
+        return parseHtml(responseHtml)
+    }
+
+    override suspend fun getRandomWallpaperUrl(): String? {
+        val response = api.getLatestWallpapers(0).first()
+        return parseHtml(response.imgs).first().url
+    }
 }

wallpaper-apis/src/main/java/net/youapps/wallpaper_apis/wc/obj/WallpaperCaveMoreResponse.kt

@@ -1,4 +1,10 @@
 package net.youapps.wallpaper_apis.wc.obj
 
-class WallpaperCaveMoreResponse {
-}
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class WallpaperCaveMoreResponse(
+    @SerialName("next_page") val nextPage: Int,
+    val imgs: String,
+)