Package buildbot :: Module interfaces :: Class IBuilderControl

Class IBuilderControl

zope.interface.Interface --+
                           |
                          IBuilderControl

Instance Methods

[hide private]

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(timeout=30)
Attempt to contact the slave and see if it is still alive.

source code

Class Variables

[hide private]

_InterfaceClass__attrs = {'getBuild': <zope.interface.interfac...

__bases__ = (<InterfaceClass zope.interface.Interface>)

__identifier__ = 'buildbot.interfaces.IBuilderControl'

__iro__ = (<InterfaceClass buildbot.interfaces.IBuilderControl...

__name__ = 'IBuilderControl'

__sro__ = (<InterfaceClass buildbot.interfaces.IBuilderControl...

_implied = {<InterfaceClass buildbot.interfaces.IBuilderContro...

dependents = <WeakKeyDictionary at 45516272>

Inherited from zope.interface.Interface (private): _Element__tagged_values

Method Details

[hide private]

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(timeout=30)

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.

Class Variable Details

[hide private]

_InterfaceClass__attrs

Value:

{'getBuild': <zope.interface.interface.Method object at 0x2b67150>,
 'getPendingBuilds': <zope.interface.interface.Method object at 0x2b67
190>,
 'ping': <zope.interface.interface.Method object at 0x2b67090>,
 'requestBuild': <zope.interface.interface.Method object at 0x2b67110>
,
 'requestBuildSoon': <zope.interface.interface.Method object at 0x2b67
0d0>,
...

iro

Value:

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

sro

Value:

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

_implied

Value:

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