Caution

Buildbot no longer supports Python 2.7 on the Buildbot master.

Caution

This page documents the latest, unreleased version of Buildbot. For documentation for released versions, see http://docs.buildbot.net/current/.

3.5.16. sourcedproperties

resource type: sourcedproperties
Attributes

[] (object) – Each key of this map is the name of a defined property The value consist on a couple (source, value)

user-specified properties for this change, represented as an object mapping keys to tuple (value, source)

Properties are present in several data resources, but have a separate endpoints, because they can represent a large dataset.

3.5.16.1. Update Methods

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

class buildbot.data.properties.Properties
setBuildProperty(buildid, name, value, source)
Parameters
  • buildid (integer) – build ID

  • name (unicode) – Name of the property to set

  • value (Any JSON-able type is accepted (lists, dicts, strings and numbers)) – Value of the property

  • source (unicode) – Source of the property to set

Set a build property. If no property with that name exists in that build, a new property will be created.

setBuildProperties(buildid, props)
Parameters
  • buildid (integer) – build ID

  • props (IProperties) – Name of the property to set

Synchronise build properties with the db. This sends only one event in the end of the sync, and only if properties changed. The event contains only the updated properties, for network efficiency reasons.

3.5.16.2. Endpoints

path: /builds/{buildid}/properties
Path Keys

buildid (number) – the id of the build

This path selects all properties of a build

GET
returns

collection of sourcedproperties

path: /buildsets/{bsid}/properties
Path Keys

bsid (identifier) – the id of the buildset

This path selects all properties of a buildset. Buildset properties is part of the initial properties of a build.

GET
returns

collection of sourcedproperties