Added a test

Trivial change to enable creating/updating binary content (files).

pom.xml

@@ -7,7 +7,7 @@
   </parent>
 
   <artifactId>github-api</artifactId>
-  <version>1.59</version>
+  <version>1.60-SNAPSHOT</version>
   <name>GitHub API for Java</name>
   <url>http://github-api.kohsuke.org/</url>
   <description>GitHub API for Java</description>
@@ -35,7 +35,7 @@
       <plugin>
         <groupId>com.infradna.tool</groupId>
         <artifactId>bridge-method-injector</artifactId>
-        <version>1.12</version>
+        <version>1.14</version>
         <executions>
           <execution>
             <goals>
@@ -77,7 +77,7 @@
     <dependency>
       <groupId>com.infradna.tool</groupId>
       <artifactId>bridge-method-annotation</artifactId>
-      <version>1.12</version>
+      <version>1.14</version>
     </dependency>
     <dependency>
       <groupId>org.kohsuke.stapler</groupId>
@@ -107,6 +107,7 @@
       <groupId>org.mockito</groupId>
       <artifactId>mockito-all</artifactId>
       <version>1.9.5</version>
+      <scope>test</scope>
     </dependency>
   </dependencies>
   <repositories>

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

@@ -1,26 +1,21 @@
 package org.kohsuke.github;
 
 import java.io.IOException;
-import java.util.Date;
 
 /**
  * Asset in a release.
  *
  * @see GHRelease#getAssets()
  */
-public class GHAsset {
+public class GHAsset extends GHObject {
     GitHub root;
     GHRepository owner;
-    private String url;
-    private String id;
     private String name;
     private String label;
     private String state;
     private String content_type;
     private long size;
     private long download_count;
-    private Date created_at;
-    private Date updated_at;
     private String browser_download_url;
 
     public String getContentType() {
@@ -32,18 +27,10 @@ public class GHAsset {
         this.content_type = contentType;
     }
 
-    public Date getCreatedAt() {
-        return created_at;
-    }
-
     public long getDownloadCount() {
         return download_count;
     }
 
-    public String getId() {
-        return id;
-    }
-
     public String getLabel() {
         return label;
     }
@@ -73,14 +60,6 @@ public class GHAsset {
         return state;
     }
 
-    public Date getUpdatedAt() {
-        return updated_at;
-    }
-
-    public String getUrl() {
-        return url;
-    }
-
     public String getBrowserDownloadUrl() {
         return browser_download_url;
     }

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

@@ -12,7 +12,7 @@ import java.util.List;
  * @see GitHub#createToken(Collection, String, String)
  * @see http://developer.github.com/v3/oauth/#create-a-new-authorization
  */
-public class GHAuthorization {
+public class GHAuthorization extends GHObject {
 	public static final String USER = "user";
 	public static final String USER_EMAIL = "user:email";
 	public static final String USER_FOLLOW = "user:follow";
@@ -33,24 +33,16 @@ public class GHAuthorization {
 	public static final String ADMIN_KEY = "admin:public_key";
 
 	private GitHub root;
-	private int id;
-	private String url;
 	private List<String> scopes;
 	private String token;
 	private App app;
 	private String note;
 	private String note_url;
-	private String updated_at;
-	private String created_at;
 
     public GitHub getRoot() {
         return root;
     }
 
-	public int getId() {
-		return id;
-	}
-
 	public List<String> getScopes() {
 		return scopes;
 	}
@@ -78,14 +70,6 @@ public class GHAuthorization {
 	public URL getNoteUrl(){
         return GitHub.parseURL(note_url);
 	}
-	
-	public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
-    public Date getUpdatedAt() {
-        return GitHub.parseDate(updated_at);
-    }
 
 	/*package*/ GHAuthorization wrap(GitHub root) {
 		this.root = root;

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

@@ -12,13 +12,11 @@ import java.util.Date;
  * @see GHCommit#listComments()
  * @see GHCommit#createComment(String, String, Integer, Integer)
  */
-public class GHCommitComment {
+public class GHCommitComment extends GHObject {
     private GHRepository owner;
 
-    String updated_at, created_at;
-    String body, url, html_url, commit_id;
+    String body, html_url, commit_id;
     Integer line;
-    int id;
     String path;
     User user;
 
@@ -32,14 +30,6 @@ public class GHCommitComment {
         return owner;
     }
 
-    public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
-    public Date getUpdatedAt() {
-        return GitHub.parseDate(updated_at);
-    }
-
     /**
      * URL like 'https://github.com/kohsuke/sandbox-ant/commit/8ae38db0ea5837313ab5f39d43a6f73de3bd9000#commitcomment-1252827' to
      * show this commit comment in a browser.
@@ -75,10 +65,6 @@ public class GHCommitComment {
         return line!=null ? line : -1;
     }
 
-    public int getId() {
-        return id;
-    }
-
     /**
      * Gets the user who put this comment.
      */

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

@@ -10,12 +10,9 @@ import java.util.Date;
  * @see GHRepository#getCommitStatus(String)
  * @see GHCommit#getStatus()
  */
-public class GHCommitStatus {
-    String created_at, updated_at;
+public class GHCommitStatus extends GHObject {
     String state;
     String target_url,description;
-    int id;
-    String url;
     String context;
     GHUser creator;
 
@@ -27,14 +24,6 @@ public class GHCommitStatus {
         return this;
     }
 
-    public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
-    public Date getUpdatedAt() {
-        return GitHub.parseDate(updated_at);
-    }
-
     public GHCommitState getState() {
         for (GHCommitState s : GHCommitState.values()) {
             if (s.name().equalsIgnoreCase(state))
@@ -56,17 +45,6 @@ public class GHCommitStatus {
         return description;
     }
 
-    public int getId() {
-        return id;
-    }
-
-    /**
-     * API URL of this commit status.
-     */
-    public String getUrl() {
-        return url;
-    }
-
     public GHUser getCreator() {
         return creator;
     }

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

@@ -148,6 +148,6 @@ public class GHCompare {
     }
 
     public static enum Status {
-        behind, ahead, identical
+        behind, ahead, identical, diverged
     }
 }

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

@@ -129,11 +129,19 @@ public class GHContent {
     }
 
     public GHContentUpdateResponse update(String newContent, String commitMessage) throws IOException {
-        return update(newContent, commitMessage, null);
+        return update(newContent.getBytes(), commitMessage, null);
     }
 
     public GHContentUpdateResponse update(String newContent, String commitMessage, String branch) throws IOException {
-        String encodedContent = DatatypeConverter.printBase64Binary(newContent.getBytes());
+        return update(newContent.getBytes(), commitMessage, branch);
+    }
+
+    public GHContentUpdateResponse update(byte[] newContentBytes, String commitMessage) throws IOException {
+        return update(newContentBytes, commitMessage, null);
+    }
+
+    public GHContentUpdateResponse update(byte[] newContentBytes, String commitMessage, String branch) throws IOException {
+        String encodedContent = DatatypeConverter.printBase64Binary(newContentBytes);
 
         Requester requester = new Requester(owner.root)
             .with("path", path)

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

@@ -0,0 +1,53 @@
+package org.kohsuke.github;
+
+
+import java.net.URL;
+
+public class GHDeployment extends GHObject {
+    private GHRepository owner;
+    private GitHub root;
+    protected String sha;
+    protected String ref;
+    protected String task;
+    protected Object payload;
+    protected String environment;
+    protected String description;
+    protected String statuses_url;
+    protected String repository_url;
+    protected GHUser creator;
+
+
+    GHDeployment wrap(GHRepository owner) {
+        this.owner = owner;
+        this.root = owner.root;
+        if(creator != null) creator.wrapUp(root);
+        return this;
+    }
+
+    public URL getStatusesUrl() {
+        return GitHub.parseURL(statuses_url);
+    }
+
+    public URL getRepositoryUrl() {
+        return GitHub.parseURL(repository_url);
+    }
+
+    public String getTask() {
+        return task;
+    }
+    public String getPayload() {
+        return (String) payload;
+    }
+    public String getEnvironment() {
+        return environment;
+    }
+    public GHUser getCreator() {
+        return creator;
+    }
+    public String getRef() {
+        return ref;
+    }
+    public String getSha(){
+        return sha;
+    }
+}

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

@@ -0,0 +1,55 @@
+package org.kohsuke.github;
+
+import java.io.IOException;
+import java.util.List;
+
+//Based on https://developer.github.com/v3/repos/deployments/#create-a-deployment
+public class GHDeploymentBuilder {
+    private final GHRepository repo;
+    private final Requester builder;
+
+    public GHDeploymentBuilder(GHRepository repo) {
+        this.repo = repo;
+        this.builder = new Requester(repo.root);
+    }
+
+    public GHDeploymentBuilder(GHRepository repo, String ref) {
+        this(repo);
+        ref(ref);
+    }
+
+    public GHDeploymentBuilder ref(String branch) {
+        builder.with("ref",branch);
+        return this;
+    }
+    public GHDeploymentBuilder task(String task) {
+        builder.with("task",task);
+        return this;
+    }
+    public GHDeploymentBuilder autoMerge(boolean autoMerge) {
+        builder.with("auto_merge",autoMerge);
+        return this;
+    }
+
+    public GHDeploymentBuilder requiredContexts(List<String> requiredContexts) {
+        builder.with("required_contexts",requiredContexts);
+        return this;
+    }
+    public GHDeploymentBuilder payload(String payload) {
+        builder.with("payload",payload);
+        return this;
+    }
+
+    public GHDeploymentBuilder environment(String environment) {
+        builder.with("environment",environment);
+        return this;
+    }
+    public GHDeploymentBuilder description(String description) {
+        builder.with("description",description);
+        return this;
+    }
+
+    public GHDeployment create() throws IOException {
+        return builder.to(repo.getApiTailUrl("deployments"),GHDeployment.class).wrap(repo);
+    }
+}

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

@@ -0,0 +1,8 @@
+package org.kohsuke.github;
+
+/**
+ * Represents the state of deployment
+ */
+public enum GHDeploymentState {
+    PENDING, SUCCESS, ERROR, FAILURE
+}

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

@@ -0,0 +1,36 @@
+package org.kohsuke.github;
+
+import java.net.URL;
+
+public class GHDeploymentStatus extends GHObject {
+    private GHRepository owner;
+    private GitHub root;
+    protected GHUser creator;
+    protected String state;
+    protected String description;
+    protected String target_url;
+    protected String deployment_url;
+    protected String repository_url;
+    public GHDeploymentStatus wrap(GHRepository owner) {
+        this.owner = owner;
+        this.root = owner.root;
+        if(creator != null) creator.wrapUp(root);
+        return this;
+    }
+    public URL getTargetUrl() {
+        return GitHub.parseURL(target_url);
+    }
+
+    public URL getDeploymentUrl() {
+        return GitHub.parseURL(deployment_url);
+    }
+
+    public URL getRepositoryUrl() {
+        return GitHub.parseURL(repository_url);
+    }
+    public GHDeploymentState getState() {
+        return GHDeploymentState.valueOf(state.toUpperCase());
+    }
+
+
+}

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

@@ -0,0 +1,30 @@
+package org.kohsuke.github;
+
+import java.io.IOException;
+
+public class GHDeploymentStatusBuilder {
+    private final Requester builder;
+    private GHRepository repo;
+    private int deploymentId;
+
+    public GHDeploymentStatusBuilder(GHRepository repo, int deploymentId, GHDeploymentState state) {
+        this.repo = repo;
+        this.deploymentId = deploymentId;
+        this.builder = new Requester(repo.root);
+        this.builder.with("state",state.toString().toLowerCase());
+    }
+
+    public GHDeploymentStatusBuilder description(String description) {
+      this.builder.with("description",description);
+      return this;
+    }
+
+    public GHDeploymentStatusBuilder targetUrl(String targetUrl) {
+        this.builder.with("target_url",targetUrl);
+        return this;
+    }
+
+    public GHDeploymentStatus create() throws IOException {
+        return builder.to(repo.getApiTailUrl("deployments")+"/"+deploymentId+"/statuses",GHDeploymentStatus.class).wrap(repo);
+    }
+}

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

@@ -4,7 +4,6 @@ import com.fasterxml.jackson.annotation.JsonProperty;
 
 import java.io.IOException;
 import java.util.Collections;
-import java.util.Date;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Map.Entry;
@@ -17,16 +16,16 @@ import java.util.Map.Entry;
  * @see GitHub#getGist(String)
  * @see GitHub#createGist()
  */
-public class GHGist {
+public class GHGist extends GHObject {
     /*package almost final*/ GHUser owner;
     /*package almost final*/ GitHub root;
 
-    private String url, forks_url, commits_url, id, git_pull_url, git_push_url, html_url;
+    private String forks_url, commits_url, id, git_pull_url, git_push_url, html_url;
 
     @JsonProperty("public")
     private boolean _public;
 
-    private String created_at, updated_at, description;
+    private String description;
 
     private int comments;
 
@@ -41,13 +40,6 @@ public class GHGist {
         return owner;
     }
 
-    /**
-     * API URL of this gist, such as 'https://api.github.com/gists/12345'
-     */
-    public String getUrl() {
-        return url;
-    }
-
     public String getForksUrl() {
         return forks_url;
     }
@@ -56,13 +48,6 @@ public class GHGist {
         return commits_url;
     }
 
-    /**
-     * ID of this gist, such as '12345'
-     */
-    public String getId() {
-        return id;
-    }
-
     /**
      * URL like https://gist.github.com/gists/12345.git
      */
@@ -82,14 +67,6 @@ public class GHGist {
         return _public;
     }
 
-    public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
-    public Date getUpdatedAt() {
-        return GitHub.parseDate(updated_at);
-    }
-
     public String getDescription() {
         return description;
     }

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

@@ -10,18 +10,17 @@ import java.util.Map;
 /**
  * @author Kohsuke Kawaguchi
  */
-public class GHHook {
+public class GHHook extends GHObject {
     /**
      * Repository that the hook belongs to.
      */
     /*package*/ transient GHRepository repository;
     
-    String created_at, updated_at, name;
+    String name;
     List<String> events;
     boolean active;
     Map<String,String> config;
-    int id;
-    
+
     /*package*/ GHHook wrap(GHRepository owner) {
         this.repository = owner;
         return this;
@@ -46,10 +45,6 @@ public class GHHook {
         return Collections.unmodifiableMap(config);
     }
 
-    public int getId() {
-        return id;
-    }
-
     /**
      * Deletes this hook.
      */

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

@@ -37,8 +37,11 @@ import java.util.Locale;
  *
  * @author Eric Maupin
  * @author Kohsuke Kawaguchi
+ * @see GHRepository#getIssue(int)
+ * @see GitHub#searchIssues()
+ * @see GHIssueSearchBuilder
  */
-public class GHIssue {
+public class GHIssue extends GHObject {
     GitHub root;
     GHRepository owner;
 	
@@ -51,11 +54,9 @@ public class GHIssue {
     protected String body;
     protected List<Label> labels;
     protected GHUser user;
-    protected String title, created_at, html_url;
+    protected String title, html_url;
     protected GHIssue.PullRequest pull_request;
     protected GHMilestone milestone;
-	protected String url, updated_at;
-    protected int id;
     protected GHUser closed_by;
 
     public static class Label {
@@ -78,8 +79,12 @@ public class GHIssue {
     
     /*package*/ GHIssue wrap(GHRepository owner) {
         this.owner = owner;
-        this.root = owner.root;
-		if(milestone != null) milestone.wrap(owner);
+        if(milestone != null) milestone.wrap(owner);
+        return wrap(owner.root);
+    }
+
+    /*package*/ GHIssue wrap(GitHub root) {
+        this.root = root;
 		if(assignee != null) assignee.wrapUp(root);
 		if(user != null) user.wrapUp(root);
 		if(closed_by != null) closed_by.wrapUp(root);
@@ -117,7 +122,7 @@ public class GHIssue {
      * The HTML page of this issue,
      * like https://github.com/jenkinsci/jenkins/issues/100
      */
-    public URL getUrl() {
+    public URL getHtmlUrl() {
         return GitHub.parseURL(html_url);
     }
 
@@ -136,14 +141,6 @@ public class GHIssue {
         return Collections.unmodifiableList(labels);
     }
 
-    public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
-    public Date getUpdatedAt() {
-        return GitHub.parseDate(updated_at);
-    }
-
     public Date getClosedAt() {
         return GitHub.parseDate(closed_at);
     }

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

@@ -32,12 +32,10 @@ import java.util.Date;
  *
  * @author Kohsuke Kawaguchi
  */
-public class GHIssueComment {
+public class GHIssueComment extends GHObject {
     GHIssue owner;
 
-    private String body, gravatar_id, created_at, updated_at;
-    private URL url;
-    private int id;
+    private String body, gravatar_id;
     private GHUser user;
 
     /*package*/ GHIssueComment wrapUp(GHIssue owner) {
@@ -59,22 +57,6 @@ public class GHIssueComment {
         return body;
     }
 
-    public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
-    public Date getUpdatedAt() {
-        return GitHub.parseDate(updated_at);
-    }
-
-    public int getId() {
-        return id;
-    }
-
-    public URL getUrl() {
-        return url;
-    }
-
     /**
      * Gets the ID of the user who posted this comment.
      */

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

@@ -0,0 +1,85 @@
+package org.kohsuke.github;
+
+import org.apache.commons.lang.StringUtils;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+
+/**
+ * Search issues.
+ *
+ * @author Kohsuke Kawaguchi
+ * @see GitHub#searchIssues()
+ */
+public class GHIssueSearchBuilder {
+    private final GitHub root;
+    private final Requester req;
+    private final List<String> terms = new ArrayList<String>();
+
+    /*package*/ GHIssueSearchBuilder(GitHub root) {
+        this.root = root;
+        req = root.retrieve();
+    }
+
+    /**
+     * Search terms.
+     */
+    public GHIssueSearchBuilder q(String term) {
+        terms.add(term);
+        return this;
+    }
+
+    public GHIssueSearchBuilder mentions(GHUser u) {
+        return mentions(u.getLogin());
+    }
+
+    public GHIssueSearchBuilder mentions(String login) {
+        return q("mentions:"+login);
+    }
+
+    public GHIssueSearchBuilder isOpen() {
+        return q("is:open");
+    }
+
+    public GHIssueSearchBuilder isClosed() {
+        return q("is:closed");
+    }
+
+    public GHIssueSearchBuilder isMerged() {
+        return q("is:merged");
+    }
+
+    public GHIssueSearchBuilder sort(Sort sort) {
+        req.with("sort",sort.toString().toLowerCase(Locale.ENGLISH));
+        return this;
+    }
+
+    public enum Sort { COMMENTS, CREATED, UPDATED }
+
+    private static class IssueSearchResult extends SearchResult<GHIssue> {
+        private GHIssue[] items;
+
+        @Override
+        public GHIssue[] getItems() {
+            return items;
+        }
+    }
+
+    /**
+     * Lists up the issues with the criteria built so far.
+     */
+    public PagedSearchIterable<GHIssue> list() {
+        return new PagedSearchIterable<GHIssue>() {
+            public PagedIterator<GHIssue> iterator() {
+                req.set("q", StringUtils.join(terms," "));
+                return new PagedIterator<GHIssue>(adapt(req.asIterator("/search/issues", IssueSearchResult.class))) {
+                    protected void wrapUp(GHIssue[] page) {
+                        for (GHIssue c : page)
+                            c.wrap(root);
+                    }
+                };
+            }
+        };
+    }
+}

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

@@ -9,12 +9,12 @@ import java.util.Locale;
  * @author Yusuke Kokubo
  *
  */
-public class GHMilestone {
+public class GHMilestone extends GHObject {
     GitHub root;
 	GHRepository owner;
 
 	GHUser creator;
-	private String state, due_on, title, url, created_at, description;
+	private String state, due_on, title, description;
 	private int closed_issues, open_issues, number;
 
 	public GitHub getRoot() {
@@ -38,14 +38,6 @@ public class GHMilestone {
 		return title;
 	}
 	
-	public String getUrl() {
-		return url;
-	}
-	
-	public Date getCreatedAt() {
-		return GitHub.parseDate(created_at);
-	}
-	
 	public String getDescription() {
 		return description;
 	}

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

@@ -0,0 +1,63 @@
+package org.kohsuke.github;
+
+import com.infradna.tool.bridge_method_injector.WithBridgeMethods;
+
+import java.io.IOException;
+import java.net.URL;
+import java.util.Date;
+
+/**
+ * Most (all?) domain objects in GitHub seems to have these 4 properties.
+ */
+public abstract class GHObject {
+    protected String url;
+    protected int id;
+    protected String created_at;
+    protected String updated_at;
+
+    /*package*/ GHObject() {
+    }
+
+    /**
+     * When was this resource created?
+     */
+    @WithBridgeMethods(value=String.class, adapterMethod="createdAtStr")
+    public Date getCreatedAt() throws IOException {
+        return GitHub.parseDate(created_at);
+    }
+
+    private Object createdAtStr(Date id, Class type) {
+        return created_at;
+    }
+
+    /**
+     * API URL of this object.
+     */
+    @WithBridgeMethods(value=String.class, adapterMethod="urlToString")
+    public URL getUrl() {
+        return GitHub.parseURL(url);
+    }
+
+    /**
+     * When was this resource last updated?
+     */
+    public Date getUpdatedAt() throws IOException {
+        return GitHub.parseDate(updated_at);
+    }
+
+    /**
+     * Unique ID number of this resource.
+     */
+    @WithBridgeMethods(value=String.class, adapterMethod="intToString")
+    public int getId() {
+        return id;
+    }
+
+    private Object intToString(int id, Class type) {
+        return String.valueOf(id);
+    }
+
+    private Object urlToString(URL url, Class type) {
+        return url==null ? null : url.toString();
+    }
+}

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

@@ -4,6 +4,7 @@ import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.Collections;
+import java.util.Date;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
@@ -14,15 +15,14 @@ import java.util.TreeMap;
  * 
  * @author Kohsuke Kawaguchi
  */
-public abstract class GHPerson {
+public abstract class GHPerson extends GHObject {
     /*package almost final*/ GitHub root;
 
     // core data fields that exist even for "small" user data (such as the user info in pull request)
-    protected String login, avatar_url, url, gravatar_id;
-    protected int id;
+    protected String login, avatar_url, gravatar_id;
 
     // other fields (that only show up in full data)
-    protected String location,blog,email,name,created_at,company;
+    protected String location,blog,email,name,company;
     protected String html_url;
     protected int followers,following,public_repos,public_gists;
 
@@ -196,9 +196,14 @@ public abstract class GHPerson {
         return location;
     }
 
-    public String getCreatedAt() throws IOException {
+    public Date getCreatedAt() throws IOException {
         populate();
-        return created_at;
+        return super.getCreatedAt();
+    }
+
+    public Date getUpdatedAt() throws IOException {
+        populate();
+        return super.getCreatedAt();
     }
 
     /**
@@ -236,13 +241,6 @@ public abstract class GHPerson {
         return following;
     }
 
-    /**
-     * What appears to be a GitHub internal unique number that identifies this user.
-     */
-    public int getId() {
-        return id;
-    }
-
     public int getFollowersCount() throws IOException {
         populate();
         return followers;

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

@@ -110,7 +110,7 @@ public class GHPullRequest extends GHIssue {
     }
 
 	@Deprecated
-    public Date getIssueUpdatedAt() {
+    public Date getIssueUpdatedAt() throws IOException {
         return super.getUpdatedAt();
     }
 

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

@@ -15,22 +15,19 @@ import static java.lang.String.format;
  * @see GHRepository#getReleases()
  * @see GHRepository#createRelease(String)
  */
-public class GHRelease {
+public class GHRelease extends GHObject {
     GitHub root;
     GHRepository owner;
 
-    private String url;
     private String html_url;
     private String assets_url;
     private String upload_url;
-    private long id;
     private String tag_name;
     private String target_commitish;
     private String name;
     private String body;
     private boolean draft;
     private boolean prerelease;
-    private Date created_at;
     private Date published_at;
     private String tarball_url;
     private String zipball_url;
@@ -39,50 +36,18 @@ public class GHRelease {
         return assets_url;
     }
 
-    public void setAssetsUrl(String assets_url) {
-        this.assets_url = assets_url;
-    }
-
     public String getBody() {
         return body;
     }
 
-    public void setBody(String body) {
-        this.body = body;
-    }
-
-    public Date getCreatedAt() {
-        return created_at;
-    }
-
-    public void setCreatedAt(Date created_at) {
-        this.created_at = created_at;
-    }
-
     public boolean isDraft() {
         return draft;
     }
 
-    public void setDraft(boolean draft) {
-        this.draft = draft;
-    }
-
     public String getHtmlUrl() {
         return html_url;
     }
 
-    public void setHtmlUrl(String html_url) {
-        this.html_url = html_url;
-    }
-
-    public long getId() {
-        return id;
-    }
-
-    public void setId(long id) {
-        this.id = id;
-    }
-
     public String getName() {
         return name;
     }
@@ -103,74 +68,34 @@ public class GHRelease {
         return prerelease;
     }
 
-    public void setPrerelease(boolean prerelease) {
-        this.prerelease = prerelease;
-    }
-
     public Date getPublished_at() {
         return published_at;
     }
 
-    public void setPublished_at(Date published_at) {
-        this.published_at = published_at;
-    }
-
     public GitHub getRoot() {
         return root;
     }
 
-    public void setRoot(GitHub root) {
-        this.root = root;
-    }
-
     public String getTagName() {
         return tag_name;
     }
 
-    public void setTagName(String tag_name) {
-        this.tag_name = tag_name;
-    }
-
     public String getTargetCommitish() {
         return target_commitish;
     }
 
-    public void setTargetCommitish(String target_commitish) {
-        this.target_commitish = target_commitish;
-    }
-
     public String getUploadUrl() {
         return upload_url;
     }
 
-    public void setUploadUrl(String upload_url) {
-        this.upload_url = upload_url;
-    }
-
-    public String getUrl() {
-        return url;
-    }
-
-    public void setUrl(String url) {
-        this.url = url;
-    }
-
     public String getZipballUrl() {
         return zipball_url;
     }
 
-    public void setZipballUrl(String zipballUrl) {
-        this.zipball_url = zipballUrl;
-    }
-
     public String getTarballUrl() {
         return tarball_url;
     }
 
-    public void setTarballUrl(String tarballUrl) {
-        this.tarball_url = tarballUrl;
-    }
-
     GHRelease wrap(GHRepository owner) {
         this.owner = owner;
         this.root = owner.root;

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

@@ -25,28 +25,16 @@ package org.kohsuke.github;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 import com.infradna.tool.bridge_method_injector.WithBridgeMethods;
-import java.io.FileNotFoundException;
+import org.apache.commons.lang.StringUtils;
 
 import javax.xml.bind.DatatypeConverter;
+import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.io.InterruptedIOException;
 import java.net.URL;
-import java.util.AbstractSet;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Collection;
-import java.util.Collections;
-import java.util.Date;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Set;
-import java.util.TreeMap;
+import java.util.*;
 
-import static java.util.Arrays.*;
+import static java.util.Arrays.asList;
 
 /**
  * A repository on GitHub.
@@ -54,11 +42,10 @@ import static java.util.Arrays.*;
  * @author Kohsuke Kawaguchi
  */
 @SuppressWarnings({"UnusedDeclaration"})
-public class GHRepository {
+public class GHRepository extends GHObject {
     /*package almost final*/ GitHub root;
 
     private String description, homepage, name, full_name;
-    private String url; // this is the API url
     private String html_url;    // this is the UI
     private String git_url, ssh_url, clone_url, svn_url;
     private GHUser owner;   // not fully populated. beware.
@@ -66,7 +53,7 @@ public class GHRepository {
     @JsonProperty("private")
     private boolean _private;
     private int watchers,forks,open_issues,size,network_count,subscribers_count;
-    private String created_at, pushed_at;
+    private String pushed_at;
     private Map<Integer,GHMilestone> milestones = new HashMap<Integer, GHMilestone>();
     
     private String default_branch,language;
@@ -74,6 +61,59 @@ public class GHRepository {
 
     private GHRepoPermission permissions;
 
+    public GHDeploymentBuilder createDeployment(String ref) {
+        return new GHDeploymentBuilder(this,ref);
+    }
+
+    public PagedIterable<GHDeploymentStatus> getDeploymentStatuses(final int id) {
+        return new PagedIterable<GHDeploymentStatus>() {
+            public PagedIterator<GHDeploymentStatus> iterator() {
+                return new PagedIterator<GHDeploymentStatus>(root.retrieve().asIterator(getApiTailUrl("deployments")+"/"+id+"/statuses", GHDeploymentStatus[].class)) {
+                    @Override
+                    protected void wrapUp(GHDeploymentStatus[] page) {
+                        for (GHDeploymentStatus c : page)
+                            c.wrap(GHRepository.this);
+                    }
+                };
+            }
+        };
+    }
+
+    public PagedIterable<GHDeployment> listDeployments(String sha,String ref,String task,String environment){
+        List<String> params = Arrays.asList(getParam("sha", sha), getParam("ref", ref), getParam("task", task), getParam("environment", environment));
+        final String deploymentsUrl = getApiTailUrl("deployments") + "?"+ join(params,"&");
+        return new PagedIterable<GHDeployment>() {
+            public PagedIterator<GHDeployment> iterator() {
+                return new PagedIterator<GHDeployment>(root.retrieve().asIterator(deploymentsUrl, GHDeployment[].class)) {
+                    @Override
+                    protected void wrapUp(GHDeployment[] page) {
+                        for (GHDeployment c : page)
+                            c.wrap(GHRepository.this);
+                    }
+                };
+            }
+        };
+
+    }
+
+    private String join(List<String> params, String joinStr) {
+        StringBuilder output = new StringBuilder();
+        for(String param: params){
+            if(param != null){
+               output.append(param+joinStr);
+            }
+        }
+        return output.toString();
+    }
+
+    private String getParam(String name, String value) {
+        return StringUtils.trimToNull(value)== null? null: name+"="+value;
+    }
+
+    public GHDeploymentStatusBuilder createDeployStatus(int deploymentId, GHDeploymentState ghDeploymentState) {
+        return new GHDeploymentStatusBuilder(this,deploymentId,ghDeploymentState);
+    }
+
     private static class GHRepoPermission {
         boolean pull,push,admin;
     }
@@ -87,13 +127,6 @@ public class GHRepository {
         return homepage;
     }
 
-    /**
-     * URL of this repository, like 'http://github.com/kohsuke/jenkins'
-     */
-    public String getUrl() {
-        return html_url;
-    }
-
     /**
      * Gets the git:// URL to this repository, such as "git://github.com/kohsuke/jenkins.git"
      * This URL is read-only.
@@ -305,10 +338,6 @@ public class GHRepository {
         return GitHub.parseDate(pushed_at);
     }
 
-    public Date getCreatedAt() {
-        return GitHub.parseDate(created_at);
-    }
-
     /**
      * Returns the primary branch you'll configure in the "Admin > Options" config page.
      *
@@ -940,14 +969,22 @@ public class GHRepository {
     }
 
     public GHContentUpdateResponse createContent(String content, String commitMessage, String path) throws IOException {
-        return createContent(content, commitMessage, path, null);
+        return createContent(content.getBytes(), commitMessage, path, null);
     }
 
     public GHContentUpdateResponse createContent(String content, String commitMessage, String path, String branch) throws IOException {
+        return createContent(content.getBytes(), commitMessage, path, branch);
+    }
+
+    public GHContentUpdateResponse createContent(byte[] contentBytes, String commitMessage, String path) throws IOException {
+        return createContent(contentBytes, commitMessage, path, null);
+    }
+
+    public GHContentUpdateResponse createContent(byte[] contentBytes, String commitMessage, String path, String branch) throws IOException {
         Requester requester = new Requester(root)
             .with("path", path)
             .with("message", commitMessage)
-            .with("content", DatatypeConverter.printBase64Binary(content.getBytes()))
+            .with("content", DatatypeConverter.printBase64Binary(contentBytes))
             .method("PUT");
 
         if (branch != null) {

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

@@ -1,8 +1,7 @@
 package org.kohsuke.github;
 
 import java.io.IOException;
-import java.util.Arrays;
-import java.util.HashSet;
+import java.util.Collections;
 import java.util.Map;
 import java.util.Set;
 import java.util.TreeMap;
@@ -48,13 +47,26 @@ public class GHTeam {
         return id;
     }
 
-    /**
-     * Retrieves the current members.
-     */
-    public Set<GHUser> getMembers() throws IOException {
-        return new HashSet<GHUser>(Arrays.asList(GHUser.wrap(org.root.retrieve().to(api("/members"), GHUser[].class), org.root)));
+	/**
+	 * Retrieves the current members.
+	 */
+	public PagedIterable<GHUser> listMembers() throws IOException {
+        return new PagedIterable<GHUser>() {
+            public PagedIterator<GHUser> iterator() {
+                return new PagedIterator<GHUser>(org.root.retrieve().asIterator(api("/members"), GHUser[].class)) {
+                    @Override
+                    protected void wrapUp(GHUser[] page) {
+                        GHUser.wrap(page, org.root);
+                    }
+                };
+            }
+        };
     }
 
+    public Set<GHUser> getMembers() throws IOException {
+		return Collections.unmodifiableSet(listMembers().asSet());
+	}
+
     /**
      * Checks if this team has the specified user as a member.
      */
@@ -68,14 +80,27 @@ public class GHTeam {
     }
 
     public Map<String,GHRepository> getRepositories() throws IOException {
-        GHRepository[] repos = org.root.retrieve().to(api("/repos"), GHRepository[].class);
         Map<String,GHRepository> m = new TreeMap<String, GHRepository>();
-        for (GHRepository r : repos) {
-            m.put(r.getName(),r.wrap(org.root));
+        for (GHRepository r : listRepositories()) {
+            m.put(r.getName(), r);
         }
         return m;
     }
 
+    public PagedIterable<GHRepository> listRepositories() {
+        return new PagedIterable<GHRepository>() {
+            public PagedIterator<GHRepository> iterator() {
+                return new PagedIterator<GHRepository>(org.root.retrieve().asIterator(api("/repos"), GHRepository[].class)) {
+                    @Override
+                    protected void wrapUp(GHRepository[] page) {
+                        for (GHRepository r : page)
+                            r.wrap(org.root);
+                    }
+                };
+            }
+        };
+    }
+
     /**
      * Adds a member to the team.
      *

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

@@ -424,6 +424,14 @@ public class GitHub {
         }
     }
 
+    /**
+     * Search issues.
+     */
+    public GHIssueSearchBuilder searchIssues() {
+        return new GHIssueSearchBuilder(this);
+    }
+
+
     /*package*/ static URL parseURL(String s) {
         try {
             return s==null ? null : new URL(s);

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

@@ -1,7 +1,9 @@
 package org.kohsuke.github;
 
 import java.util.ArrayList;
+import java.util.LinkedHashSet;
 import java.util.List;
+import java.util.Set;
 
 /**
  * {@link Iterable} that returns {@link PagedIterator}
@@ -21,4 +23,15 @@ public abstract class PagedIterable<T> implements Iterable<T> {
         }
         return r;
     }
+
+    /**
+     * Eagerly walk {@link Iterable} and return the result in a set.
+     */
+    public Set<T> asSet() {
+        LinkedHashSet<T> r = new LinkedHashSet<T>();
+        for(PagedIterator<T> i = iterator(); i.hasNext();) {
+            r.addAll(i.nextPage());
+        }
+        return r;
+    }
 }

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

@@ -0,0 +1,54 @@
+package org.kohsuke.github;
+
+import java.util.Iterator;
+
+/**
+ * {@link PagedIterable} enhanced to report search result specific information.
+ *
+ * @author Kohsuke Kawaguchi
+ */
+public abstract class PagedSearchIterable<T> extends PagedIterable<T> {
+    /**
+     * As soon as we have any result fetched, it's set here so that we can report the total count.
+     */
+    private SearchResult<T> result;
+
+    /**
+     * Returns the total number of hit, including the results that's not yet fetched.
+     */
+    public int getTotalCount() {
+        populate();
+        return result.total_count;
+    }
+
+    public boolean isIncomplete() {
+        populate();
+        return result.incomplete_results;
+    }
+
+    private void populate() {
+        if (result==null)
+            iterator().hasNext();
+    }
+
+    /**
+     * Adapts {@link Iterator}.
+     */
+    protected Iterator<T[]> adapt(final Iterator<? extends SearchResult<T>> base) {
+        return new Iterator<T[]>() {
+            public boolean hasNext() {
+                return base.hasNext();
+            }
+
+            public T[] next() {
+                SearchResult<T> v = base.next();
+                if (result==null)   result = v;
+                return v.getItems();
+            }
+
+            public void remove() {
+                throw new UnsupportedOperationException();
+            }
+        };
+    }
+}

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

@@ -134,6 +134,19 @@ class Requester {
         return this;
     }
 
+    /**
+     * Unlike {@link #with(String, String)}, overrides the existing value
+     */
+    public Requester set(String key, Object value) {
+        for (Entry e : args) {
+            if (e.key.equals(key)) {
+                e.value = value;
+                return this;
+            }
+        }
+        return _with(key,value);
+    }
+
     public Requester method(String method) {
         this.method = method;
         return this;

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

@@ -0,0 +1,13 @@
+package org.kohsuke.github;
+
+/**
+ * Represents the result of a search
+ *
+ * @author Kohsuke Kawaguchi
+ */
+abstract class SearchResult<T> {
+    int total_count;
+    boolean incomplete_results;
+
+    public abstract T[] getItems();
+}

src/test/java/Foo.java

@@ -1,6 +1,9 @@
+import org.kohsuke.github.GHIssue;
 import org.kohsuke.github.GHOrganization;
 import org.kohsuke.github.GHTeam;
 import org.kohsuke.github.GitHub;
+import org.kohsuke.github.PagedIterable;
+import org.kohsuke.github.PagedSearchIterable;
 
 import java.util.Arrays;
 import java.util.Map;
@@ -10,14 +13,10 @@ import java.util.Map;
  */
 public class Foo {
     public static void main(String[] args) throws Exception {
-        GHOrganization org = GitHub.connect().getOrganization("jenkinsci");
-        Map<String, GHTeam> teams = org.getTeams();
-        System.out.println(teams.size());
-
-        int sz = 0;
-        for (GHTeam t : org.listTeams()) {
-            sz++;
+        PagedSearchIterable<GHIssue> reviewbybees = GitHub.connect().searchIssues().mentions("reviewbybees").isOpen().list();
+        for (GHIssue r : reviewbybees) {
+            System.out.println(r.getTitle());
         }
-        System.out.println(sz);
+        System.out.println("total="+reviewbybees.getTotalCount());
     }
 }

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

@@ -1,22 +1,17 @@
 package org.kohsuke.github;
 
-import java.io.IOException;
-import java.net.URL;
-import java.util.ArrayList;
-import java.util.Date;
-import java.util.List;
-import java.util.Map;
-import java.util.Map.Entry;
-import java.util.Set;
-import java.util.UUID;
-
+import com.google.common.base.Predicate;
+import com.google.common.collect.Iterables;
+import com.google.common.collect.Lists;
 import org.junit.Assume;
 import org.junit.Test;
 import org.kohsuke.github.GHCommit.File;
 import org.kohsuke.github.GHOrganization.Permission;
 
-import com.google.common.base.Predicate;
-import com.google.common.collect.Iterables;
+import java.io.IOException;
+import java.net.URL;
+import java.util.*;
+import java.util.Map.Entry;
 
 /**
  * Unit test for simple App.
@@ -82,6 +77,51 @@ public class AppTest extends AbstractGitHubApiTestBase {
         o.close();
     }
 
+    @Test
+    public void testCreateDeployment() throws IOException {
+        GHRepository repository = getTestRepository();
+        GHDeployment deployment = repository.createDeployment("master")
+                .payload("{\"user\":\"atmos\",\"room_id\":123456}")
+                .description("question")
+                .create();
+        assertNotNull(deployment.getCreator());
+        assertNotNull(deployment.getId());
+    }
+
+    @Test
+    public void testListDeployments() throws IOException {
+        GHRepository repository = getTestRepository();
+        GHDeployment deployment = repository.createDeployment("master")
+                .payload("{\"user\":\"atmos\",\"room_id\":123456}")
+                .description("question")
+                .environment("unittest")
+                .create();
+        assertNotNull(deployment.getCreator());
+        assertNotNull(deployment.getId());
+        ArrayList<GHDeployment> deployments = Lists.newArrayList(repository.listDeployments(null, "master", null, "unittest"));
+        assertNotNull(deployments);
+        assertFalse(Iterables.isEmpty(deployments));
+        GHDeployment unitTestDeployment = deployments.get(0);
+        assertEquals("unittest",unitTestDeployment.getEnvironment());
+        assertEquals("master", unitTestDeployment.getRef());
+    }
+
+    @Test
+    public void testGetDeploymentStatuses() throws IOException {
+        GHRepository repository = getTestRepository();
+        GHDeployment deployment = repository.createDeployment("master")
+                .description("question")
+                .payload("{\"user\":\"atmos\",\"room_id\":123456}")
+                .create();
+       GHDeploymentStatus ghDeploymentStatus = repository.createDeployStatus(deployment.getId(), GHDeploymentState.SUCCESS)
+                                     .description("success")
+                                     .targetUrl("http://www.github.com").create();
+        Iterable<GHDeploymentStatus> deploymentStatuses = repository.getDeploymentStatuses(deployment.getId());
+        assertNotNull(deploymentStatuses);
+        assertEquals(1,Iterables.size(deploymentStatuses));
+        assertEquals(ghDeploymentStatus.getId(), Iterables.get(deploymentStatuses, 0).getId());
+    }
+
     @Test
     public void testGetIssues() throws Exception {
         List<GHIssue> closedIssues = gitHub.getUser("kohsuke").getRepository("github-api").getIssues(GHIssueState.CLOSED);
@@ -243,7 +283,7 @@ public class AppTest extends AbstractGitHubApiTestBase {
     @Test
     public void testGetTeamsForRepo() throws Exception {
         kohsuke();
-        assertEquals(1,gitHub.getOrganization("github-api-test-org").getRepository("testGetTeamsForRepo").getTeams().size());
+        assertEquals(1, gitHub.getOrganization("github-api-test-org").getRepository("testGetTeamsForRepo").getTeams().size());
     }
 
     @Test
@@ -266,7 +306,7 @@ public class AppTest extends AbstractGitHubApiTestBase {
             assertNotNull(t.getName());
             sz++;
         }
-        assertTrue(sz<100);
+        assertTrue(sz < 100);
     }
 
     @Test
@@ -458,7 +498,7 @@ public class AppTest extends AbstractGitHubApiTestBase {
         long start = System.currentTimeMillis();
         Map<String, GHRepository> repos = j.getRepositories();
         long end = System.currentTimeMillis();
-        System.out.printf("%d repositories in %dms\n",repos.size(),end-start);
+        System.out.printf("%d repositories in %dms\n", repos.size(), end - start);
     }
     
     @Test
@@ -484,7 +524,7 @@ public class AppTest extends AbstractGitHubApiTestBase {
         state = lst.get(0);
         System.out.println(state);
         assertEquals("testing!",state.getDescription());
-        assertEquals("http://kohsuke.org/",state.getTargetUrl());
+        assertEquals("http://kohsuke.org/", state.getTargetUrl());
     }
     
     @Test
@@ -600,6 +640,24 @@ public class AppTest extends AbstractGitHubApiTestBase {
     	 
     }
 
+    @Test
+    public void testMemberPagenation() throws IOException {
+        Set<GHUser> all = new HashSet<GHUser>();
+        for (GHUser u : gitHub.getOrganization("github-api-test-org").getTeamByName("Core Developers").listMembers()) {
+            System.out.println(u.getLogin());
+            all.add(u);
+        }
+        assertFalse(all.isEmpty());
+    }
+
+    @Test
+    public void testIssueSearch() throws IOException {
+        PagedSearchIterable<GHIssue> r = gitHub.searchIssues().mentions("kohsuke").isOpen().list();
+        for (GHIssue i : r) {
+            System.out.println(i.getTitle());
+        }
+    }
+
     private void kohsuke() {
         String login = getUser().getLogin();
         Assume.assumeTrue(login.equals("kohsuke") || login.equals("kohsuke2"));