opendev
/
git-review
Code Issues Proposed changes
Tool for uploading changesets to Gerrit from git
161 Commits 1 Branch 41 Tags 7 MiB
Python 89.3%
Roff 10.7%
Go to file
Dereckson e7b8dc6107 Make setup.py less Linux-specific, more UNIX-compliant. 
- #!/usr/bin/python -> #!/usr/bin/env python
  BSD OS use /usr/local/bin/python

- Man pages location is OS specific.
  For example, this is /usr/local/man on FreeBSD
  or /usr/share/man on Debian.

  I checked several Python projects like Nose-devs,
  it seems there is a consensus to use 'man/manN'.

Change-Id: I584c80c23b1fb9cfe77025d8c93ab9494a7b6cf0
 		2012-10-22 00:21:45 +02: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 Due to gerrit bug regeneration of Change-Id must be nessecary 2012-10-08 12:50:06 -07:00
git-review.1 Add support to list changes for review 2012-04-13 16:25:12 -07:00
setup.py Make setup.py less Linux-specific, more UNIX-compliant. 2012-10-22 00:21:45 +02: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