Common/Using dippy-bird

From BlissWiki
Jump to navigation Jump to search

If you want to review commits quickly on our Gerrit, use the dippy-bird.php script created by the WikiMedia foundation.

Thanks to Vaughn Newman (@rwaterspf1) for the original instructions!

Installation[edit]

Make sure you have PHP installed.

Download the script and put it in an easily-accessible place.

Usage[edit]

Reviewing commits (code-review only)[edit]

To review commits, run:

php dippy-bird.php --username=ideaman924 --server=review.blissroms.com --port=29418 -q="status:open topic:test" -a=review --review=+1 --verify=0

This will review all commits that match the following criteria:

  • Is open for review (not closed, merged, or abandoned)
  • Has the topic test

And will apply +1 code-review and no verify, indicating that you have a successful build with the commits included.

Reviewing commits (code-review and verification)[edit]

To review commits with verification, run:

php dippy-bird.php --username=ideaman924 --server=review.blissroms.com --port=29418 -q="status:open topic:test" -a=review --review=+2 --verify=+1

This will review all commits that match the following criteria:

  • Is open for review (not closed, merged, or abandoned)
  • Has the topic test

And will apply +2 code-review and +1 verify, indicating that you have tested the commits on an actual device. This means that the commits are now ready for merging.

Submitting commits (admins only)[edit]

To submit commits that are already reviewed, run:

php dippy-bird.php --username=jackeagle --server=review.blissroms.com --port=29418 -q="status:open topic:test" -a=submit

This will submit all commits that match the following criteria:

  • Is open for review (not closed, merged, or abandoned)
  • Has the topic test

And will push them to our main GitHub. If the commits are not reviewed yet, or if they do not have the verified tag, this command will fail for the patchsets that are not reviewed yet. Other commits will still be merged.