Package buildbot :: Module interfaces :: Class IBuilderControl
[frames] | no frames]

Class IBuilderControl

source code

zope.interface.Interface --+
                           |
                          IBuilderControl

Instance Methods
 
submitBuildRequest(ss, reason, props=None, now=False)
Create a BuildRequest, which will eventually cause a build of the given SourceStamp to be run on this builder.
source code
 
resubmitBuild(buildStatus, reason="<rebuild, no reason given>")
Rebuild something we've already built before.
source code
 
getPendingBuilds()
Return a list of IBuildRequestControl objects for this Builder.
source code
 
getBuild(number)
Attempt to return an IBuildControl object for the given build.
source code
 
ping()
Attempt to contact the slave and see if it is still alive.
source code
Class Variables
  __bases__ = (<InterfaceClass zope.interface.Interface>)
  __identifier__ = 'buildbot.interfaces.IBuilderControl'
  __iro__ = (<InterfaceClass buildbot.interfaces.IBuilderControl...
  __name__ = 'IBuilderControl'
  __sro__ = (<InterfaceClass buildbot.interfaces.IBuilderControl...
  dependents = <WeakKeyDictionary at 13049584>
Method Details

submitBuildRequest(ss, reason, props=None, now=False)

source code 

Create a BuildRequest, which will eventually cause a build of the given SourceStamp to be run on this builder. This returns a BuildRequestStatus object, which can be used to keep track of the builds that are performed.

If now=True, and I have no slave attached, NoSlaveError will be raised instead of queueing the request for later action.

resubmitBuild(buildStatus, reason="<rebuild, no reason given>")

source code 

Rebuild something we've already built before. This submits a BuildRequest to our Builder using the same SourceStamp as the earlier build. This has no effect (but may eventually raise an exception) if this Build has not yet finished.

getPendingBuilds()

source code 

Return a list of IBuildRequestControl objects for this Builder. Each one corresponds to a pending build that has not yet started (due to a scarcity of build slaves). These upcoming builds can be canceled through the control object.

getBuild(number)

source code 

Attempt to return an IBuildControl object for the given build. Returns None if no such object is available. This will only work for the build that is currently in progress: once the build finishes, there is nothing to control anymore.

ping()

source code 

Attempt to contact the slave and see if it is still alive. This returns a Deferred which fires with either True (the slave is still alive) or False (the slave did not respond). As a side effect, adds an event to this builder's column in the waterfall display containing the results of the ping. Note that this may not fail for a long time, it is implemented in terms of the timeout on the underlying TCP connection.


Class Variable Details

__iro__

Value:
(<InterfaceClass buildbot.interfaces.IBuilderControl>,
 <InterfaceClass zope.interface.Interface>)

__sro__

Value:
(<InterfaceClass buildbot.interfaces.IBuilderControl>,
 <InterfaceClass zope.interface.Interface>)