To make it easier for both the contributors and the reviewers to manage the contributions, the Kafka project also ships a (python based) script which automates the steps that are involved in the context of a patch submission. These steps involve:
- Creating a patch/diff between the local git repo against the project remote repo
- Creating a review task in Review Board and publish the patch/diff that was generated for the changes
- Updating the JIRA, related to these changes, with a comment about a patch being made available and ready for review at Review Board
As you'll notice this requires (automated) integration between JIRA and Review Board. The (python based) script, which is named kafka-patch-review.py (and present in the checked out code of Kafka project), acts as a wrapper around the scripts/tools that are shipped by JIRA and Review Board for such integrations. Since the kafka-patch-review.py is merely a wrapper around those tools, you'll have to install those tools locally to be able to use the kafka-patch-review.py script. This document helps you in setting up those tools as well as helping you understand the usage of the kafka-patch-review.py itself.
Kafka patch review tool
The following sections will help you install and setup the necessary tools which this wrapper script uses for patch submission.
...