hudson.plugins.git.util

Class GitUtils

java.lang.Object

hudson.plugins.git.util.GitUtils

All Implemented Interfaces:

Serializable

public class GitUtils
extends Object
implements Serializable

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GitUtils(hudson.model.TaskListener listener, org.jenkinsci.plugins.gitclient.GitClient git)

Method Summary

Modifier and Type	Method and Description
List<hudson.plugins.git.Revision>	filterTipBranches(Collection<hudson.plugins.git.Revision> revisions) Return a list of 'tip' branches (I.E.
static String[]	fixupNames(String[] names, String[] urls)
Collection<hudson.plugins.git.Revision>	getAllBranchRevisions() Return a list of "Revisions" - where a revision knows about all the branch names that refer to a SHA1.
static hudson.EnvVars	getPollEnvironment(hudson.model.AbstractProject p, hudson.FilePath ws, hudson.Launcher launcher, hudson.model.TaskListener listener)
static hudson.EnvVars	getPollEnvironment(hudson.model.AbstractProject p, hudson.FilePath ws, hudson.Launcher launcher, hudson.model.TaskListener listener, boolean reuseLastBuildEnv) An attempt to generate at least semi-useful EnvVars for polling calls, based on previous build.
hudson.plugins.git.Revision	getRevisionContainingBranch(String branchName) Return the revision containing the branch name.
hudson.plugins.git.Revision	getRevisionForSHA1(org.eclipse.jgit.lib.ObjectId sha1)
hudson.plugins.git.Revision	sortBranchesForRevision(hudson.plugins.git.Revision revision, List<BranchSpec> branchOrder)
hudson.plugins.git.Revision	sortBranchesForRevision(hudson.plugins.git.Revision revision, List<BranchSpec> branchOrder, hudson.EnvVars env)
static hudson.model.Node	workspaceToNode(hudson.FilePath workspace)

Methods inherited from class java.lang.Object

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

Constructor Detail

GitUtils

public GitUtils(@Nonnull
                hudson.model.TaskListener listener,
                @Nonnull
                org.jenkinsci.plugins.gitclient.GitClient git)

Method Detail

workspaceToNode

public static hudson.model.Node workspaceToNode(hudson.FilePath workspace)

getAllBranchRevisions

public Collection<hudson.plugins.git.Revision> getAllBranchRevisions()
                                                              throws hudson.plugins.git.GitException,
                                                                     IOException,
                                                                     InterruptedException

Return a list of "Revisions" - where a revision knows about all the branch names that refer to a SHA1.

Returns:

list of revisions

Throws:

IOException - on input or output error

hudson.plugins.git.GitException - on git error

InterruptedException - when interrupted

getRevisionContainingBranch

public hudson.plugins.git.Revision getRevisionContainingBranch(String branchName)
                                                        throws hudson.plugins.git.GitException,
                                                               IOException,
                                                               InterruptedException

Return the revision containing the branch name.

Parameters:

branchName - name of branch to be searched

Returns:

revision containing branchName

Throws:

IOException - on input or output error

hudson.plugins.git.GitException - on git error

InterruptedException - when interrupted

getRevisionForSHA1

public hudson.plugins.git.Revision getRevisionForSHA1(org.eclipse.jgit.lib.ObjectId sha1)
                                               throws hudson.plugins.git.GitException,
                                                      IOException,
                                                      InterruptedException

Throws:

hudson.plugins.git.GitException

IOException

InterruptedException

sortBranchesForRevision

public hudson.plugins.git.Revision sortBranchesForRevision(hudson.plugins.git.Revision revision,
                                                           List<BranchSpec> branchOrder)

sortBranchesForRevision

public hudson.plugins.git.Revision sortBranchesForRevision(hudson.plugins.git.Revision revision,
                                                           List<BranchSpec> branchOrder,
                                                           hudson.EnvVars env)

filterTipBranches

@WithBridgeMethods(value=java.util.Collection.class)
public List<hudson.plugins.git.Revision> filterTipBranches(Collection<hudson.plugins.git.Revision> revisions)
                                                                                                         throws InterruptedException

Return a list of 'tip' branches (I.E. branches that aren't included entirely within another branch).

Parameters:

revisions - branches to be included in the search for tip branches

Returns:

filtered tip branches

Throws:

InterruptedException - when interrupted

getPollEnvironment

public static hudson.EnvVars getPollEnvironment(hudson.model.AbstractProject p,
                                                hudson.FilePath ws,
                                                hudson.Launcher launcher,
                                                hudson.model.TaskListener listener)
                                         throws IOException,
                                                InterruptedException

Throws:

IOException

InterruptedException

getPollEnvironment

public static hudson.EnvVars getPollEnvironment(hudson.model.AbstractProject p,
                                                hudson.FilePath ws,
                                                hudson.Launcher launcher,
                                                hudson.model.TaskListener listener,
                                                boolean reuseLastBuildEnv)
                                         throws IOException,
                                                InterruptedException

An attempt to generate at least semi-useful EnvVars for polling calls, based on previous build. Cribbed from various places.

Parameters:

p - abstract project to be considered

ws - workspace to be considered

launcher - launcher to use for calls to nodes

listener - build log

reuseLastBuildEnv - true if last build environment should be considered

Returns:

environment variables from previous build to be used for polling

Throws:

IOException - on input or output error

InterruptedException - when interrupted

fixupNames

public static String[] fixupNames(String[] names,
                                  String[] urls)