gerrit test-submit-rule

NAME

gerrit test-submit-rule - Test prolog submit rules with a chosen changeset.

SYNOPSIS

ssh -p <port> <host> gerrit test-submit-rule
  [-s]
  [--no-filters]
  [--format {TEXT | JSON}]
  CHANGE

DESCRIPTION

Provides a way to test prolog 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 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.

Part of Gerrit Code Review