opendev
/
git-review
Code Issues Proposed changes
Tool for uploading changesets to Gerrit from git
182 Commits 1 Branch 41 Tags 7 MiB
Python 89.3%
Roff 10.7%
Go to file
Jeremy Stanley 4b286c2c44 Avoid symlinks in the manpage path. 
* setup.py: This works around bug 1073766, what appears to be an
upstream installer issue exposed by e7b8dc61. When attempting to
idempotently create the full destination path, it will fail cryptically
on any existing symlink it finds (expecting only real directories).

Change-Id: I1e502b86854fd6ac57974b579af48cd75d3e7752
 		2012-11-02 02:31:51 +00:00
.gitignore Freeze requirements for sdist packages. 2012-01-27 15:37:44 -05:00
.gitreview Check .gitreview file in repo for location of gerrit. 2011-10-14 13:24:53 -04:00
AUTHORS Add Python 3 support. 2012-05-29 14:24:50 +04:00
HACKING bump year references from 2011 to 2012 2012-03-27 15:50:38 +02:00
LICENSE Ported rfc.sh to a standalone program. 2011-09-25 09:16:31 -07:00
MANIFEST.in Start 1.11. 2012-01-27 03:45:04 -05:00
README.md Make the default branch configurable 2012-01-24 01:41:38 +01:00
git-review Start development on 1.20. 2012-10-31 18:23:06 +01:00
git-review.1 Revert "Introduce base exception classes" 2012-10-31 16:58:48 +00:00
setup.py Avoid symlinks in the manpage path. 2012-11-02 02:31:51 +00:00
tox.ini Revert to 1.17. 2012-09-30 16:39:08 -07:00

README.md

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