org.kohsuke.github

Class GHCommit

java.lang.Object

org.kohsuke.github.GHCommit

Direct Known Subclasses:

GHCompare.Commit

public class GHCommit
extends Object

A commit in a repository.

Author:

Kohsuke Kawaguchi

See Also:

GHRepository.getCommit(String), GHCommitComment.getCommit()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GHCommit.File A file that was modified.
static class	GHCommit.GHAuthor Deprecated. Use GitUser instead.
static class	GHCommit.Parent
static class	GHCommit.ShortInfo Short summary of this commit.
static class	GHCommit.Stats

Constructor Summary

Constructors

Constructor and Description
GHCommit()

Method Summary

Methods

Modifier and Type	Method and Description
GHCommitComment	createComment(String body)
GHCommitComment	createComment(String body, String path, Integer line, Integer position) Creates a commit comment.
GHUser	getAuthor()
GHCommit.ShortInfo	getCommitShortInfo()
GHUser	getCommitter()
List<GHCommit.File>	getFiles() List of files changed/added/removed in this commit.
URL	getHtmlUrl() URL of this commit like "https://github.com/kohsuke/sandbox-ant/commit/8ae38db0ea5837313ab5f39d43a6f73de3bd9000"
GHCommitStatus	getLastStatus() Gets the last status of this commit, which is what gets shown in the UI.
int	getLinesAdded() Number of lines added.
int	getLinesChanged() Number of lines added + removed.
int	getLinesDeleted() Number of lines removed.
GHRepository	getOwner() The repository that contains the commit.
List<GHCommit>	getParents() Resolves the parent commit objects and return them.
List<String>	getParentSHA1s() Returns the SHA1 of parent commit objects.
String	getSHA1() [0-9a-f]{40} SHA1 checksum.
PagedIterable<GHCommitComment>	listComments() Lists up all the commit comments in this repository.
PagedIterable<GHCommitStatus>	listStatuses() Gets the status of this commit, newer ones first.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GHCommit

public GHCommit()

Method Detail

getCommitShortInfo

public GHCommit.ShortInfo getCommitShortInfo()
                                      throws IOException

Throws:

IOException

getOwner

public GHRepository getOwner()

The repository that contains the commit.

getLinesChanged

public int getLinesChanged()
                    throws IOException

Number of lines added + removed.

Throws:

IOException

getLinesAdded

public int getLinesAdded()
                  throws IOException

Number of lines added.

Throws:

IOException

getLinesDeleted

public int getLinesDeleted()
                    throws IOException

Number of lines removed.

Throws:

IOException

getHtmlUrl

public URL getHtmlUrl()

URL of this commit like "https://github.com/kohsuke/sandbox-ant/commit/8ae38db0ea5837313ab5f39d43a6f73de3bd9000"

getSHA1

public String getSHA1()

[0-9a-f]{40} SHA1 checksum.

getFiles

public List<GHCommit.File> getFiles()
                             throws IOException

List of files changed/added/removed in this commit.

Returns:

Can be empty but never null.

Throws:

IOException

getParentSHA1s

public List<String> getParentSHA1s()

Returns the SHA1 of parent commit objects.

getParents

public List<GHCommit> getParents()
                          throws IOException

Resolves the parent commit objects and return them.

Throws:

IOException

getAuthor

public GHUser getAuthor()
                 throws IOException

Throws:

IOException

getCommitter

public GHUser getCommitter()
                    throws IOException

Throws:

IOException

listComments

public PagedIterable<GHCommitComment> listComments()

Lists up all the commit comments in this repository.

createComment

public GHCommitComment createComment(String body,
                            String path,
                            Integer line,
                            Integer position)
                              throws IOException

Creates a commit comment. I'm not sure how path/line/position parameters interact with each other.

Throws:

IOException

createComment

public GHCommitComment createComment(String body)
                              throws IOException

Throws:

IOException

listStatuses

public PagedIterable<GHCommitStatus> listStatuses()
                                           throws IOException

Gets the status of this commit, newer ones first.

Throws:

IOException

getLastStatus

public GHCommitStatus getLastStatus()
                             throws IOException

Gets the last status of this commit, which is what gets shown in the UI.

Throws:

IOException