hudson.plugins.mercurial
Class MercurialSCM

java.lang.Object
  hudson.scm.SCM
      hudson.plugins.mercurial.MercurialSCM

All Implemented Interfaces:

ExtensionPoint, Describable<SCM>, java.io.Serializable

public class MercurialSCM
extends SCM
implements java.io.Serializable

Mercurial SCM.

See Also:

Serialized Form

Nested Class Summary

static class

MercurialSCM.DescriptorImpl

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

private java.util.Set<java.lang.String>	_modules Prefixes of files within the repository which we're dependent on.
private java.lang.String	branch In-repository branch to follow.
private HgBrowser	browser
(package private) static boolean	CACHE_LOCAL_REPOS
private boolean	clean
private static java.util.regex.Pattern	FILES_LINE
private static java.lang.String	FILES_STYLE
private boolean	forest
private java.lang.String	installation Name of selected installation, if any.
private static java.util.logging.Logger	LOGGER
private java.lang.String	modules
private static long	serialVersionUID
private java.lang.String	source Source repository URL from which we pull.
private java.lang.String	subdir Slash-separated subdirectory of the workspace in which the repository will be kept; null for top level.

Fields inherited from class hudson.scm.SCM

PERMISSIONS, TAG

Constructor Summary

MercurialSCM(java.lang.String installation, java.lang.String source, java.lang.String branch, java.lang.String modules, java.lang.String subdir, HgBrowser browser, boolean clean, boolean forest)

Method Summary

void	buildEnvVars(AbstractBuild<?,?> build, java.util.Map<java.lang.String,java.lang.String> env)
private java.lang.String	cachedSource(Node node, Launcher launcher, TaskListener listener, boolean fromPolling)
SCMRevisionState	calcRevisionsFromBuild(AbstractBuild<?,?> build, Launcher launcher, TaskListener listener)
boolean	checkout(AbstractBuild<?,?> build, Launcher launcher, FilePath workspace, BuildListener listener, java.io.File changelogFile)
private boolean	clone(AbstractBuild<?,?> build, Launcher launcher, FilePath repository, BuildListener listener, java.io.File changelogFile) Start from scratch and clone the whole repository.
protected PollingResult	compareRemoteRevisionWith(AbstractProject<?,?> project, Launcher launcher, FilePath workspace, TaskListener listener, SCMRevisionState _baseline)
private PollingResult.Change	computeDegreeOfChanges(java.util.Set<java.lang.String> changedFileNames, java.io.PrintStream output)
ChangeLogParser	createChangeLogParser()
private java.util.Set<java.lang.String>	dependentChanges(java.util.Set<java.lang.String> changedFileNames) Filter out the given file name list by picking up changes that are in the modules we care about.
private ArgumentListBuilder	findHgExe(AbstractBuild<?,?> build, TaskListener listener, boolean allowDebug)
(package private) ArgumentListBuilder	findHgExe(Node node, TaskListener listener, boolean allowDebug)
java.lang.String	getBranch() In-repository branch to follow.
private java.lang.String	getBranch(EnvVars env)
HgBrowser	getBrowser()
MercurialSCM.DescriptorImpl	getDescriptor()
java.lang.String	getInstallation()
java.lang.String	getModules()
java.lang.String	getSource() Gets the source repository path.
java.lang.String	getSubdir()
boolean	isClean() True if we want clean check out each time.
boolean	isForest() True if we want consider repository a forest
(package private) static int	joinWithPossibleTimeout(Launcher.ProcStarter proc, boolean useTimeout, TaskListener listener)
(package private) static Launcher.ProcStarter	launch(Launcher launcher)
private MercurialTagAction	parseIncomingOutput(java.io.ByteArrayOutputStream output, MercurialTagAction baseline, java.util.Set<java.lang.String> result)
private void	parseModules()
private java.lang.Object	readResolve()
private boolean	update(AbstractBuild<?,?> build, Launcher launcher, FilePath repository, BuildListener listener, java.io.File changelogFile) Updates the current repository.
private FilePath	workspace2Repo(FilePath workspace)

Methods inherited from class hudson.scm.SCM

_calcRevisionsFromBuild, _for, all, createEmptyChangeLog, getApi, getEffectiveBrowser, getModuleRoot, getModuleRoots, getType, nullify, poll, pollChanges, processWorkspaceBeforeDeletion, requiresWorkspaceForPolling, supportsPolling

Methods inherited from class java.lang.Object

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

Field Detail

installation

private final java.lang.String installation

Name of selected installation, if any.

source

private final java.lang.String source

Source repository URL from which we pull.

_modules

private transient java.util.Set<java.lang.String> _modules

Prefixes of files within the repository which we're dependent on. Storing as member variable so as to only parse the dependencies string once. Will be either null (use whole repo), or nonempty list of subdir names.

modules

private final java.lang.String modules

branch

private final java.lang.String branch

In-repository branch to follow. Null indicates "default".

subdir

private final java.lang.String subdir

Slash-separated subdirectory of the workspace in which the repository will be kept; null for top level.

clean

private final boolean clean

forest

private final boolean forest

browser

private HgBrowser browser

FILES_STYLE

private static final java.lang.String FILES_STYLE

See Also:

Constant Field Values

FILES_LINE

private static java.util.regex.Pattern FILES_LINE

CACHE_LOCAL_REPOS

static boolean CACHE_LOCAL_REPOS

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

LOGGER

private static final java.util.logging.Logger LOGGER

Constructor Detail

MercurialSCM

@DataBoundConstructor
public MercurialSCM(java.lang.String installation,
                                         java.lang.String source,
                                         java.lang.String branch,
                                         java.lang.String modules,
                                         java.lang.String subdir,
                                         HgBrowser browser,
                                         boolean clean,
                                         boolean forest)

Method Detail

parseModules

private void parseModules()

readResolve

private java.lang.Object readResolve()

getInstallation

public java.lang.String getInstallation()

getSource

public java.lang.String getSource()

Gets the source repository path. Either URL or local file path.

getBranch

public java.lang.String getBranch()

In-repository branch to follow. Never null.

getBranch

private java.lang.String getBranch(EnvVars env)

getSubdir

public java.lang.String getSubdir()

workspace2Repo

private FilePath workspace2Repo(FilePath workspace)

getBrowser

public HgBrowser getBrowser()

Overrides:

getBrowser in class SCM

isClean

public boolean isClean()

True if we want clean check out each time. This means deleting everything in the repository checkout (except .hg)

isForest

public boolean isForest()

True if we want consider repository a forest

findHgExe

private ArgumentListBuilder findHgExe(AbstractBuild<?,?> build,
                                      TaskListener listener,
                                      boolean allowDebug)
                               throws java.io.IOException,
                                      java.lang.InterruptedException

Throws:

java.io.IOException

java.lang.InterruptedException

findHgExe

ArgumentListBuilder findHgExe(Node node,
                              TaskListener listener,
                              boolean allowDebug)
                        throws java.io.IOException,
                               java.lang.InterruptedException

Parameters:

allowDebug - If the caller intends to parse the stdout from Mercurial, pass in false to indicate that the optional --debug option shall never be activated.

Throws:

java.io.IOException

java.lang.InterruptedException

launch

static Launcher.ProcStarter launch(Launcher launcher)

calcRevisionsFromBuild

public SCMRevisionState calcRevisionsFromBuild(AbstractBuild<?,?> build,
                                               Launcher launcher,
                                               TaskListener listener)
                                        throws java.io.IOException,
                                               java.lang.InterruptedException

Specified by:

calcRevisionsFromBuild in class SCM

Throws:

java.io.IOException

java.lang.InterruptedException

compareRemoteRevisionWith

protected PollingResult compareRemoteRevisionWith(AbstractProject<?,?> project,
                                                  Launcher launcher,
                                                  FilePath workspace,
                                                  TaskListener listener,
                                                  SCMRevisionState _baseline)
                                           throws java.io.IOException,
                                                  java.lang.InterruptedException

Specified by:

compareRemoteRevisionWith in class SCM

Throws:

java.io.IOException

java.lang.InterruptedException

joinWithPossibleTimeout

static int joinWithPossibleTimeout(Launcher.ProcStarter proc,
                                   boolean useTimeout,
                                   TaskListener listener)
                            throws java.io.IOException,
                                   java.lang.InterruptedException

Throws:

java.io.IOException

java.lang.InterruptedException

computeDegreeOfChanges

private PollingResult.Change computeDegreeOfChanges(java.util.Set<java.lang.String> changedFileNames,
                                                    java.io.PrintStream output)

dependentChanges

private java.util.Set<java.lang.String> dependentChanges(java.util.Set<java.lang.String> changedFileNames)

Filter out the given file name list by picking up changes that are in the modules we care about.

parseIncomingOutput

private MercurialTagAction parseIncomingOutput(java.io.ByteArrayOutputStream output,
                                               MercurialTagAction baseline,
                                               java.util.Set<java.lang.String> result)
                                        throws java.io.IOException

Throws:

java.io.IOException

checkout

public boolean checkout(AbstractBuild<?,?> build,
                        Launcher launcher,
                        FilePath workspace,
                        BuildListener listener,
                        java.io.File changelogFile)
                 throws java.io.IOException,
                        java.lang.InterruptedException

Specified by:

checkout in class SCM

Throws:

java.io.IOException

java.lang.InterruptedException

update

private boolean update(AbstractBuild<?,?> build,
                       Launcher launcher,
                       FilePath repository,
                       BuildListener listener,
                       java.io.File changelogFile)
                throws java.lang.InterruptedException,
                       java.io.IOException

Updates the current repository.

Throws:

java.lang.InterruptedException

java.io.IOException

clone

private boolean clone(AbstractBuild<?,?> build,
                      Launcher launcher,
                      FilePath repository,
                      BuildListener listener,
                      java.io.File changelogFile)
               throws java.lang.InterruptedException,
                      java.io.IOException

Start from scratch and clone the whole repository.

Throws:

java.lang.InterruptedException

java.io.IOException

buildEnvVars

public void buildEnvVars(AbstractBuild<?,?> build,
                         java.util.Map<java.lang.String,java.lang.String> env)

Overrides:

buildEnvVars in class SCM

createChangeLogParser

public ChangeLogParser createChangeLogParser()

Specified by:

createChangeLogParser in class SCM

getDescriptor

public MercurialSCM.DescriptorImpl getDescriptor()

Specified by:

getDescriptor in interface Describable<SCM>

Overrides:

getDescriptor in class SCM

getModules

public java.lang.String getModules()

cachedSource

@CheckForNull
private java.lang.String cachedSource(Node node,
                                                   Launcher launcher,
                                                   TaskListener listener,
                                                   boolean fromPolling)