hudson.plugins.git.extensions.impl

Class SubmoduleOption

java.lang.Object

hudson.model.AbstractDescribableImpl<GitSCMExtension>

hudson.plugins.git.extensions.GitSCMExtension

hudson.plugins.git.extensions.impl.SubmoduleOption

All Implemented Interfaces:

hudson.model.Describable<GitSCMExtension>

public class SubmoduleOption
extends GitSCMExtension

Further tweak the behaviour of git-submodule.

Historically, the submodule support was on by default, and given the clear marker file in the source tree, I think keeping this default behaviour is sensible. So when we split out GitSCMExtensions, we decided to keep the git-submodule handling enabled by default, and this extension controls the recursiveness and the option to switch it off.

Author:

Yury V. Zaytsev, Andrew Bayer, Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SubmoduleOption.DescriptorImpl

Constructor Summary

Constructors

Constructor and Description
SubmoduleOption(boolean disableSubmodules, boolean recursiveSubmodules, boolean trackingSubmodules, Integer timeout)

Method Summary

Methods

Modifier and Type	Method and Description
Integer	getTimeout()
boolean	isDisableSubmodules()
boolean	isRecursiveSubmodules()
boolean	isTrackingSubmodules()
void	onCheckoutCompleted(GitSCM scm, hudson.model.Run<?,?> build, org.jenkinsci.plugins.gitclient.GitClient git, hudson.model.TaskListener listener) Called when the checkout was completed and the working directory is filled with files.
void	onClean(GitSCM scm, org.jenkinsci.plugins.gitclient.GitClient git) Signals when "git-clean" runs.

Methods inherited from class hudson.plugins.git.extensions.GitSCMExtension

beforeCheckout, beforeCheckout, decorate, decorateCheckoutCommand, decorateCheckoutCommand, decorateCloneCommand, decorateCloneCommand, decorateFetchCommand, decorateMergeCommand, decorateMergeCommand, decorateRevisionToBuild, decorateRevisionToBuild, getDescriptor, getRequiredClient, getWorkingDirectory, getWorkingDirectory, isRevExcluded, onCheckoutCompleted, populateEnvironmentVariables, requiresWorkspaceForPolling

Methods inherited from class java.lang.Object

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

Constructor Detail

SubmoduleOption

@DataBoundConstructor
public SubmoduleOption(boolean disableSubmodules,
                                    boolean recursiveSubmodules,
                                    boolean trackingSubmodules,
                                    Integer timeout)

Method Detail

isDisableSubmodules

public boolean isDisableSubmodules()

isRecursiveSubmodules

public boolean isRecursiveSubmodules()

isTrackingSubmodules

public boolean isTrackingSubmodules()

getTimeout

public Integer getTimeout()

onClean

public void onClean(GitSCM scm,
           org.jenkinsci.plugins.gitclient.GitClient git)
             throws IOException,
                    InterruptedException,
                    hudson.plugins.git.GitException

Description copied from class: GitSCMExtension

Signals when "git-clean" runs. Primarily for running "git submodule clean" TODO: revisit the abstraction

Overrides:

onClean in class GitSCMExtension

Throws:

IOException

InterruptedException

hudson.plugins.git.GitException

onCheckoutCompleted

public void onCheckoutCompleted(GitSCM scm,
                       hudson.model.Run<?,?> build,
                       org.jenkinsci.plugins.gitclient.GitClient git,
                       hudson.model.TaskListener listener)
                         throws IOException,
                                InterruptedException,
                                hudson.plugins.git.GitException

Description copied from class: GitSCMExtension

Called when the checkout was completed and the working directory is filled with files. See SCM.checkout(Run, Launcher, FilePath, TaskListener, File, SCMRevisionState) for the available parameters, except workingDirectory Do not move the HEAD to another commit, as by this point the commit to be built is already determined and recorded (such as changelog.)

Overrides:

onCheckoutCompleted in class GitSCMExtension

Throws:

IOException

InterruptedException

hudson.plugins.git.GitException