you can now upload cover image

Author: adamint

.idea/modules/SpotifyKotlinWrapper.iml

@@ -46,7 +46,7 @@ To build it, you must pass the application id and secret.
 ```kotlin
     val api = SpotifyAPI.Builder("application id", "application secret").build()
 ```
-*Note:* You are **unable** to use any client endpoint. 
+*Note:* You are **unable** to use any clientApi endpoint. 
 
 ### SpotifyClientAPI
 All endpoints inside SpotifyAPI can be accessed within SpotifyClientAPI.
@@ -122,7 +122,7 @@ In both Track and SimpleTrack objects in an endpoint response, there is a nullab
 If the track is unable to be played in the specified market and there is an alternative that *is* playable, this 
 will be populated with the href, uri, and, most importantly, the id of the track.
 
-You can then use this track in client actions such as playing or saving the track, knowing that it will be playable 
+You can then use this track in clientApi actions such as playing or saving the track, knowing that it will be playable 
 in your market!
 
 ### Endpoint List

.idea/modules/SpotifyKotlinWrapper_main.iml

@@ -3,7 +3,15 @@ package com.adamratzman.spotify.endpoints.priv.playlists
 import com.adamratzman.spotify.main.SpotifyAPI
 import com.adamratzman.spotify.utils.*
 import org.json.JSONObject
+import java.awt.image.BufferedImage
+import java.io.ByteArrayOutputStream
+import java.io.File
+import java.net.URL
 import java.util.function.Supplier
+import javax.imageio.IIOException
+import javax.imageio.ImageIO
+import javax.xml.bind.DatatypeConverter
+
 
 /**
  * Endpoints for retrieving information about a user’s playlists and for managing a user’s playlists.
@@ -146,5 +154,46 @@ class UserPlaylistAPI(api: SpotifyAPI) : SpotifyEndpoint(api) {
         })
     }
 
+    /**
+     * Replace the image used to represent a specific playlist. Image type **must** be jpeg.
+     *
+     * Must specify a JPEG image path or image data, maximum payload size is 256 KB
+     *
+     * @param userId The user’s Spotify user ID.
+     * @param playlistId The Spotify ID for the playlist.
+     * @param imagePath Optionally specify the full local path to the image
+     * @param imageUrl Optionally specify a URL to the image
+     * @param imageFile Optionally specify the image [File]
+     * @param image Optionally specify the image's [BufferedImage] object
+     * @param imageData Optionally specify the Base64-encoded image data yourself
+     *
+     * @throws IIOException if the image is not found
+     * @throws BadRequestException if invalid data is provided
+     */
+    fun uploadPlaylistCover(userId: String, playlistId: String, imagePath: String? = null,
+                            imageFile: File? = null, image: BufferedImage? = null, imageData: String? = null,
+                            imageUrl: String? = null): SpotifyRestAction<Unit> {
+        return toAction(Supplier {
+            val data = imageData ?: when {
+                image != null -> encode(image)
+                imageFile != null -> encode(ImageIO.read(imageFile))
+                imageUrl != null -> encode(ImageIO.read(URL(imageUrl)))
+                imagePath != null -> encode(ImageIO.read(URL("file:///$imagePath")))
+                else -> throw IllegalArgumentException("No cover image was specified")
+            }
+            println(data)
+            put("https://api.spotify.com/v1/users/$userId/playlists/$playlistId/images",
+                    data, contentType = "image/jpeg")
+            Unit
+        })
+    }
+
+    private fun encode(image: BufferedImage): String {
+        val bos = ByteArrayOutputStream()
+        ImageIO.write(image, "jpg", bos)
+        bos.close()
+        return DatatypeConverter.printBase64Binary(bos.toByteArray())
+    }
+
     data class Snapshot(val snapshot_id: String)
 }

.idea/modules/SpotifyKotlinWrapper_test.iml

@@ -129,7 +129,7 @@ class SpotifyClientAPI private constructor(clientId: String, clientSecret: Strin
     enum class Scope(val uri: String) {
         PLAYLIST_READ_PRIVATE("playlist-read-private"),
         PLAYLIST_READ_COLLABORATIVE("playlist-read-collaborative"),
-        PLAYLIST_MODIFY_PUBLIC("playlist-modify-pub"),
+        PLAYLIST_MODIFY_PUBLIC("playlist-modify-public"),
         PLAYLIST_MODIFY_PRIVATE("playlist-modify-private"),
         UGC_IMAGE_UPLOAD("ugc-image-upload"),
         USER_FOLLOW_MODIFY("user-follow-modify"),

README.md

@@ -10,7 +10,6 @@ import java.io.InvalidObjectException
 import java.net.URLEncoder
 import java.util.*
 import java.util.function.Supplier
-import kotlin.collections.HashMap
 
 abstract class SpotifyEndpoint(val api: SpotifyAPI) {
     fun get(url: String): String {
@@ -21,25 +20,28 @@ abstract class SpotifyEndpoint(val api: SpotifyAPI) {
         return execute(url, body, Connection.Method.POST)
     }
 
-    fun put(url: String, body: String? = null): String {
-        return execute(url, body, Connection.Method.PUT)
+    fun put(url: String, body: String? = null, contentType: String? = null): String {
+        return execute(url, body, Connection.Method.PUT, contentType = contentType)
     }
 
     fun delete(url: String, body: String? = null): String {
         return execute(url, body, Connection.Method.DELETE)
     }
 
-    private fun execute(url: String, body: String? = null, method: Connection.Method = Connection.Method.GET, retry202: Boolean = true): String {
+    private fun execute(url: String, body: String? = null, method: Connection.Method = Connection.Method.GET, retry202: Boolean = true, contentType: String? = null): String {
         if (api !is SpotifyClientAPI && System.currentTimeMillis() >= api.expireTime) {
             api.refreshClient()
             api.expireTime = System.currentTimeMillis() + api.token.expires_in * 1000
         }
         var connection = Jsoup.connect(url).ignoreContentType(true)
+        if (contentType != null) connection.header("Content-Type", contentType)
         if (body != null) {
-            connection = if (method == Connection.Method.DELETE) {
-                val key = JSONObject(body).keySet().toList()[0]
-                connection.data(key, JSONObject(body).getJSONArray(key).toString())
-            } else connection.requestBody(body)
+            if (contentType != null) connection.requestBody(body)
+            else
+                connection = if (method == Connection.Method.DELETE) {
+                    val key = JSONObject(body).keySet().toList()[0]
+                    connection.data(key, JSONObject(body).getJSONArray(key).toString())
+                } else connection.requestBody(body)
         }
         connection = connection.header("Authorization", "Bearer ${api.token.access_token}")
         val document = connection.ignoreHttpErrors(true).method(method).execute()
@@ -53,6 +55,7 @@ abstract class SpotifyEndpoint(val api: SpotifyAPI) {
 
 data class CursorBasedPagingObject<out T>(val href: String, val items: List<T>, val limit: Int, val next: String?, val cursors: Cursor,
                                           val total: Int)
+
 data class Cursor(val after: String)
 data class PagingObject<out T>(val href: String, val items: List<T>, val limit: Int, val next: String? = null, val offset: Int = 0, val previous: String? = null, val total: Int)
 data class PlaylistTrackPagingObject(val href: String, val items: List<PlaylistTrack>, val limit: Int, val next: String? = null, val offset: Int = 0, val previous: String? = null, val total: Int)
@@ -66,12 +69,14 @@ data class LinkedResult<out T>(val href: String, val items: List<T>) {
         }
         throw InvalidObjectException("This object is not linked to a playlist")
     }
+
     fun getArtistId(): String {
         if (href.startsWith("https://api.spotify.com/v1/artists/")) {
             return href.removePrefix("https://api.spotify.com/v1/artists/").split("/")[0]
         }
         throw InvalidObjectException("This object is not linked to an artist")
     }
+
     fun getAlbumId(): String {
         if (href.startsWith("https://api.spotify.com/v1/albums/")) {
             return href.removePrefix("https://api.spotify.com/v1/albums/").split("/")[0]

src/main/kotlin/com/adamratzman/spotify/endpoints/priv/playlists/UserPlaylistAPI.kt

@@ -1,6 +1,6 @@
 package com.adamratzman.spotify.kotlin.endpoints.priv.follow
 
-import com.adamratzman.spotify.main.clientApi
+import clientApi
 import org.junit.Test
 
 class UserFollowAPITest {

src/main/kotlin/com/adamratzman/spotify/main/SpotifyAPI.kt

@@ -1,6 +1,6 @@
 package com.adamratzman.spotify.kotlin.endpoints.priv.personalization
 
-import com.adamratzman.spotify.main.clientApi
+import clientApi
 import org.junit.Test
 
 internal class PersonalizationAPITest {

src/main/kotlin/com/adamratzman/spotify/utils/Helpers.kt

@@ -1,7 +1,7 @@
 package com.adamratzman.spotify.kotlin.endpoints.priv.player
 
+import clientApi
 import com.adamratzman.spotify.endpoints.priv.player.PlayerAPI
-import com.adamratzman.spotify.main.clientApi
 import org.junit.Test
 
 class PlayerAPITest {