Add issue events API

src/main/java/org/kohsuke/github/GHIssue.java

@@ -430,4 +430,22 @@ public URL getUrl() {
  return GitHub.parseURL(html_url);
  }
  }
+
+ /**
+ * Lists events for this issue.
+ * See https://developer.github.com/v3/issues/events/
+ */
+ public PagedIterable<GHIssueEvent> listEvents() throws IOException {
+ return new PagedIterable<GHIssueEvent>() {
+ public PagedIterator<GHIssueEvent> _iterator(int pageSize) {
+ return new PagedIterator<GHIssueEvent>(root.retrieve().asIterator(owner.getApiTailUrl(String.format("/issues/%s/events", number)), GHIssueEvent[].class, pageSize)) {
+ @Override
+ protected void wrapUp(GHIssueEvent[] page) {
+ for (GHIssueEvent c : page)
+ c.wrapUp(GHIssue.this);
+ }
+ };
+ }
+ };
+ }
 }

src/main/java/org/kohsuke/github/GHIssueEvent.java

@@ -0,0 +1,81 @@
+package org.kohsuke.github;
+
+import java.util.Date;
+
+/**
+ * @author Martin van Zijl
+ */
+public class GHIssueEvent {
+ private GitHub root;
+
+ private long id;
+ private String node_id;
+ private String url;
+ private GHUser actor;
+ private String event;
+ private String commit_id;
+ private String commit_url;
+ private String created_at;
+
+ private GHIssue issue;
+
+ public long getId() {
+ return id;
+ }
+
+ public String getNodeId() {
+ return node_id;
+ }
+
+ public String getUrl() {
+ return url;
+ }
+
+ public GHUser getActor() {
+ return actor;
+ }
+
+ public String getEvent() {
+ return event;
+ }
+
+ public String getCommitId() {
+ return commit_id;
+ }
+
+ public String getCommitUrl() {
+ return commit_url;
+ }
+
+ public Date getCreatedAt() {
+ return GitHub.parseDate(created_at);
+ }
+
+ public GitHub getRoot() {
+ return root;
+ }
+
+ public GHIssue getIssue() {
+ return issue;
+ }
+
+ public GHIssueEvent wrapUp(GitHub root) {
+ this.root = root;
+ return this;
+ }
+
+ public GHIssueEvent wrapUp(GHIssue parent) {
+ this.issue = parent;
+ this.root = parent.root;
+ return this;
+ }
+
+ @Override
+ public String toString() {
+ return String.format("Issue %d was %s by %s on %s",
+ getIssue().getNumber(),
+ getEvent(),
+ getActor().getLogin(),
+ getCreatedAt().toString());
+ }
+}

src/main/java/org/kohsuke/github/GHRepository.java

@@ -1775,4 +1775,30 @@ String getApiTailUrl(String tail) {
  if (tail.length()>0 && !tail.startsWith("/")) tail='/'+tail;
  return "/repos/" + getOwnerName() + "/" + name +tail;
  }
+
+ /**
+ * Get all issue events for this repository.
+ * See https://developer.github.com/v3/issues/events/#list-events-for-a-repository
+ */
+ public PagedIterable<GHIssueEvent> listIssueEvents() throws IOException {
+ return new PagedIterable<GHIssueEvent>() {
+ public PagedIterator<GHIssueEvent> _iterator(int pageSize) {
+ return new PagedIterator<GHIssueEvent>(root.retrieve().asIterator(getApiTailUrl("issues/events"), GHIssueEvent[].class, pageSize)) {
+ @Override
+ protected void wrapUp(GHIssueEvent[] page) {
+ for (GHIssueEvent c : page)
+ c.wrapUp(root);
+ }
+ };
+ }
+ };
+ }
+
+ /**
+ * Get a single issue event.
+ * See https://developer.github.com/v3/issues/events/#get-a-single-event
+ */
+ public GHIssueEvent getIssueEvent(long id) throws IOException {
+ return root.retrieve().to(getApiTailUrl("issues/events/" + id), GHIssueEvent.class).wrapUp(root);
+ }
 }

src/test/java/org/kohsuke/github/GHIssueEventTest.java

@@ -0,0 +1,59 @@
+package org.kohsuke.github;
+
+import java.io.IOException;
+import java.util.List;
+import org.junit.Test;
+
+/**
+ * @author Martin van Zijl
+ */
+public class GHIssueEventTest extends AbstractGitHubApiTestBase {
+
+ @Test
+ public void testEventsForSingleIssue() throws Exception {
+ // Create the issue.
+ GHRepository repo = getRepository();
+ GHIssueBuilder builder = repo.createIssue("Test from the API");
+ GHIssue issue = builder.create();
+
+ // Generate some events.
+ issue.addLabels("test-label");
+
+ // Test that the events are present.
+ List<GHIssueEvent> list = issue.listEvents().asList();
+ assertEquals(1, list.size());
+
+ GHIssueEvent event = list.get(0);
+ assertEquals(issue.getNumber(), event.getIssue().getNumber());
+ assertEquals("labeled", event.getEvent());
+
+ // Test that we can get a single event directly.
+ GHIssueEvent eventFromRepo = repo.getIssueEvent(event.getId());
+ assertEquals(event.getId(), eventFromRepo.getId());
+ assertEquals(event.getCreatedAt(), eventFromRepo.getCreatedAt());
+
+ // Close the issue.
+ issue.close();
+ }
+
+ @Test
+ public void testRepositoryEvents() throws Exception {
+ GHRepository repo = getRepository();
+ List<GHIssueEvent> list = repo.listIssueEvents().asList();
+ assertTrue(list.size() > 0);
+
+ int i = 0;
+ for (GHIssueEvent event : list) {
+ assertNotNull(event.getIssue());
+ if (i++ > 10) break;
+ }
+ }
+
+ protected GHRepository getRepository() throws IOException {
+ return getRepository(gitHub);
+ }
+
+ private GHRepository getRepository(GitHub gitHub) throws IOException {
+ return gitHub.getOrganization("github-api-test-org").getRepository("github-api");
+ }
+}

src/test/resources/org/kohsuke/github/GHIssueEventTest/wiremock/testEventsForSingleIssue/__files/orgs_github-api-test-org-0974905b-3de8-4061-bf78-6c18b9b91f54.json

@@ -0,0 +1,41 @@
+{
+ "login": "github-api-test-org",
+ "id": 7544739,
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjc1NDQ3Mzk=",
+ "url": "https://api.github.com/orgs/github-api-test-org",
+ "repos_url": "https://api.github.com/orgs/github-api-test-org/repos",
+ "events_url": "https://api.github.com/orgs/github-api-test-org/events",
+ "hooks_url": "https://api.github.com/orgs/github-api-test-org/hooks",
+ "issues_url": "https://api.github.com/orgs/github-api-test-org/issues",
+ "members_url": "https://api.github.com/orgs/github-api-test-org/members{/member}",
+ "public_members_url": "https://api.github.com/orgs/github-api-test-org/public_members{/member}",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/7544739?v=4",
+ "description": null,
+ "is_verified": false,
+ "has_organization_projects": true,
+ "has_repository_projects": true,
+ "public_repos": 10,
+ "public_gists": 0,
+ "followers": 0,
+ "following": 0,
+ "html_url": "https://github.com/github-api-test-org",
+ "created_at": "2014-05-10T19:39:11Z",
+ "updated_at": "2015-04-20T00:42:30Z",
+ "type": "Organization",
+ "total_private_repos": 0,
+ "owned_private_repos": 0,
+ "private_gists": 0,
+ "disk_usage": 132,
+ "collaborators": 0,
+ "billing_email": "kk@kohsuke.org",
+ "default_repository_permission": "none",
+ "members_can_create_repositories": false,
+ "two_factor_requirement_enabled": false,
+ "plan": {
+ "name": "free",
+ "space": 976562499,
+ "private_repos": 0,
+ "filled_seats": 7,
+ "seats": 0
+ }
+}