Class BuildMaster

Overrides: twisted.application.service.MultiService.__init__

Decorators:

• @defer.deferredGenerator

Overrides: twisted.application.service.Service.startService

Overrides: twisted.application.service.Service.stopService

Decorators:

• @defer.deferredGenerator

Overrides: config.ReconfigurableServiceMixin.reconfigService

Return the obejct id for this master, for associating state with the master.

Returns:

ID, via Deferred

Add a change to the buildmaster and act on it.

This is a wrapper around ChangesConnectorComponent.addChange which also acts on the resulting change and returns a Change instance.

Note that all parameters are keyword arguments, although who, files, and comments can be specified positionally for backward-compatibility.

Parameters:

• author (unicode string) - the author of this change
• who - deprecated name for author
• files - a list of filenames that were changed
• comments - user comments on the change
• is_dir - deprecated
• isdir - deprecated name for is_dir
• revision (unicode string) - the revision identifier for this change
• when_timestamp (datetime instance or None) - when this change occurred, or the current time if None
• when (integer (UNIX epoch time) or None) - deprecated name and type for when_timestamp
• branch (list of unicode strings) - the branch on which this change took place
• category (unicode string) - category for this change (arbitrary use by Buildbot users)
• revlink (unicode string) - link to a web view of this revision
• properties (dictionary with string keys and simple values (JSON-able). Note that the property source is not included in this dictionary.) - properties to set on this change
• repository (unicode string) - the repository in which this change took place
• project (unicode string) - the project this change is a part of
• src (string) - source of the change (vcs or other)

Returns:

Change instance via Deferred

Request that callback be called with each Change object added to the cluster.

Note: this method will go away in 0.9.x

Add a buildset to the buildmaster and act on it. Interface is identical to buildbot.db.buildsets.BuildsetConnectorComponent.addBuildset, including returning a Deferred, but also potentially triggers the resulting builds.

Request that callback(bsid=bsid, ssid=ssid, reason=reason, properties=properties, builderNames=builderNames, external_idstring=external_idstring) be called whenever a buildset is added. Properties is a dictionary as expected for BuildsetsConnectorComponent.addBuildset.

Note that this only works for buildsets added on this master.

Note: this method will go away in 0.9.x

Instructs the master to check whether the buildset is complete, and notify appropriately if it is.

Note that buildset completions are only reported on the master on which the last build request completes.

Decorators:

• @defer.deferredGenerator

Request that callback(bsid, result) be called whenever a buildset is complete.

Note: this method will go away in 0.9.x

Notifies the master that a build request is available to be claimed; this may be a brand new build request, or a build request that was previously claimed and unclaimed through a timeout or other calamity.

Parameters:

• bsid - containing buildset id
• brid - buildrequest ID
• buildername - builder named by the build request

Request that callback be invoked with a dictionary with keys brid (the build request id), bsid (buildset id) and buildername whenever a new build request is added to the database. Note that, due to the delayed nature of subscriptions, the build request may already be claimed by the time callback is invoked.

Note: this method will go away in 0.9.x

Decorators:

• @defer.deferredGenerator

Decorators:

• @defer.deferredGenerator

Special descriptor for class __provides__

The descriptor caches the implementedBy info, so that
we can get declarations for objects without instance-specific
interfaces a bit quicker.

For example:

  >>> from zope.interface import Interface
  >>> class IFooFactory(Interface):
  ...     pass
  >>> class IFoo(Interface):
  ...     pass
  >>> class C(object):
  ...     implements(IFoo)
  ...     classProvides(IFooFactory)
  >>> [i.getName() for i in C.__provides__]
  ['IFooFactory']

  >>> [i.getName() for i in C().__provides__]
  ['IFoo']

Overrides: twisted.application.service.Service.__provides__