Class IStatus

Return the URL of a page which provides information on 'thing', which should be an object that implements one of the status interfaces defined in buildbot.interfaces. Returns None if no suitable page is available (or if no Waterfall is running).

Return the IBuilderStatus object for a given named Builder. Raises KeyError if there is no Builder by that name.

Return a list of un-completed build sets.

Returns:

list of IBuildSetStatus implementations, via Deferred.

Return a generator that will produce IBuildStatus objects each time you invoke its .next() method, starting with the most recent finished build and working backwards.

Parameters:

• builders - this is a list of Builder names, and the generator will only produce builds that ran on the given Builders. If the list is empty, produce builds from all Builders.
• branches - this is a list of branch names, and the generator will only produce builds that used the given branches. If the list is empty, produce builds from all branches.
• num_builds - the generator will stop after providing this many builds. The default of None means to produce as many builds as possible.
• finished_before (int: a timestamp, seconds since the epoch) - if provided, do not produce any builds that finished after the given timestamp.
• max_search (int) - this method may have to examine a lot of builds to find some that match the search parameters, especially if there aren't any matching builds. This argument imposes a hard limit on the number of builds that will be examined within any given Builder.

Register an IStatusReceiver to receive new status events. The receiver will immediately be sent a set of 'builderAdded' messages for all current builders. It will receive further 'builderAdded' and 'builderRemoved' messages as the config file is reloaded and builders come and go. It will also receive 'buildsetSubmitted' messages for all outstanding BuildSets (and each new BuildSet that gets submitted). No additional messages will be sent unless the receiver asks for them by calling .subscribe on the IBuilderStatus objects which accompany the addedBuilder message.

Unregister an IStatusReceiver. No further status messgaes will be delivered.

__iro__

Value:

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

__sro__

Value:

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