support github pull request labels
Allow to match trigger on adding or removing github labels. Also
reporter can add or remove labels.
Change-Id: Id385b92590e252c283ba3ebe1ecfd33b34469a2e
Co-Authored-By: Jesse Keating <omgjlk@us.ibm.com>
diff --git a/doc/source/reporters.rst b/doc/source/reporters.rst
index ced3b78..e3ab947 100644
--- a/doc/source/reporters.rst
+++ b/doc/source/reporters.rst
@@ -55,6 +55,16 @@
merge the pull reqeust. Defaults to ``false``.
``merge=true``
+ **label**
+ List of strings each representing an exact label name which should be added
+ to the pull request by reporter.
+ ``label: 'test successful'``
+
+ **unlabel**
+ List of strings each representing an exact label name which should be removed
+ from the pull request by reporter.
+ ``unlabel: 'test failed'``
+
SMTP
----
diff --git a/doc/source/triggers.rst b/doc/source/triggers.rst
index cd342c3..d8c7ee8 100644
--- a/doc/source/triggers.rst
+++ b/doc/source/triggers.rst
@@ -122,6 +122,12 @@
*comment* - comment added on pull request
+ *labeled* - label added on pull request
+
+ *unlabeled* - label removed from pull request
+
+ *push* - head reference updated (pushed to branch)
+
**comment**
This is only used for ``pull_request`` ``comment`` events. It accepts a list
of regexes that are searched for in the comment string. If any of these
@@ -129,6 +135,14 @@
``comment: retrigger`` will match when comments containing 'retrigger'
somewhere in the comment text are added to a pull request.
+ **label**
+ This is only used for ``labeled`` and ``unlabeled`` actions. It accepts a list
+ of strings each of which matches the label name in the event literally.
+ ``label: recheck`` will match a ``labeled`` action when pull request is
+ labeled with a ``recheck`` label. ``label: 'do not test'`` will match a
+ ``unlabeled`` action when a label with name ``do not test`` is removed from
+ the pull request.
+
Additionally a ``push`` event can be configured, with an
associated ``ref`` represented as a regex to match branches or tags.