188.8.131.52 Common Build Properties
The following build properties are set when the build is started, and
are available to all steps.
This comes from the build's SourceStamp, and describes which branch is
being checked out. This will be
None (which interpolates into
WithProperties as an empty string) if the build is on the
default branch, which is generally the trunk. Otherwise it will be a
string like “branches/beta1.4”. The exact syntax depends upon the VC
system being used.
This also comes from the SourceStamp, and is the revision of the source code
tree that was requested from the VC system. When a build is requested of a
specific revision (as is generally the case when the build is triggered by
Changes), this will contain the revision specification. This is always a
string, although the syntax depends upon the VC system in use: for SVN it is an
integer, for Mercurial it is a short string, for Darcs it is a rather large
If the “force build” button was pressed, the revision will be
which means to use the most recent revision available. This is a “trunk
build”. This will be interpolated as an empty string.
This is set when a Source step checks out the source tree, and
provides the revision that was actually obtained from the VC system.
In general this should be the same as
revision, except for
trunk builds, where
got_revision indicates what revision was
current when the checkout was performed. This can be used to rebuild
the same source code later.
Note that for some VC systems (Darcs in particular), the revision is a
large string containing newlines, and is not suitable for interpolation
into a filename.
This is a string that indicates which Builder the build was a part of.
The combination of buildername and buildnumber uniquely identify a
Each build gets a number, scoped to the Builder (so the first build
performed on any given Builder will have a build number of 0). This
integer property contains the build's number.
This is a string which identifies which buildslave the build is
If the build was started from a scheduler, then this property will
contain the name of that scheduler.
The repository of the sourcestamp for this build
The project of the sourcestamp for this build
The absolute path of the base working directory on the slave, of the current