Review Board
This extension is not distributed with Mercurial.
Authors: Dennis Schön, Tigran Mkrtchyan, Colin Caughie
Repository: https://bitbucket.org/ccaughie/hgreviewboard
Alternate version (by mdelagra): https://bitbucket.org/mdelagra/mercurial-reviewboard
Overview
This extension adds a new command 'postreview' to post changesets for review to a Review Board server. It also integrates with TortoiseHg, allowing reviews to be posted within the log view.
Configuration
Configure your .hgrc to enable the extension by adding following lines:
[extensions] reviewboard = /path/to/reviewboard_dir [reviewboard] # REQUIRED ITEMS: server = http://reviewboard.example.com/ # OPTIONAL ITEMS: # user = ... # username for login # password = ... # password for login # target_groups = ... # default review groups # target_people = ... # default review people
Usage
To post the tip changeset to the Review board server:
$ hg postreview tip login to http://reviewboard.example.com username: ... password: Repositories: [1] Stuff [2] miscrepo repository id: 1 review request draft saved: http://reviewboard.example.com/r/366/
To update the review request ID 12 with the tip changeset:
$ hg postreview -e 12 tip login to http://reviewboard.example.com username: ... password: review request draft saved: http://reviewboard.example.com/r/12/
To request a review for changeset 189 using the upstream repository to determine the base revision to use for a parent diff (see http://www.review-board.org/docs/manual/dev/users/tools/post-review/ for an explanation of parent diffs):
$ hg postreview -o 189
crontab
You can set a crontab to create automatically review ticket for new commit every 5 minutes. Set a crontab on the Review Board server. You must replace PATH_TO_THEANO_REPO:
0,5,10,15,20,25,30,35,40,45,50,55 * * * * cd PATH_TO_THEANO_REPO; hg pull
In the .hg/hgrc file of the repository, add this while substituting REVIEW_BOARD_REPOSITORY_ID:
[hooks] incoming = hg postreview -i REVIEW_BOARD_REPOSITORY_ID -p $HG_NODE
The -p option is to publish the new review ticket. Otherwise it will be saved as a draft ticket.
Alternate Version
According to the author, this fork was a functional superset of the original postreview tool (see above) and added a number of features which are now in the Google Code repository, including:
- ability to automatically create a review for outgoing changes or entire branches
- adding all commit messages to the review description
- automatic repository selection
- ability to open reviews in a browser window automatically.
Both versions can be used with TortoiseHg.