RBTools has been an important part of the life of Review Board users for many years. While it started off as a single tool for posting review requests, its feature set has evolved with time, turning into an extensible set of tools and APIs for talking to Review Board.
Today, we're finally pulling RBTools out of the 0.x era with the release of RBTools 1.0.
Compatible with Python 3
Both the RBTools commands and the Python API now support Python 2.7 and 3.5+.
(Please let us know if you hit any issues on Python 3, as this is still pretty new.)
Better Repository Detection and Git Support
RBTools now does a better job determining which repository it's working with, in case there's confusion. For example, a Mercurial repository nested in a Git-managed home directory will no longer cause problems.
Git repositories in particular are now easier to work with. When generating a diff, RBTools now looks for the nearest upstream parent commit or branch, instead of requiring that users or repositories configure a specific tracking branch.
Publish Automated Reviews
Writing your own automated review solutions for Review Board 3.0 or RBCommons just became easier through the new rbt status-update command. Your scripts can use it to file a pending status update on a review request (showing that checks are being performed) and then update it to say that all is well or to report issues that need to be fixed.
This is useful for in-house continuous integration setups where you're analyzing code for errors, style issues, documentation, or any other requirements you might have.
Easily Land Complex Dependent Changes
rbt land can now land multiple review requests tied together using the Depends On field.
This works with -r to take the ID of the review request you want to land. It will figure out which review requests must land before it and in which order. For example, if review request 3 depends on 2, which depends on 1, you can run:
$ rbt land --recursive -r 3
Instead of:
$ rbt land -r 1
$ rbt land -r 2
$ rbt land -r 3
This is a precursor to the new DVCS support coming soon in Review Board 4.0.
And That's Not All
-
rbt setup-completion was added to enable auto-completion of RBTools commands and arguments in Bash and ZSH shells.
-
rbt alias was added to help you list and test out your custom aliases.
-
rbt post --submit-as can now automate posting review request updates, and not just new review requests, on a user's behalf.
-
rbt post -m and rbt publish -m let you specify a custom description of your draft's changes when publishing (equivalent to filling out the "Describe your changes" box when publishing in the browser).
-
rbt post --trivial-publish and rbt publish --trivial let you publish trivial updates to a review request without sending out e-mails to everyone (when using Review Board 3.0 or RBCommons).
-
rbt status now lists the review state and local branch for each review request you have up for review.
-
Warnings and errors in command output is now specially highlighted to help it stand out.
-
Several fixes and improvements for Git and Subversion compatibility.
-
The API has been improved, supporting extra_data fields and easier pagination of resources.
And plenty of other fixes and improvements. See the release notes for the full list of changes in 1.0.
Download It Today!
RBTools is out today for Windows, Linux, and Mac. Head on over to the downloads page for installation instructions.