This projects includes a few scripts to help review and submit gerrit patches.
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: 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
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
This script monitors a set of patches on gerrit, flipping the CodeReview/Verify/CQReady bits on the review until it is merged.
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
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
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: 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
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:https://anongit.freedesktop.org/drm/drm'" 031ae70a3329..
Does what troll-o-matic does above, but for your local git tree instead of gerrit.
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
review-o-matic.py --start "$( git log --pretty=format:%H cros/chromeos-4.19.. | tail -n1 )"
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: 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
Find all commits in the series that contains commit d9facae6afe1
relate-o-matic.py --git-dir ~/src/kernel --commit d9facae6afe1