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

Class IBuilderControl

source code

zope.interface.Interface --+
                           |
                          IBuilderControl

Instance Methods
 
requestBuild(request)
Queue a buildbot.process.base.BuildRequest object for later building.
source code
 
requestBuildSoon(request)
Submit a BuildRequest like requestBuild, but raise a buildbot.interfaces.NoSlaveError if no slaves are currently available, so it cannot be used to queue a BuildRequest in the hopes that a slave will eventually connect.
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 14334936>
Method Details

requestBuildSoon(request)

source code 

Submit a BuildRequest like requestBuild, but raise a buildbot.interfaces.NoSlaveError if no slaves are currently available, so it cannot be used to queue a BuildRequest in the hopes that a slave will eventually connect. This method is appropriate for use by things like the web-page 'Force Build' button.

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>)