Package buildbot :: Package steps :: Package source :: Module svn :: Class SVN
[frames] | no frames]

Class SVN

source code --+            
           process.buildstep.BuildStep --+        
        process.buildstep.LoggingBuildStep --+    
                              oldsource.Source --+

I perform Subversion checkout/update operations.

Instance Methods
__init__(self, repourl=None, baseURL=None, mode='incremental', method=None, defaultBranch=None, username=None, password=None, extra_args=None, keep_on_purge=None, depth=None, **kwargs) source code
startVC(self, branch, revision, patch) source code
full(*args, **kwargs) source code
incremental(*args, **kwargs) source code
clobber(*args, **kwargs) source code
fresh(self) source code
clean(self) source code
copy(*args, **kwargs) source code
finish(self, res) source code
getRepoUrl(self, branch)
Compute the svn url that will be passed to the svn remote command
source code
parseGotRevision(self, _) source code
purge(self, ignore_ignores)
Delete everything that shown up on status.
source code
removeFiles(*args, **kwargs) source code
checkSvn(self) source code
computeSourceRevision(self, changes)
Each subclass must implement this method to do something more precise than -rHEAD every time.
source code

Inherited from oldsource.Source: commandComplete, describe, getRepository, setDefaultWorkdir, setStepStatus, start

Inherited from process.buildstep.LoggingBuildStep: addLogFile, buildCommandKwargs, checkDisconnect, createSummary, evaluateCommand, getText, getText2, interrupt, maybeGetText2, setStatus, setupLogfiles, startCommand

Inherited from process.buildstep.BuildStep: __provides__, acquireLocks, addCompleteLog, addFactoryArguments, addHTMLLog, addLog, addLogObserver, addURL, failed, finished, getLog, getSlaveName, getStepFactory, releaseLocks, runCommand, setBuild, setBuildSlave, setProgress, setupProgress, slaveVersion, slaveVersionIsOlderThan, startStep

Inherited from __providedBy__, getProperties, getProperty, hasProperty, has_key, render, setProperty

Static Methods
getUnversionedFiles(xmlStr, keep_on_purge) source code
Class Variables
  name = 'svn'
  branch_placeholder = '%%BRANCH%%'
  renderables = ['repourl', 'baseURL']
  possible_modes = ('incremental', 'full')
  possible_methods = ('clean', 'fresh', 'clobber', 'copy', 'expo...

Inherited from oldsource.Source: branch, description, descriptionDone, flunkOnFailure, haltOnFailure, notReally

Inherited from process.buildstep.LoggingBuildStep: cmd, logfiles, parms, progressMetrics

Inherited from process.buildstep.BuildStep: __implemented__, alwaysRun, build, doStepIf, flunkOnWarnings, hideStepIf, locks, progress, set_runtime_properties, step_status, useProgress, warnOnFailure, warnOnWarnings

Method Details

__init__(self, repourl=None, baseURL=None, mode='incremental', method=None, defaultBranch=None, username=None, password=None, extra_args=None, keep_on_purge=None, depth=None, **kwargs)

source code 
  • workdir - local directory (relative to the Builder's root) where the tree should be placed
  • mode - the kind of VC operation that is desired:
    • 'update': specifies that the checkout/update should be performed directly into the workdir. Each build is performed in the same directory, allowing for incremental builds. This minimizes disk space, bandwidth, and CPU time. However, it may encounter problems if the build process does not handle dependencies properly (if you must sometimes do a 'clean build' to make sure everything gets compiled), or if source files are deleted but generated files can influence test behavior (e.g. python's .pyc files), or when source directories are deleted but generated files prevent CVS from removing them. When used with a patched checkout, from a previous buildbot try for instance, it will try to "revert" the changes first and will do a clobber if it is unable to get a clean checkout. The behavior is SCM-dependent.
    • 'copy': specifies that the source-controlled workspace should be maintained in a separate directory (called the 'copydir'), using checkout or update as necessary. For each build, a new workdir is created with a copy of the source tree (rm -rf workdir; cp -R -P -p copydir workdir). This doubles the disk space required, but keeps the bandwidth low (update instead of a full checkout). A full 'clean' build is performed each time. This avoids any generated-file build problems, but is still occasionally vulnerable to problems such as a CVS repository being manually rearranged (causing CVS errors on update) which are not an issue with a full checkout.
    • 'clobber': specifies that the working directory should be deleted each time, necessitating a full checkout for each build. This insures a clean build off a complete checkout, avoiding any of the problems described above, but is bandwidth intensive, as the whole source tree must be pulled down for each build.
    • 'export': is like 'clobber', except that e.g. the 'cvs export' command is used to create the working directory. This command removes all VC metadata files (the CVS/.svn/{arch} directories) from the tree, which is sometimes useful for creating source tarballs (to avoid including the metadata in the tar file). Not all VC systems support export.
  • alwaysUseLatest - whether to always update to the most recent available sources for this build.

    Normally the Source step asks its Build for a list of all Changes that are supposed to go into the build, then computes a 'source stamp' (revision number or timestamp) that will cause exactly that set of changes to be present in the checked out tree. This is turned into, e.g., 'cvs update -D timestamp', or 'svn update -r revnum'. If alwaysUseLatest=True, bypass this computation and always update to the latest available sources for each build.

    The source stamp helps avoid a race condition in which someone commits a change after the master has decided to start a build but before the slave finishes checking out the sources. At best this results in a build which contains more changes than the buildmaster thinks it has (possibly resulting in the wrong person taking the blame for any problems that result), at worst is can result in an incoherent set of sources (splitting a non-atomic commit) which may not build at all.

  • retry - if provided, VC update failures are re-attempted up to REPEATS times, with DELAY seconds between each attempt. Some users have slaves with poor connectivity to their VC repository, and they say that up to 80% of their build failures are due to transient network failures that could be handled by simply retrying a couple times.
  • logEnviron - If this option is true (the default), then the step's logfile will describe the environment variables on the slave. In situations where the environment is not relevant and is long, it may be easier to set logEnviron=False.
Overrides: process.buildstep.BuildStep.__init__

full(*args, **kwargs)

source code 
  • @defer.deferredGenerator

incremental(*args, **kwargs)

source code 
  • @defer.deferredGenerator

clobber(*args, **kwargs)

source code 
  • @defer.deferredGenerator

copy(*args, **kwargs)

source code 
  • @defer.deferredGenerator

removeFiles(*args, **kwargs)

source code 
  • @defer.deferredGenerator

computeSourceRevision(self, changes)

source code 

Each subclass must implement this method to do something more precise than -rHEAD every time. For version control systems that use repository-wide change numbers (SVN, P4), this can simply take the maximum such number from all the changes involved in this build. For systems that do not (CVS), it needs to create a timestamp based upon the latest Change, the Build's treeStableTimer, and an optional self.checkoutDelay value.

Overrides: oldsource.Source.computeSourceRevision
(inherited documentation)

Class Variable Details


('clean', 'fresh', 'clobber', 'copy', 'export', None)