lists: Add “exclusive” parameter for full support (andregasser#379)

* lists: Add exclusive parameter for creating a list

* lists: Make repliesPolicy a nullable value with null default

Do not set the default that is enforced by the Mastodon API anyway
locally in the library.

bigbone-rx/src/main/kotlin/social/bigbone/rx/RxListMethods.kt

@@ -35,13 +35,15 @@ class RxListMethods(client: MastodonClient) {
      * Create a new list.
      * @param title The title of the list to be created.
      * @param repliesPolicy One of [MastodonList.RepliesPolicy], defaults to [MastodonList.RepliesPolicy.List].
+     * @param exclusive Whether members of this list need to get removed from the “Home” feed.
      * @see <a href="https://docs.joinmastodon.org/methods/lists/#create">Mastodon API documentation: methods/lists/#create</a>
      */
     @JvmOverloads
     fun createList(
         title: String,
-        repliesPolicy: MastodonList.RepliesPolicy = MastodonList.RepliesPolicy.LIST
-    ): Single<MastodonList> = Single.fromCallable { listMethods.createList(title, repliesPolicy).execute() }
+        repliesPolicy: MastodonList.RepliesPolicy? = null,
+        exclusive: Boolean? = null
+    ): Single<MastodonList> = Single.fromCallable { listMethods.createList(title, repliesPolicy, exclusive).execute() }
 
     /**
      * Change the title of a list, or which replies to show.

bigbone/src/main/kotlin/social/bigbone/api/method/ListMethods.kt

@@ -41,19 +41,22 @@ class ListMethods(private val client: MastodonClient) {
      * Create a new list.
      * @param title The title of the list to be created.
      * @param repliesPolicy One of [MastodonList.RepliesPolicy], defaults to [MastodonList.RepliesPolicy.List].
+     * @param exclusive Whether members of this list need to get removed from the “Home” feed.
      * @see <a href="https://docs.joinmastodon.org/methods/lists/#create">Mastodon API documentation: methods/lists/#create</a>
      */
     @JvmOverloads
     fun createList(
         title: String,
-        repliesPolicy: MastodonList.RepliesPolicy = MastodonList.RepliesPolicy.LIST
+        repliesPolicy: MastodonList.RepliesPolicy? = null,
+        exclusive: Boolean? = null
     ): MastodonRequest<MastodonList> {
         return client.getMastodonRequest(
             endpoint = "api/v1/lists",
             method = MastodonClient.Method.POST,
             parameters = Parameters().apply {
                 append("title", title)
-                append("replies_policy", repliesPolicy.name.lowercase())
+                repliesPolicy?.let { append("replies_policy", repliesPolicy.name.lowercase()) }
+                exclusive?.let { append("exclusive", exclusive) }
             }
         )
     }

docs/api-coverage/lists.md

@@ -29,8 +29,8 @@ View and manage lists. See also: /api/v1/timelines/list/id for loading a list ti
   </tr>
   <tr>
     <td style="width:45%;text-align:left;"><code>POST /api/v1/lists</code><br>Create a list</td>
-    <td style="width:10%;text-align:center;"><img src="/assets/orange16.png"></td>
-    <td style="width:45%;text-align:left;">Property <code>exclusive</code> is missing which determines “whether members of this list need to get removed from the ‘Home’ feed”</td>
+    <td style="width:10%;text-align:center;"><img src="/assets/green16.png"></td>
+    <td style="width:45%;text-align:left;">Fully supported.</td>
   </tr>
   <tr>
     <td style="width:45%;text-align:left;"><code>PUT /api/v1/lists/:id</code><br>Update a list</td>