Package buildbot :: Package slave :: Package commands :: Module vcs :: Class SourceBase
[frames] | no frames]

Class SourceBase

source code

base.Command --+
               |
              SourceBase
Known Subclasses:

Abstract base class for Version Control System operations (checkout and update). This class extracts the following arguments from the dictionary received from the master:

Instance Methods
 
setup(self, args)
Override this in a subclass to extract items from the args dict.
source code
 
start(self)
Start the command.
source code
 
maybeClobber(self, d) source code
 
interrupt(self)
Override this in a subclass to allow commands to be interrupted.
source code
 
doVC(self, res) source code
 
sourcedataMatches(self) source code
 
sourcedirIsPatched(self) source code
 
parseGotRevision(self)
Override this in a subclass.
source code
 
readSourcedata(self) source code
 
writeSourcedata(self, res) source code
 
sourcedirIsUpdateable(self)
Returns True if the tree can be updated.
source code
 
doVCUpdate(self)
Returns a deferred with the steps to update a checkout.
source code
 
doVCFull(self)
Returns a deferred with the steps to do a fresh checkout.
source code
 
maybeDoVCFallback(self, rc) source code
 
doVCFallback2(self, res) source code
 
maybeDoVCRetry(self, res)
We get here somewhere after a VC chain has finished.
source code
 
doClobber(self, dummy, dirname, chmodDone=False) source code
 
doClobberTryChmodIfFail(self, rc, dirname) source code
 
doCopy(self, res) source code
 
doPatch(self, res) source code

Inherited from base.Command: __init__, __providedBy__, commandComplete, doInterrupt, doStart, sendStatus

Class Variables
  sourcedata = ''

Inherited from base.Command: __implemented__, __provides__, debug, interrupted, running

Method Details

setup(self, args)

source code 

Override this in a subclass to extract items from the args dict.

Overrides: base.Command.setup
(inherited documentation)

start(self)

source code 

Start the command. This method should return a Deferred that will fire when the command has completed. The Deferred's argument will be ignored.

This method should be overridden by subclasses.

Overrides: base.Command.start
(inherited documentation)

interrupt(self)

source code 

Override this in a subclass to allow commands to be interrupted. May be called multiple times, test and set self.interrupted=True if this matters.

Overrides: base.Command.interrupt
(inherited documentation)

parseGotRevision(self)

source code 

Override this in a subclass. It should return a string that represents which revision was actually checked out, or a Deferred that will fire with such a string. If, in a future build, you were to pass this 'got_revision' string in as the 'revision' component of a SourceStamp, you should wind up with the same source code as this checkout just obtained.

It is probably most useful to scan self.command.stdout for a string of some sort. Be sure to set keepStdout=True on the VC command that you run, so that you'll have something available to look at.

If this information is unavailable, just return None.

maybeDoVCRetry(self, res)

source code 

We get here somewhere after a VC chain has finished. res could be:

- 0: the operation was successful
- nonzero: the operation failed. retry if possible
- AbandonChain: the operation failed, someone else noticed. retry.
- Failure: some other exception, re-raise