Merge "Description Setter Plugin support as builder"

jenkins_jobs/modules/builders.py

@@ -2905,3 +2905,31 @@ def runscope(parser, xml_parent, data):
     except KeyError as e:
         raise MissingAttributeError(e.args[0])
     XML.SubElement(runscope, 'timeout').text = str(data.get('timeout', '60'))
+
+
+def description_setter(parser, xml_parent, data):
+    """yaml: description-setter
+    This plugin sets the description for each build,
+    based upon a RegEx test of the build log file.
+
+    Requires the Jenkins :jenkins-wiki:`Description Setter Plugin
+    <Description+Setter+Plugin>`.
+
+    :arg str regexp: A RegEx which is used to scan the build log file
+        (default '')
+    :arg str description: The description to set on the build (optional)
+
+    Example:
+
+    .. literalinclude::
+        /../../tests/builders/fixtures/description-setter001.yaml
+       :language: yaml
+    """
+
+    descriptionsetter = XML.SubElement(
+        xml_parent,
+        'hudson.plugins.descriptionsetter.DescriptionSetterBuilder')
+    XML.SubElement(descriptionsetter, 'regexp').text = data.get('regexp', '')
+    if 'description' in data:
+        XML.SubElement(descriptionsetter, 'description').text = data[
+            'description']

tests/builders/fixtures/description-setter001.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<project>
+  <builders>
+    <hudson.plugins.descriptionsetter.DescriptionSetterBuilder>
+      <regexp>.*(&lt;a href=.*a&gt;)</regexp>
+      <description>some description</description>
+    </hudson.plugins.descriptionsetter.DescriptionSetterBuilder>
+  </builders>
+</project>

tests/builders/fixtures/description-setter001.yaml

@@ -0,0 +1,4 @@
+builders:
+  - description-setter:
+      regexp: ".*(<a href=.*a>)"
+      description: "some description"