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

Class IBuildRequestStatus

source code

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