3.5.7. changesource¶

resource type: changesource

Attributes

changesourceid (integer) – the ID of this changesource
master? (master) – the master on which this worker is running, or None if it is inactive
name (string) – name of this changesource

A changesource generates change objects, for example in response to an update in some repository. A particular changesource (by name) runs on at most one master at a time.

3.5.7.1. Update Methods¶

All update methods are available as attributes of master.data.updates.

class buildbot.data.changesources.ChangeSource¶

findChangeSourceId(name)¶

Parameters: name (string) – changesource name
Returns: changesource ID via Deferred

Get the ID for the given changesource name, inventing one if necessary.

trySetChangeSourceMaster(changesourceid, masterid)¶

Parameters

changesourceid (integer) – changesource ID to try to claim
masterid (integer) – this master’s master ID

Returns

True or False, via Deferred

Try to claim the given scheduler for the given master and return True if the scheduler is to be activated on that master.

3.5.7.2. Endpoints¶

path: /changesources

This path selects all changesource.

GET

returns: collection of changesource

path: /changesources/{changesourceid}

Path Keys: changesourceid (number) – the id of a changesource

This path selects one changesource given its id.

GET

returns: collection of changesource

path: /masters/{masterid}/changesources

Path Keys: masterid (number) – the id of the master

This path selects all changesources for a given master

GET

returns: collection of changesource

path: /masters/{masterid}/changesources/{changesourceid}

Path Keys: masterid (number) – the id of the master

This path selects one changesource by id for a given master

GET

returns: collection of changesource