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 a
BuilderModeldataclass with the following fields:id– the ID of this buildername– the builder namedescription– the builder’s description (optional)description_format– the format of builder’s description (optional)description_html– the builder description rendered as html (optional, depends ondescription_format)projectid– the builder’s projecttags– the builder’s tagsmasterids– the IDs of the masters where this builder is configured (sorted by id)
- findBuilderId(name, autoCreate=True)
- Parameters:
name (string) – 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
autoCreateis 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:
BuilderModelor None via Deferred
Get the indicated builder.
- getBuilders(masterid=None, projectid=None, workerid=None)
- Parameters:
masterid (integer) – ID of the master to which the results should be limited
masterid – ID of the project to which the results should be limited
workerid (integer) – ID of the configured worker to which the results should be limited
- Returns:
list of
BuilderModelvia Deferred
Get all builders (in unspecified order). If
masteridis specified, then only builders configured on that master are returned. Ifprojectidis specified, then only builders for a particular project are returned. Ifworkeridis specified, then only builders for a particular configured worker are returned.