feat: Add updateTeamPermissions for TeamClient

src/main/java/com/spotify/github/v3/clients/TeamClient.java

@@ -18,7 +18,6 @@
  * -/-/-
  */
 
-
 package com.spotify.github.v3.clients;
 
 import static com.spotify.github.v3.clients.GitHubClient.*;
@@ -28,13 +27,17 @@
 import com.spotify.github.v3.User;
 import com.spotify.github.v3.orgs.Membership;
 import com.spotify.github.v3.orgs.TeamInvitation;
+import com.spotify.github.v3.orgs.requests.ImmutableTeamRepoPermissionUpdate;
 import com.spotify.github.v3.orgs.requests.MembershipCreate;
 import com.spotify.github.v3.orgs.requests.TeamCreate;
+import com.spotify.github.v3.orgs.requests.TeamRepoPermissionUpdate;
 import com.spotify.github.v3.orgs.requests.TeamUpdate;
 import java.lang.invoke.MethodHandles;
 import java.util.Iterator;
 import java.util.List;
 import java.util.concurrent.CompletableFuture;
+
+import com.spotify.github.v3.repos.RepositoryPermission;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -54,6 +57,8 @@
 
   private static final String INVITATIONS_TEMPLATE = "/orgs/%s/teams/%s/invitations";
 
+  private static final String REPO_TEMPLATE = "/orgs/%s/teams/%s/repos/%s/%s";
+
   private final GitHubClient github;
 
   private final String org;
@@ -75,7 +80,7 @@
    */
   public CompletableFuture<Team> createTeam(final TeamCreate request) {
     final String path = String.format(TEAM_TEMPLATE, org);
-    log.debug("Creating team in: " + path);
+    log.debug("Creating team in: {}", path);
     return github.post(path, github.json().toJsonUnchecked(request), Team.class);
   }
 
@@ -87,7 +92,7 @@
    */
   public CompletableFuture<Team> getTeam(final String slug) {
     final String path = String.format(TEAM_SLUG_TEMPLATE, org, slug);
-    log.debug("Fetching team from " + path);
+    log.debug("Fetching team from {}", path);
     return github.request(path, Team.class);
   }
 
@@ -98,7 +103,7 @@
    */
   public CompletableFuture<List<Team>> listTeams() {
     final String path = String.format(TEAM_TEMPLATE, org);
-    log.debug("Fetching teams from " + path);
+    log.debug("Fetching teams from {}", path);
     return github.request(path, LIST_TEAMS);
   }
 
@@ -111,7 +116,7 @@
    */
   public CompletableFuture<Team> updateTeam(final TeamUpdate request, final String slug) {
     final String path = String.format(TEAM_SLUG_TEMPLATE, org, slug);
-    log.debug("Updating team in: " + path);
+    log.debug("Updating team in: {}", path);
     return github.patch(path, github.json().toJsonUnchecked(request), Team.class);
   }
 
@@ -123,7 +128,7 @@
    */
   public CompletableFuture<Void> deleteTeam(final String slug) {
     final String path = String.format(TEAM_SLUG_TEMPLATE, org, slug);
-    log.debug("Deleting team from: " + path);
+    log.debug("Deleting team from: {}", path);
     return github.delete(path).thenAccept(IGNORE_RESPONSE_CONSUMER);
   }
 
@@ -133,9 +138,10 @@
    * @param request update membership request
    * @return membership
    */
-  public CompletableFuture<Membership> updateMembership(final MembershipCreate request, final String slug, final String username) {
+  public CompletableFuture<Membership> updateMembership(
+      final MembershipCreate request, final String slug, final String username) {
     final String path = String.format(MEMBERSHIP_TEMPLATE, org, slug, username);
-    log.debug("Updating membership in: " + path);
+    log.debug("Updating membership in: {}", path);
     return github.put(path, github.json().toJsonUnchecked(request), Membership.class);
   }
 
@@ -148,7 +154,7 @@
    */
   public CompletableFuture<Membership> getMembership(final String slug, final String username) {
     final String path = String.format(MEMBERSHIP_TEMPLATE, org, slug, username);
-    log.debug("Fetching membership for: " + path);
+    log.debug("Fetching membership for: {}", path);
     return github.request(path, Membership.class);
   }
 
@@ -160,7 +166,7 @@
    */
   public CompletableFuture<List<User>> listTeamMembers(final String slug) {
     final String path = String.format(MEMBERS_TEMPLATE, org, slug);
-    log.debug("Fetching members for: " + path);
+    log.debug("Fetching members for: {}", path);
     return github.request(path, LIST_TEAM_MEMBERS);
   }
 
@@ -173,7 +179,7 @@
    */
   public Iterator<AsyncPage<User>> listTeamMembers(final String slug, final int pageSize) {
     final String path = String.format(PAGED_MEMBERS_TEMPLATE, org, slug, pageSize);
-    log.debug("Fetching members for: " + path);
+    log.debug("Fetching members for: {}", path);
     return new GithubPageIterator<>(new GithubPage<>(github, path, LIST_TEAM_MEMBERS));
   }
 
@@ -185,7 +191,7 @@
    */
   public CompletableFuture<Void> deleteMembership(final String slug, final String username) {
     final String path = String.format(MEMBERSHIP_TEMPLATE, org, slug, username);
-    log.debug("Deleting membership from: " + path);
+    log.debug("Deleting membership from: {}", path);
     return github.delete(path).thenAccept(IGNORE_RESPONSE_CONSUMER);
   }
 
@@ -197,7 +203,44 @@
    */
   public CompletableFuture<List<TeamInvitation>> listPendingTeamInvitations(final String slug) {
     final String path = String.format(INVITATIONS_TEMPLATE, org, slug);
-    log.debug("Fetching pending invitations for: " + path);
+    log.debug("Fetching pending invitations for: {}", path);
     return github.request(path, LIST_PENDING_TEAM_INVITATIONS);
   }
+
+  /**
+   * Update permissions for a team on a specific repository.
+   *
+   * @param slug the team slug
+   * @param repo the repository name
+   * @param permission the permission level (pull, push, maintain, triage, admin, or a custom repo defined role name)
+   * @return void status code 204 if successful
+   */
+  public CompletableFuture<Void> updateTeamPermissions(
+      final String slug, final String repo, final String permission) {
+    final String path = String.format(REPO_TEMPLATE, org, slug, org, repo);
+    final TeamRepoPermissionUpdate request =
+        ImmutableTeamRepoPermissionUpdate.builder()
+            .org(org)
+            .repo(repo)
+            .teamSlug(slug)
+            .permission(permission)
+            .build();
+    log.debug("Updating team permissions for: {}", path);
+    return github
+        .put(path, github.json().toJsonUnchecked(request))
+        .thenAccept(IGNORE_RESPONSE_CONSUMER);
+  }
+
+  /**
+   * Update permissions for a team on a specific repository.
+   *
+   * @param slug the team slug
+   * @param repo the repository name
+   * @param permission the permission level (pull, push, maintain, triage, admin, or a custom repo defined role name)
+   * @return void status code 204 if successful
+   */
+  public CompletableFuture<Void> updateTeamPermissions(
+          final String slug, final String repo, final RepositoryPermission permission) {
+    return updateTeamPermissions(slug, repo, permission.toString());
+  }
 }

src/main/java/com/spotify/github/v3/orgs/requests/TeamRepoPermissionUpdate.java

@@ -0,0 +1,38 @@
+/*-
+ * -\-\-
+ * github-api
+ * --
+ * Copyright (C) 2016 - 2020 Spotify AB
+ * --
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * -/-/-
+ */
+
+package com.spotify.github.v3.orgs.requests;
+
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.fasterxml.jackson.databind.annotation.JsonSerialize;
+import com.spotify.github.GithubStyle;
+import org.immutables.value.Value;
+
+/** Request to update permissions of a team for a specific repo */
+@Value.Immutable
+@GithubStyle
+@JsonSerialize(as = ImmutableTeamRepoPermissionUpdate.class)
+@JsonDeserialize(as = ImmutableTeamRepoPermissionUpdate.class)
+public interface TeamRepoPermissionUpdate {
+    String org();
+    String repo();
+    String teamSlug();
+    String permission();
+}