Package buildbot :: Module interfaces :: Class IBuildRequestStatus

Class IBuildRequestStatus

zope.interface.Interface --+
                           |
                          IBuildRequestStatus

I represent a request to build a particular set of source code on a particular Builder. These requests may be merged by the time they are finally turned into a Build.

Instance Methods

getSourceStamp()
Get a SourceStamp object which can be used to re-create the source tree that this build used.

source code

getBuilds()
Return a list of IBuildStatus objects for each Build that has been started in an attempt to satify this BuildRequest.

source code

subscribe(observer)
Register a callable that will be invoked (with a single IBuildStatus object) for each Build that is created to satisfy this request.

source code

unsubscribe(observer)
Unregister the callable that was registered with subscribe().

source code

getSubmitTime()
Return the time when this request was submitted.

source code

Class Variables
	__bases__ = `(<InterfaceClass zope.interface.Interface>)`
	__identifier__ = `'buildbot.interfaces.IBuildRequestStatus'`
	__iro__ = `(<InterfaceClass buildbot.interfaces.IBuildRequestSt...`
	__name__ = `'IBuildRequestStatus'`
	__sro__ = `(<InterfaceClass buildbot.interfaces.IBuildRequestSt...`
	dependents = `<WeakKeyDictionary at 50976888>`

Method Details

getSourceStamp()

source code

Get a SourceStamp object which can be used to re-create the source tree that this build used. This method will return an absolute SourceStamp if possible, and its results may change as the build progresses. Specifically, a "HEAD" build may later be more accurately specified by an absolute SourceStamp with the specific revision information.

This method will return None if the source information is no longer available.

Returns:: SourceStamp via Deferred

subscribe(observer)

source code

Register a callable that will be invoked (with a single IBuildStatus object) for each Build that is created to satisfy this request. There may be multiple Builds created in an attempt to handle the request: they may be interrupted by the user or abandoned due to a lost slave. The last Build (the one which actually gets to run to completion) is said to 'satisfy' the BuildRequest. The observer will be called once for each of these Builds, both old and new.

getSubmitTime()

source code

Return the time when this request was submitted. Returns a Deferred.

Class Variable Details

iro

Value:

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

sro

Value:

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

Class IBuildRequestStatus

getSourceStamp()

subscribe(observer)

getSubmitTime()

__iro__

__sro__

iro

sro