3.8.3. Builders connector

class buildbot.db.builders.BuildersConnectorComponent

This class handles the relationship between builder names and their IDs, as well as tracking which masters are configured for this builder.

Builders are represented by master dictionaries with the following keys:

id – the ID of this builder
name – the builder name, a 20-character identifier
masterids – the IDs of the masters where this builder is configured (sorted by id)

findBuilderId(name, autoCreate=True)

Parameters

name (20-character identifier) – name of this builder
autoCreate (bool) – automatically create the builder if name not found

Returns

builder id via Deferred

Return the builder ID for the builder with this builder name. If such a builder is already in the database, this returns the ID. If not and autoCreate is True, the builder is added to the database.

addBuilderMaster(builderid=None, masterid=None)

Parameters

builderid (integer) – the builder
masterid (integer) – the master

Returns

Deferred

Add the given master to the list of masters on which the builder is configured. This will do nothing if the master and builder are already associated.

removeBuilderMaster(builderid=None, masterid=None)

Parameters

builderid (integer) – the builder
masterid (integer) – the master

Returns

Deferred

Remove the given master from the list of masters on which the builder is configured.

getBuilder(builderid)

Parameters: builderid (integer) – the builder to check in
Returns: Builder dict or None via Deferred

Get the indicated builder.

getBuilders(masterid=None)

Parameters: masterid (integer) – ID of the master to which the results should be limited
Returns: list of Builder dicts via Deferred

Get all builders (in unspecified order). If masterid is given, then only builders configured on that master are returned.