blob: 5b70bd1e51d6fe5d594d5f3966125b122cdc10a5 [file] [log] [blame]
gerrit test-submit-rule
=======================
NAME
----
gerrit test-submit-rule - Test prolog submit rules with a chosen changeset.
SYNOPSIS
--------
[verse]
'ssh' -p <port> <host> 'gerrit test-submit-rule'
[-s]
[--no-filters]
[--format {TEXT | JSON}]
CHANGE
DESCRIPTION
-----------
Provides a way to test prolog link:prolog-cookbook.html[submit rules].
OPTIONS
-------
-s::
Reads a rules.pl file from stdin instead of rules.pl in refs/meta/config.
--no-filters::
Don't run the submit_filter/2 from the parent projects of the specified change.
--format::
What output format to display the results in.
+
--
`text`:: Simple text based format.
`json`:: A JSON object described in link:json.html#submitRecord[submit record].
`json_compact`:: Minimized JSON output.
--
ACCESS
------
Can be used by anyone that has permission to read the specified changeset.
EXAMPLES
--------
Test submit_rule from stdin.
====
$ cat non-author-codereview.pl | ssh -p 29418 review.example.com gerrit test-submit-rule -s I78f2c6673db24e4e92ed32f604c960dc952437d9
Non-Author-Code-Review: NOT_READY
Verified: NOT_READY
Code-Review: NOT_READY by Anonymous Coward <test@email.com>
NOT_READY
====
Test submit_rule from stdin and return the results as JSON.
====
cat non-author-codereview.pl | ssh -p 29418 review.example.com gerrit test-submit-rule --format=JSON -s I78f2c6673db24e4e92ed32f604c960dc952437d9
{
"approvals": [
{
"type": "Verified",
"value": "NEED"
},
{
"type": "Code-Review",
"value": "OK",
"by": {
"email": "test@email.com",
"username": "test"
}
}
],
"value": "NOT_READY"
}
====
Test the active submit_rule from the refs/meta/config branch, ignoring filters in the project parents.
====
$ ssh -p 29418 review.example.com gerrit test-submit-rule I78f2c6673db24e4e92ed32f604c960dc952437d9 --no-filters
Verified: NOT_READY
Code-Review: NOT_READY by Anonymous Coward <test@email.com>
NOT_READY
====
SCRIPTING
---------
Can be used either interactively for testing new prolog submit rules, or from a script to check the submit status of a change.
GERRIT
------
Part of link:index.html[Gerrit Code Review]