feat(pull-request): support pagination in list commits (bisect: bad)

Summary
=======

This commits introduces a test as a ground base to sustain full pagination when listing commits from a pull request

WORK IN PROGRESS

Author: sarlam

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

@@ -32,6 +32,7 @@
 import com.google.common.base.Strings;
 import com.google.common.collect.ImmutableMap;
 import com.spotify.github.async.AsyncPage;
+import com.spotify.github.jackson.Json;
 import com.spotify.github.v3.git.FileItem;
 import com.spotify.github.v3.prs.Comment;
 import com.spotify.github.v3.prs.MergeParameters;
@@ -190,7 +191,8 @@ public CompletableFuture<List<CommitItem>> listCommits(final int prNumber) {
   public CompletableFuture<List<CommitItem>> listCommits(final long prNumber) {
     final String path = String.format(PR_COMMITS_TEMPLATE, owner, repo, prNumber);
     log.debug("Fetching pull request commits from " + path);
-    return github.request(path, LIST_COMMIT_TYPE_REFERENCE);
+    return github.request(path).thenApply(
+        response -> Json.create().fromJsonUncheckedNotNull(response.bodyString(), LIST_COMMIT_TYPE_REFERENCE));
   }
 
   /**

src/test/java/com/spotify/github/v3/clients/PullRequestClientTest.java

@@ -21,10 +21,14 @@
 package com.spotify.github.v3.clients;
 
 import static com.google.common.io.Resources.getResource;
+import static com.spotify.github.MockHelper.createMockHttpResponse;
 import static com.spotify.github.MockHelper.createMockResponse;
+import static com.spotify.github.v3.UserTest.assertUser;
+import static com.spotify.github.v3.clients.GitHubClient.LIST_COMMIT_TYPE_REFERENCE;
 import static java.lang.String.format;
 import static java.nio.charset.Charset.defaultCharset;
 import static java.util.concurrent.CompletableFuture.completedFuture;
+import static java.util.concurrent.CompletableFuture.completedStage;
 import static java.util.stream.Collectors.toList;
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.core.Is.is;
@@ -51,11 +55,13 @@
 import com.spotify.github.v3.prs.requests.ImmutablePullRequestUpdate;
 import com.spotify.github.v3.prs.requests.PullRequestCreate;
 import com.spotify.github.v3.prs.requests.PullRequestUpdate;
+import com.spotify.github.v3.repos.CommitItem;
 import java.io.IOException;
 import java.io.Reader;
 import java.net.URI;
 import java.util.List;
 import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionStage;
 import java.util.concurrent.ExecutionException;
 import okhttp3.Call;
 import okhttp3.Callback;
@@ -464,4 +470,40 @@ public void testListComments() throws Throwable {
     assertThat(comments.get(0).id(), is(10L));
     assertThat(comments.get(0).user().login(), is("octocat"));
   }
+
+  @Test
+  public void listCommits() throws Exception {
+    // Given
+    final String firstPageLink =
+        "<https://api.github.com/repositories/10270250/pulls/20463/commits?page=2>; rel=\"next\", <https://api.github.com/repositories/10270250/pulls/20463/commits?page=4>; rel=\"last\"";
+    final String firstPageBody =
+        Resources.toString(getResource(this.getClass(), "pull_request_commits_page1.json"), defaultCharset());
+    final HttpResponse firstPageResponse = createMockResponse(firstPageLink, firstPageBody);
+
+    final String secondPageLink =
+        "<https://api.github.com/repositories/10270250/pulls/20463/commits?page=1>; rel=\"prev\", <https://api.github.com/repositories/10270250/pulls/20463/commits?page=3>; rel=\"next\", <https://api.github.com/repositories/10270250/pulls/20463/commits?page=3>; rel=\"last\", <https://api.github.com/repositories/10270250/pulls/20463/commits?page=1>; rel=\"first\"";
+    final String secondPageBody =
+        Resources.toString(getResource(this.getClass(), "pull_request_commits_page2.json"), defaultCharset());
+    final HttpResponse secondPageResponse = createMockResponse(secondPageLink, secondPageBody);
+
+    final String thirdPageLink =
+        "<https://api.github.com/repositories/10270250/pulls/20463/commits?page=2>; rel=\"prev\", <https://api.github.com/repositories/10270250/pulls/20463/commits?page=1>; rel=\"first\"";
+    final String thirdPageBody =
+        Resources.toString(getResource(this.getClass(), "pull_request_commits_page3.json"), defaultCharset());
+    final HttpResponse thirdPageResponse = createMockResponse(thirdPageLink, thirdPageBody);
+
+    when(mockGithub.request("/repos/owner/repo/pulls/1/commits"))
+        .thenReturn(completedFuture(firstPageResponse));
+    when(mockGithub.request("/repos/owner/repo/pulls/1/commits?page=1"))
+        .thenReturn(completedFuture(firstPageResponse));
+    when(mockGithub.request("/repos/owner/repo/pulls/1/commits?page=2"))
+        .thenReturn(completedFuture(secondPageResponse));
+    when(mockGithub.request("/repos/owner/repo/pulls/1/commits?page=3"))
+        .thenReturn(completedFuture(thirdPageResponse));
+
+    final PullRequestClient pullRequestClient = PullRequestClient.create(mockGithub, "owner", "repo");
+
+    final List<CommitItem> commits = pullRequestClient.listCommits(1L).get();
+    assertThat(commits.size(), is(1));
+  }
 }