This responder can be used to update the value of any field in the body of the issue. Allows labeling.
@botname set <value> as <name>
For example, if you configure this responder to change the value of the version, it would respond to:
@botname set v1.0.3 as version
The body of the issue should have the target field placeholder marked with HTML comments.
Following the previous example if the name of the field is version:
Required. The name of the target field in the body of the issue. It can be set using the
name:keyword, or via the name of each instance if there are several instances of this responder specified in the settings file.
Optional Strategy when value placeholders are not defined in the body of the issue. Valid options: append (will add the value at the end of the issue body), prepend (will add the value at the beginning of the issue body) , error (will reply a not-found message). If this param is not present nothing will be done if value placeholder is not found.
Optional. The name of the value to be used in the command, in case it is different from the target field placeholder marked with HTML comments.
if the value placeholder is missing and the if_missing strategy is set to append or prepend, when adding the value it will include this text as heading instead of just the value name.
A sample value string for the target field. It is used for documentation purposes when the Help responder lists all available responders. Default value is xxxxx.
Optional A template file to use to build the response message (name and value are passed to it).
Optional Configuration for a external service call. All available subparams are described in the external_service docs.
Simplest use case:
... responders: set_value: name: version sample_value: v1.0.1 ...
Multiple instances of the responder, some of them restricted to editors:
... responders: set_value: - version: only: editors sample_value: "v1.0.0" - archive: only: editors sample_value: "10.21105/joss.12345" if_missing: prepend heading: "Archive DOI" - repository: sample_value: "github.com/openjournals/buffy" ...