File Labeller

The File Labeller is used to generate labels based on the content of a disk file. This file may be created by your build process, or by some outside mechanism. The labeller is configured with the location of the file, and it reads the file content to generate the label for CCNet.

The following configuration would prefix all labels with the string 'Foo-', so the if the file contains '213', the build would be labelled 'Foo-213'.

<project>
   <labeller type="fileLabeller">
     <labelFilePath>xxx</labelFilePath>
     <prefix>Foo-</prefix>
     <allowDuplicateSubsequentLabels>true</allowDuplicateSubsequentLabels>
   </labeller>
   <!-- Other project configuration to go here -->
</project>

Configuration Elements:

Node	Description	Type	Required	Default
prefix	Any string to be put in front of all labels	string	false	empty string
labelFilePath	The pathname of the file to read. This can be the absolute path or one relative to the project's working directory.	string	true	n/a
allowDuplicateSubsequentLabels	If true, , a label which matches the immediately previous label will be generated as is. Otherwise it will have a version number appended (e.g., prefixlabel-1, prefixlabel-2).	boolean	false	true

The File Labeller was added in build 1.3.0.2870, and given the finishing touch in 1.3.0.2955. It is available in CCNet 1.3 and later.