3ad95bd821
I'm thinking it makes more sense to have: $> git review $> git review submit -R stable/essex $> git review list $> git review download I2b2488ff rather than: $> git review $> git review -R stable/essex $> git review -l $> git review -d I2b2488ff i.e. using flag arguments as "actions" seems funky. So, add a positional "action" argument it and do some trickery to make "submit" the default action. The only potential regression people might notice is if they're submitting to a branch called "submit" then they'll need to do: $> git review -- submit Change-Id: I07397e09d20b3fd0b5a919f8ef997b0852ec86cb
git-review
A git command for submitting branches to Gerrit
git-review is a tool that helps submitting git branches to gerrit for review.
Setup
git-review, by default, looks for a git remote called gerrit, and submits the current branch to HEAD:refs/for/master at that remote.
If the "gerrit" remote does not exist, git-review looks for a file called .gitreview at the root of the repository with information about the gerrit remote. Assuming that file is present, git-review should be able to automatically configure your repository the first time it is run.
Usage
Hack on some code, then:
git review
If you want to submit that code to a branch other than "master", then:
git review branchname
If you want to submit to a different remote:
git review -r my-remote
If you want to supply a review topic:
git review -t topic/awesome-feature
If you want to submit a branch for review and then remove the local branch:
git review -f
If you want to skip the automatic "git rebase -i" step:
git review -R
If you want to download change 781 from gerrit to review it:
git review -d 781
If you just want to do the commit message and remote setup steps:
git review -s
.gitreview file format
Example .gitreview file (used to upload for git-review itself)
[gerrit]
host=review.openstack.org
port=29418
project=openstack-ci/git-review.git
defaultbranch=master
Required values: host, project
Optional values: port (default: 29418), defaultbranch (default: master)
Notes
- Username not required because it is requested on first run
- Unlike git config files there cannot be any whitespace before the name of the variable.
- git-review will create a gerrit remote upon first run
Installation
Install with pip install git-review
For installation from source simply add git-review to your $PATH
Contributing
To get the latest code, see: https://github.com/openstack-ci/git-review
Bugs are handled at: https://launchpad.net/git-review
Code reviews are, as you might expect, handled by gerrit. The gerrit they use is http://review.openstack.org
Use git review to submit patches (after creating a gerrit account that links to your launchpad account). Example:
# Do your commits
git review
# Enter your username if promped