3.4.4. BuildSetSummaryNotifierMixin

Some status notifiers will want to report the status of all builds all at once for a particular buildset, instead of reporting each build individually as it finishes. In order to do this, the status notifier must wait for all builds to finish, collect their results, and then report a kind of summary on all of the collected results. The act of waiting for and collecting the results of all of the builders is implemented via BuildSetSummaryNotifierMixin, to be subclassed by a status notification implementation.

3.4.4.1. BuildSetSummaryNotifierMixin

buildbot.status.buildset.BuildSetSummaryNotifierMixin::

This class provides some helper methods for implementing a status notification that provides notifications for all build results for a buildset at once.

This class provides the following methods:

buildbot.status.buildset.summarySubscribe()

Call this to start receiving sendBuildSetSummary callbacks. Typically this will be called from the subclass's startService method.

buildbot.status.buildset.summaryUnsubscribe()

Call this to stop receiving sendBuildSetSummary callbacks. Typically this will be called from the subclass's stopService method.

The following methods are hooks to be implemented by the subclass.

buildbot.status.buildset.sendBuildSetSummary(buildset, builds)
Parameters:
  • buildset -- A BuildSet object
  • builds -- A list of Build objects

This method must be implemented by the subclass. This method is called when all of the builds for a buildset have finished, and it should initiate sending a summary status for the buildset.

The following attributes must be provided by the subclass.

buildbot.status.buildset.master

This must point to the BuildMaster object.