Home       Trees       Index       Help   

BuildBot 0.7.5

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

Class CVS

   BuildStep --+        
               |        
LoggingBuildStep --+    
                   |    
              Source --+
                       |
                      CVS

I do CVS checkout/update operations.

Note: if you are doing anonymous/pserver CVS operations, you will need to manually do a 'cvs login' on each buildslave before the slave has any hope of success. XXX: fix then, take a cvs password as an argument and figure out how to do a 'cvs login' on each build
Method Summary
  __init__(self, cvsroot, cvsmodule, global_options, branch, checkoutDelay, login, clobber, export, copydir, **kwargs)
  computeSourceRevision(self, changes)
Each subclass must implement this method to do something more precise than -rHEAD every time.
  startVC(self, branch, revision, patch)
    Inherited from Source
  commandComplete(self, cmd)
This is a general-purpose hook method for subclasses.
  describe(self, done)
  start(self)
Begin the step.
    Inherited from LoggingBuildStep
  checkDisconnect(self, f)
  createSummary(self, log)
To create summary logs, do something like this: warnings = grep('^Warning:', log.getText()) self.addCompleteLog('warnings', warnings)
  evaluateCommand(self, cmd)
Decide whether the command was SUCCESS, WARNINGS, or FAILURE.
  getColor(self, cmd, results)
  getText(self, cmd, results)
  getText2(self, cmd, results)
We have decided to add a short note about ourselves to the overall build description, probably because something went wrong.
  interrupt(self, reason)
Halt the command, either because the user has decided to cancel the build ('reason' is a string), or because the slave has disconnected ('reason' is a ConnectionLost Failure).
  maybeGetText2(self, cmd, results)
  setStatus(self, cmd, results)
  setupLogfiles(self, cmd, logfiles)
Set up any additional logfiles= logs.
  startCommand(self, cmd, errorMessages)
    Inherited from BuildStep
  acquireLocks(self, res)
  addCompleteLog(self, name, text)
  addHTMLLog(self, name, html)
  addLog(self, name)
  addLogObserver(self, logname, observer)
  addURL(self, name, url)
Add a BuildStep URL to this step.
  failed(self, why)
  finished(self, results)
  getProperty(self, propname)
  getSlaveName(self)
  releaseLocks(self)
  runCommand(self, c)
  setProgress(self, metric, value)
BuildSteps can call self.setProgress() to announce progress along some metric.
  setProperty(self, propname, value)
  setStepStatus(self, step_status)
  setupProgress(self)
  slaveVersion(self, command, oldversion)
Return the version number of the given slave command.
  slaveVersionIsOlderThan(self, command, minversion)
  startStep(self, remote)
Begin the step.

Instance Variable Summary
    Inherited from BuildStep
buildbot.process.base.Build build: the parent Build which is executing this step
buildbot.status.progress.StepProgress progress: tracks ETA for the step
buildbot.status.builder.BuildStepStatus step_status: collects output status

Class Variable Summary
str name = 'cvs'
    Inherited from Source
NoneType branch = None                                                                  
bool haltOnFailure = True
bool notReally = False
    Inherited from LoggingBuildStep
dict logfiles = {}
list parms = ['build', 'name', 'locks', 'haltOnFailure', 'flu...
tuple progressMetrics = ('output',)
    Inherited from BuildStep
bool flunkOnFailure = False
bool flunkOnWarnings = False
list locks = []
bool useProgress = True
bool warnOnFailure = False
bool warnOnWarnings = False

Method Details

__init__(self, cvsroot, cvsmodule, global_options=[], branch=None, checkoutDelay=None, login=None, clobber=0, export=0, copydir=None, **kwargs)
(Constructor)

Parameters:
cvsroot - CVS Repository from which the source tree should be obtained. '/home/warner/Repository' for local or NFS-reachable repositories, ':pserver:anon@foo.com:/cvs' for anonymous CVS, 'user@host.com:/cvs' for non-anonymous CVS or CVS over ssh. Lots of possibilities, check the CVS documentation for more.
           (type=string)
cvsmodule - subdirectory of CVS repository that should be retrieved
           (type=string)
global_options - these arguments are inserted in the cvs command line, before the 'checkout'/'update' command word. See 'cvs --help-options' for a list of what may be accepted here. ['-r'] will make the checked out files read only. ['-r', '-R'] will also assume the repository is read-only (I assume this means it won't use locks to insure atomic access to the ,v files).
           (type=list of strings)
branch - the default branch name, will be used in a '-r' argument to specify which branch of the source tree should be used for this checkout. Defaults to None, which means to use 'HEAD'.
           (type=string)
checkoutDelay - if not None, the number of seconds to put between the last known Change and the timestamp given to the -D argument. This defaults to exactly half of the parent Build's .treeStableTimer, but it could be set to something else if your CVS change notification has particularly weird latency characteristics.
           (type=int or None)
login - if not None, a string which will be provided as a password to the 'cvs login' command, used when a :pserver: method is used to access the repository. This login is only needed once, but must be run each time (just before the CVS operation) because there is no way for the buildslave to tell whether it was previously performed or not.
           (type=string or None)
Overrides:
buildbot.steps.source.Source.__init__

computeSourceRevision(self, changes)

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:
buildbot.steps.source.Source.computeSourceRevision (inherited documentation)

Class Variable Details

name

Type:
str
Value:
'cvs'

   Home       Trees       Index       Help   

BuildBot 0.7.5

Generated by Epydoc 2.1 on Sun Dec 10 22:04:44 2006 http://epydoc.sf.net