Package buildslave :: Package commands :: Module repo :: Class Repo
[frames] | no frames]

Class Repo

source code

      base.Command --+    
                     |    
base.SourceBaseCommand --+
                         |
                        Repo

Repo specific VC operation. In addition to the arguments
handled by SourceBaseCommand, this command reads the following keys:

['manifest_url'] (required):    The manifests repo repository.
['manifest_branch'] (optional): Which manifest repo version (i.e. branch or tag)
                                to retrieve. Default: "master".
['manifest_file'] (optional):   Which manifest file to use. Default: "default.xml".
['manifest_override_url'] (optional):   Which manifest file to use as an overide. Default: None.
                                This is usually set by forced build to build over a known working base
['tarball'] (optional):         The tarball base to accelerate the fetch.
['repo_downloads'] (optional):  Repo downloads to do. Computer from GerritChangeSource
                                and forced build properties.

Instance Methods
 
setup(self, args)
Override this in a subclass to extract items from the args dict.
source code
 
sourcedirIsUpdateable(self)
Returns True if the tree can be updated.
source code
 
sourcedataMatches(self) source code
 
doVCFull(self)
Returns a deferred with the steps to do a fresh checkout.
source code
 
doVCUpdate(self)
Returns a deferred with the steps to update a checkout.
source code
 
maybeNotDoVCFallback(self, res)
Override this in a subclass if you want to detect unrecoverable checkout errors where clobbering the repo wouldn't help, and stop the current VC chain before it clobbers the repo for future builds.
source code

Inherited from base.SourceBaseCommand: doClobber, doClobberTryChmodIfFail, doCopy, doPatch, doVC, doVCFallback2, getCommand, interrupt, maybeClobber, maybeDoVCFallback, maybeDoVCRetry, parseGotRevision, readSourcedata, setFileContents, sourcedirIsPatched, start, writeSourcedata

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

Class Variables
  header = 'repo operation'

Inherited from base.SourceBaseCommand: sourcedata

Inherited from base.Command: __implemented__, 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)

sourcedirIsUpdateable(self)

source code 

Returns True if the tree can be updated.

Overrides: base.SourceBaseCommand.sourcedirIsUpdateable
(inherited documentation)

sourcedataMatches(self)

source code 
Overrides: base.SourceBaseCommand.sourcedataMatches

doVCFull(self)

source code 

Returns a deferred with the steps to do a fresh checkout.

Overrides: base.SourceBaseCommand.doVCFull
(inherited documentation)

doVCUpdate(self)

source code 

Returns a deferred with the steps to update a checkout.

Overrides: base.SourceBaseCommand.doVCUpdate
(inherited documentation)

maybeNotDoVCFallback(self, res)

source code 

Override this in a subclass if you want to detect unrecoverable checkout errors where clobbering the repo wouldn't help, and stop the current VC chain before it clobbers the repo for future builds.

Use 'raise AbandonChain' to pass up a halt if you do detect such.

Overrides: base.SourceBaseCommand.maybeNotDoVCFallback
(inherited documentation)