hudson.plugins.git.util

Class GitUtils

java.lang.Object

hudson.plugins.git.util.GitUtils

public class GitUtils
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULD_REPO_NAME

Constructor Summary

Constructors

Constructor and Description
GitUtils(hudson.model.TaskListener listener, IGitAPI git)

Method Summary

Methods

Modifier and Type	Method and Description
static String	buildBranch(hudson.model.AbstractBuild<?,?> build, String repository, String branchName) Builds branch based on params.Applied build params if any.
static void	buildBranchEnvVar(hudson.model.AbstractBuild<?,?> build, Map<String,String> env, List<org.eclipse.jgit.transport.RemoteConfig> repositories, List<BranchSpec> branches) Builds branch envvars.
Collection<Revision>	filterTipBranches(Collection<Revision> revisions) Return a list of 'tip' branches (I.E.
static String[]	fixupNames(String[] names, String[] urls)
Collection<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, boolean pollSlaves) An attempt to generate at least semi-useful EnvVars for polling calls, based on previous build.
Revision	getRevisionContainingBranch(String branchName) Return the revision containing the branch name.
Revision	getRevisionForSHA1(org.eclipse.jgit.lib.ObjectId sha1)
static String	getSingleBranch(hudson.model.AbstractBuild<?,?> build, List<org.eclipse.jgit.transport.RemoteConfig> repositories, List<BranchSpec> branches) If the configuration is such that we are tracking just one branch of one repository return that branch specifier (in the form of something like "origin/master" Otherwise return null.
static boolean	isEmpty(String[] urls) Verifies whether array of the repository Urls is empty.
static boolean	isEqualArray(Object[] o1, Object[] o2) Verifies if first array equals second without ordering.
static boolean	isEqualCollection(Collection c1, Collection c2) Verifies if first collection equals second without ordering.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULD_REPO_NAME

public static final String DEFAULD_REPO_NAME

See Also:

Constant Field Values

Constructor Detail

GitUtils

public GitUtils(hudson.model.TaskListener listener,
        IGitAPI git)

Method Detail

getAllBranchRevisions

public Collection<Revision> getAllBranchRevisions()
                                           throws GitException,
                                                  IOException

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

Returns:

Throws:

IOException

GitException

getRevisionContainingBranch

public Revision getRevisionContainingBranch(String branchName)
                                     throws GitException,
                                            IOException

Return the revision containing the branch name.

Parameters:

branchName -

Returns:

Throws:

IOException

GitException

getRevisionForSHA1

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

Throws:

GitException

IOException

filterTipBranches

public Collection<Revision> filterTipBranches(Collection<Revision> revisions)

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

Parameters:

git -

Returns:

getPollEnvironment

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

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

Throws:

IOException

InterruptedException

buildBranchEnvVar

public static void buildBranchEnvVar(hudson.model.AbstractBuild<?,?> build,
                     Map<String,String> env,
                     List<org.eclipse.jgit.transport.RemoteConfig> repositories,
                     List<BranchSpec> branches)

Builds branch envvars. If several branches or repos are present, env key will be generated based on pattern: GIT_BRANCH_$repoIdx_$branchIdx. If there is only one branch and repo - GitSCM.GIT_BRANCH will be used.

Parameters:

build - AbstractBuild

env - environment variables.

repositories - list of repos.

branches - list of BranchSpec

getSingleBranch

public static String getSingleBranch(hudson.model.AbstractBuild<?,?> build,
                     List<org.eclipse.jgit.transport.RemoteConfig> repositories,
                     List<BranchSpec> branches)

If the configuration is such that we are tracking just one branch of one repository return that branch specifier (in the form of something like "origin/master"

Otherwise return null.

buildBranch

public static String buildBranch(hudson.model.AbstractBuild<?,?> build,
                 String repository,
                 String branchName)

Builds branch based on params.Applied build params if any. Returns null if branch contains *,

Parameters:

build - AbstractBuild

repository - repo name

branchName - branch name

Returns:

branch name

fixupNames

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

isEmpty

public static boolean isEmpty(String[] urls)

Verifies whether array of the repository Urls is empty.

Parameters:

urls - repository Urls.

Returns:

true if array is empty.

isEqualCollection

public static boolean isEqualCollection(Collection c1,
                        Collection c2)

Verifies if first collection equals second without ordering.

Parameters:

c1 - collection

c2 - collection

Returns:

true if collections equal.

isEqualArray

public static boolean isEqualArray(Object[] o1,
                   Object[] o2)

Verifies if first array equals second without ordering.

Parameters:

o1 - array

o2 - array

Returns:

true if arrays equal.