Package buildslave :: Package commands :: Module repo :: Class Repo

Class Repo

      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.
['jobs'] (optional):            number of connections to run in parallel
                                repo tool will use while syncing

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)