== 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 [[http://www.review-board.org/|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.

----
CategoryExtensionsByOthers