org.jenkinsci.plugins.pretestedintegration.scm.git

Class PretestedIntegrationGitUtils

java.lang.Object

org.jenkinsci.plugins.pretestedintegration.scm.git.PretestedIntegrationGitUtils

public class PretestedIntegrationGitUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
PretestedIntegrationGitUtils()

Method Summary

Modifier and Type	Method and Description
static int	countCommits(org.eclipse.jgit.lib.ObjectId commitId, org.jenkinsci.plugins.gitclient.GitClient client, String expandedIntegrationBranch) Counts the commits in the relevant BuildData
static hudson.plugins.git.util.BuildData	findRelevantBuildData(hudson.model.Run<?,?> build, PrintStream logger, String repoName) Retrieves the BuildData for the given build relevant to the Integration Repository.
static boolean	isRelevant(hudson.plugins.git.Branch triggeredBranch, String repoName)

Methods inherited from class java.lang.Object

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

Constructor Detail

PretestedIntegrationGitUtils

public PretestedIntegrationGitUtils()

Method Detail

countCommits

public static int countCommits(org.eclipse.jgit.lib.ObjectId commitId,
                               org.jenkinsci.plugins.gitclient.GitClient client,
                               String expandedIntegrationBranch)
                        throws IOException,
                               InterruptedException

Counts the commits in the relevant BuildData

Parameters:

commitId - The BuildData from the build

client - The GitClient

expandedIntegrationBranch - the development branch we want to count commits on

Returns:

the amount of commits

Throws:

IOException - Unforseen IO issues

InterruptedException - Unforseen other issues

findRelevantBuildData

public static hudson.plugins.git.util.BuildData findRelevantBuildData(hudson.model.Run<?,?> build,
                                                                      PrintStream logger,
                                                                      String repoName)
                                                               throws NothingToDoException,
                                                                      UnsupportedConfigurationException

Retrieves the BuildData for the given build relevant to the Integration Repository.

• Extracts only BuildData belonging to the Integration repository
• Ensures that identical BuildData are narrowed down to different sets as MultiScm and the Git plugin may sometimes contribute with several identical sets
• Ensures that only one relevant set is supplied. It throws in case om ambiguity.

For a visualized example of several BuilData: See 'docs/More_than_1_gitBuild_data.png' TODO: We don't check that the integration branch complies with the branch specifier, or that commits are heads. See JENKINS-25542, JENKINS-25512, JENKINS-24909

Parameters:

build - The Build

logger - The PrintStream logging object

repoName - The repository name

Returns:

The relevant BuildData

Throws:

NothingToDoException - If no relevant BuildData was found.

UnsupportedConfigurationException - If multiple, ambiguous BuildDatas were found.

isRelevant

public static boolean isRelevant(hudson.plugins.git.Branch triggeredBranch,
                                 String repoName)