Package org.kohsuke.github

Class GHBranch

java.lang.Object

org.kohsuke.github.GHBranch

public class GHBranch
extends Object

A branch in a repository.

Author:

Yusuke Kokubo

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GHBranch.Commit	The type Commit.

Method Summary

Modifier and Type	Method	Description
void	disableProtection()	Disables branch protection and allows anyone with push access to push changes.
GHBranchProtectionBuilder	enableProtection()	Deprecated.
void	enableProtection(EnforcementLevel level, Collection<String> contexts)	Deprecated.
String	getName()	Gets name.
GHRepository	getOwner()	Gets owner.
GHBranchProtection	getProtection()	Deprecated.
URL	getProtectionUrl()	Deprecated.
GitHub	getRoot()	Gets root.
String	getSHA1()	Gets sha 1.
boolean	isProtected()	Deprecated.
GHCommit	merge(String head, String commitMessage)	Merge a ref into this branch.
GHCommit	merge(GHBranch headBranch, String commitMessage)	Merge a branch into this branch.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getRoot

public GitHub getRoot()

Gets root.

Returns:

the root

getOwner

public GHRepository getOwner()

Gets owner.

Returns:

the repository that this branch is in.

getName

public String getName()

Gets name.

Returns:

the name

isProtected

@Preview(LUKE_CAGE)
@Deprecated
public boolean isProtected()

Deprecated.

Is protected boolean.

Returns:

true if the push to this branch is restricted via branch protection.

getProtectionUrl

@Preview(LUKE_CAGE)
@Deprecated
public URL getProtectionUrl()

Deprecated.

Gets protection url.

Returns:

API URL that deals with the protection of this branch.

getProtection

@Preview(LUKE_CAGE)
@Deprecated
public GHBranchProtection getProtection()
                                 throws IOException

Deprecated.

Gets protection.

Returns:

the protection

Throws:

IOException - the io exception

getSHA1

public String getSHA1()

Gets sha 1.

Returns:

The SHA1 of the commit that this branch currently points to.

disableProtection

public void disableProtection()
                       throws IOException

Disables branch protection and allows anyone with push access to push changes.

Throws:

IOException - if disabling protection fails

enableProtection

@Preview(LUKE_CAGE)
@Deprecated
public GHBranchProtectionBuilder enableProtection()

Deprecated.

Enables branch protection to control what commit statuses are required to push.

Returns:

GHBranchProtectionBuilder for enabling protection

See Also:

GHCommitStatus#getContext()

enableProtection

@Deprecated
public void enableProtection(EnforcementLevel level,
                             Collection<String> contexts)
                      throws IOException

Deprecated.

Enable protection.

Parameters:

level - the level

contexts - the contexts

Throws:

IOException - the io exception

merge

@CheckForNull
public GHCommit merge(GHBranch headBranch,
                      String commitMessage)
               throws IOException

Merge a branch into this branch.

Parameters:

headBranch - the branch whose head will be merged

commitMessage - the commit message

Returns:

the merge GHCommit created, or null if the base already contains the head (nothing to merge).

Throws:

IOException - if merging fails

merge

@CheckForNull
public GHCommit merge(String head,
                      String commitMessage)
               throws IOException

Merge a ref into this branch.

Parameters:

head - the ref name that will be merged into this branch. Follows the usual ref naming rules, could be a branch name, tag, or commit sha.

commitMessage - the commit message

Returns:

the merge GHCommit created, or null if the base already contains the head (nothing to merge).

Throws:

IOException - if merging fails

toString

public String toString()

Overrides:

toString in class Object