Wiki

Clone wiki

hgreviewboard / Home

Mercurial ReviewBoard Extension

This extension adds a command 'postreview' to post changesets for review to a Review Board server.

Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
reviewboard = /path/to/reviewboard_dir

[reviewboard]

# REQUIRED
server = <server_url>             # The URL of your ReviewBoard server

# OPTIONAL
http_proxy = <proxy_url>          # HTTP proxy to use for the connection
user = <rb_username>              # Username to use for ReviewBoard
                                  # connections
password = <rb_password>          # Password to use for ReviewBoard
                                  # connections
repoid = <repoid>                 # ReviewBoard repository ID (normally only
                                  # useful in a repository-specific hgrc)
target_groups = <groups>          # Default groups for new review requests
                                  # (comma-separated list)
target_people = <users>           # Default users for new review requests
                                  # (comma-separated list)
explicit_publish_update = <bool>  # If True, updates posted using the -e
                                  # option will not be published immediately
                                  # unless the -p option is also used
launch_webbrowser = <bool>        # If True, new or updated requests will
                                  # always be shown in a web browser after
                                  # posting.

Usage

To post the tip changeset to the ReviewBoard 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

Updated