RBTools - Command Line Tools for Review Board
RBTools is a set of command line tools and a rich Python API for use with Review Board.
These tools make it easy to post changes for review, keep them up-to-date, land reviewed changes, and test other people's changes in your own tree, check your workload, and much more.
When using RBTools, you'll do most everything through the rbt command, which supports a number of sub-commands, like post, diff, land, and patch.
Installing RBTools
You can install RBTools in any Python environment by running:
$ pip install RBTools
We also provide native installers for Windows. See the RBTools Downloads page for downloads and installation instructions.
See the RBTools documentation for more information.
Using the Python API
The included Python API can be used to write scripts and applications that interface with Review Board, and can also be used to write new commands for RBTools.
There's very little that you can't do with the Python API. To learn more, see the RBTools Python API documentation and the Review Board API documentation.
Getting Support
We can help you get going with Review Board and RBTools, and diagnose any issues that may come up.
We provide more dedicated, private support for your organization through a support contract, offering:
- Same-day responses (generally within a few hours, if not sooner)
- Confidential communications
- Installation/upgrade assistance
- Emergency database repair
- Video/chat meetings (by appointment)
- Priority fixes for urgent bugs
- Backports of urgent fixes to older releases (when possible)
Support contracts fund the development of Review Board, RBTools, and our other open source projects.
For basic questions, there's a public community support discussion list. We generally respond to requests within a couple of days. This support works well for general, non-urgent questions that don't need to expose confidential information.
Reporting Bugs
Hit a bug? Let us know by filing a bug report.
You can also look through the existing bug reports to see if anyone else has already filed the bug.
Contributing
Are you a developer? Do you want to integrate with RBTools, or work on RBTools itself? Great! Let's help you get started.
We accept patches to Review Board, RBTools, and other related projects on reviews.reviewboard.org. (Please note that we do not accept pull requests.)
Got any questions about anything related to RBTools and development? Head on over to our development discussion list.
Testing RBTools
If you're writing patches for RBTools, you'll need to know how to run our test suite.
First, make sure you have the necessary dependencies:
$ pip install -e .
$ pip install -r dev-requirements.txt
Running the Tests
Running the test suite is easy. Simply run:
$ pytest
from the top of the source tree. You can also run a particular set of tests. For instance:
$ pytest ./rbtools/api/tests
See pytest --help for more options.
Related Projects
-
Review Board - Our open source, extensible code review, document review, and image review tool.
-
Djblets - Our pack of Django utilities for datagrids, API, extensions, and more. Used by Review Board.
-
Review Bot - Pluggable, automated code review for Review Board.
-
RB Gateway - Manages Git repositories, providing a full API enabling all of Review Board's feaures.
You can see more on github.com/beanbaginc and github.com/reviewboard.
Release files for RBTools 7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rbtools-7.0.tar.gz | 823.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rbtools-7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / rbtools-7.0.tar.gz
| Download URL | rbtools-7.0.tar.gz |
|---|---|
| Size | 823.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2e02491f07181a0a1d8faf2bf9f8c7e89eb73fe5ec59a0f7859e1e0bfb4cbf33
|
|
BLAKE2b-256 checksum How to use checksums |
5bfc51d1604226036ed182ede25e5cc84d1bb9f583d15b88315108bbbcafb23f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.6
|
Release files / rbtools-7.0-py3-none-any.whl
| Download URL | rbtools-7.0-py3-none-any.whl |
|---|---|
| Size | 777.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c4342e257c97adb3502124188944509903bc74b1ded38ca0e910081695234cd7
|
|
BLAKE2b-256 checksum How to use checksums |
b2c7dde14774f918f701ac2dfd3311f2d6200d898155691375f359d37ce74d2b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.6
|
