review-o-matic and friends

This projects includes a few scripts to help review and submit gerrit patches.

troll-o-matic

This script trolls gerrit for BACKPORT/UPSTREAM/FROMGIT/FROMLIST prefixed changes and compares the downstream backport with the upstream source. If a difference between upstream and downstream is detected, the script will print the difference between patches for the human reviewer to validate. The script also checks that the required fields are present in the commit message and checks upstream git logs for "Fixes:" references in case the backport has a bug which is already fixed upstream.

A sample config is available in the repository under config.sample.ini.

Usage

usage: troll-o-matic.py [-h] [--verbose] [--chatty] [--daemon] [--dry-run]
                        [--force-cl FORCE_CL] [--force-rev FORCE_REV]
                        [--force-all] [--force-prefix FORCE_PREFIX]
                        [--force-project FORCE_PROJECT] [--config CONFIG]

Troll gerrit reviews

optional arguments:
  -h, --help            show this help message and exit
  --verbose             print commits
  --chatty              print diffs
  --daemon              Run in daemon mode, for continuous trolling
  --dry-run             skip the review step
  --force-cl FORCE_CL   Force review a CL
  --force-rev FORCE_REV
                        Specify a specific revision of the force-cl to review
                        (ignored if force-cl is not true)
  --force-all           Force review all (implies dry-run)
  --force-prefix FORCE_PREFIX
                        Only search for the provided prefix
  --force-project FORCE_PROJECT
                        Only search for changes in the provided project
  --config CONFIG       Path to config file

Example Invocations

Daemon mode:

troll-o-matic.py --config config.ini --daemon

Target a CL for testing:

troll-o-matic.py --config config.ini --force-cl 1487385 --dry-run

submit-o-matic

This script monitors a set of patches on gerrit, flipping the CodeReview/Verify/CQReady bits on the review until it is merged.

Usage

usage: submit-o-matic.py [-h] --last_cid LAST_CID [--daemon] [--review]
                         [--verify] [--ready] [--dry-run]

Auto review/submit gerrit cls

optional arguments:
  -h, --help           show this help message and exit
  --last_cid LAST_CID  Gerrit change-id of last patch in set
  --daemon             Run in daemon mode, continuously update changes until
                       merged
  --review             Mark changes as reviewed
  --verify             Mark changes as verified
  --ready              Mark changes as ready
  --dry-run	       Practice makes perfect

Example Invocations

Flip the Verify and CQReady bits on the entire gerrit series ending in change 1439600. Continue to flip those bits until it has been marked as merged.

submit-o-matic.py --last_cid 1439600 --daemon --verify --ready

backport-o-matic

Adds the required fields to a backport commit message. Should be used in conjunction with git filter-branch to alter a series of git commits.

Usage

usage: backport-o-matic.py [-h] [--prefix PREFIX] [--tree TREE] [--bug BUG]
                           [--test TEST] [--sob SOB] [--no-preserve-tags]

    Add CrOS goo to commit range
 
    Usage:
      git filter-branch --msg-filter "backport-o-matic.py --prefix='UPSTREAM'         --bug='b:12345' --test='by hand' --sob='Real Name <email>'"
  

optional arguments:
  -h, --help          show this help message and exit
  --prefix PREFIX     subject prefix
  --tree TREE         location of git-tree
  --bug BUG           BUG= value
  --test TEST         TEST= value
  --sob SOB           "Name <email>" for SoB
  --no-preserve-tags  Overwrite existing CrOS tags

Example Invocations

git filter-branch -f --msg-filter "backport-o-matic.py --prefix='FROMGIT' --bug='None' --test='Tested, trust me' --sob='Sean Paul <[email protected]>' --tree='git://anongit.freedesktop.org/drm/drm'" 031ae70a3329..

review-o-matic

Does what troll-o-matic does above, but for your local git tree instead of gerrit.

Usage

usage: review-o-matic.py [-h] --start START [--prefix PREFIX] [--verbose]
                         [--chatty]

Auto review UPSTREAM patches

optional arguments:
  -h, --help       show this help message and exit
  --start START    commit hash to start from
  --prefix PREFIX  subject prefix
  --verbose        print commits
  --chatty         print diffs

Example Invocations

review-o-matic.py --start "$( git log --pretty=format:%H cros/chromeos-4.19.. | tail -n1 )"

relate-o-matic

Given a commit hash, this script will find other patches in the same series.

This requires that the given commit has a Link: tag in the commit message pointing to a allowed patchwork location.

Usage

usage: relate-o-matic.py [-h] [--git-dir GIT_DIR] [--verbose] [--chatty]
                         --commit COMMIT

Get related patches

optional arguments:
  -h, --help         show this help message and exit
  --git-dir GIT_DIR  Path to git directory
  --verbose          print commits
  --chatty           print diffs
  --commit COMMIT    commit hash to find related patches

Example Invocations

Find all commits in the series that contains commit d9facae6afe1

relate-o-matic.py --git-dir ~/src/kernel --commit d9facae6afe1