ReviewBoard代码评审实践总结

Stella981
• 阅读 961

代码评审

代码评审(CodeReview),顾名思义是对代码进行评审,是软件工程的活动之一。

通过代码评审可以保证代码质量,促进团队知识共享……好处多多。

版本控制与代码评审

软件工程的各个活动总是离不开工具的支持。

代码评审工具首先必须和版本控制工具相结合的。

现在主流的两种版本控制工具:SVN和GIT。

GIT有个Google开发的代码评审工具Gerrit,可以在提交前进行代码评审,评审通过之后才允许提交到版本库。

其次,代码托管平台GitLab(号称是GitHub的开源实现)也可以用来进行代码评审(把代码fork过去,用pull request的方式实现代码评审)。

如果版本控制工具是GIT,当然优先选择用Gerrit或者GitLab来尝试做代码评审了。

但是如果版本控制工具是SVN呢?这目前还没有发现很好的解决方案。

所以问题来了,在技术选型上,该选择什么工具来进行代码评审呢?

代码评审工具选型

关于代码评审,有很多支持工具,可以查看:  简单实用的Code Review工具

开源的代码评审工具有:  ReviewBoard、  Facebook Phabricator、  Codestriker、  Groogle、  Rietveld、  JCR(Java Code Reviewer)、  Jupiter、  ReviewClipse

商业版的代码评审工具有:  Atlassian Crucible、  Jetbrains Upsource

曾了解过上述大多数工具的使用,曾试过Crucible、Jupiter、ReviewBoard,最终综合考量(如:流行度、易用度、文档完善度)选择了ReviewBoard。

ReviewBoard简介

ReviewBoard是个开源的、可扩展的、友好的基于Web的代码评审工具,是用Python框架Django开发的。

ReviewBoard的官方网站:https://www.reviewboard.org,其title为:  Take the pain out of code review | Review Board

Take the pain out of code review 可以翻译为:从代码评审的痛苦中解脱出来

ReviewBoard的源码托管在GitHub上:  https://github.com/reviewboard/reviewboard

ReviewBoard的源码也是通过ReviewBoard来进行评审的:  https://reviews.reviewboard.org/

ReviewBoard的DEMO:  http://demo.reviewboard.org/,可以通过DEMO简单体验下ReviewBoard的基本使用

ReviewBoard官方指南介绍

要了解ReviewBoard,最好的方式莫过于阅读官方指南:  https://www.reviewboard.org/docs/,ReviewBoard的官方指南有:

User Guide(用户指南), Administration Guide(管理员指南),Web API Guide(Web API指南),Extending Review Board(扩展ReviewBoard)和 Frequently Asked Questions(常见问答FAQ)。

用户指南的提纲:开始(包括代码评审的介绍、一般工作流、账户设置)、使用评审请求(评审请求的创建、修改、发布、关闭等)、评审、搜索、使用MarkDown。

管理员指南的提纲:安装、升级、优化、管理员UI、配置、扩展和站点管理。

Web API是RESTful架构,使得ReviewBoard可以用各种编程语言来集成。

ReviewBoard安装及创建站点

ReviewBoard的安装在互联网上有很多博文分享,笔者的建议是  以官方指南为准,同时可以参考互联网上的博文分享

例如,2.0版本在linux下安装指南:  https://www.reviewboard.org/docs/manual/2.0/admin/installation/linux/

在安装完之后,是创建ReviewBoard站点:  https://www.reviewboard.org/docs/manual/2.0/admin/installation/creating-sites/

可以创建多个ReviewBoard站点

笔者安装过程中曾出现的问题及解决方式如下:

python连接mysql时 出现DeprecationWarning: the sets module is deprecated 警告

SVN出现“error while loading shared libraries”错误

AttributeError: 'module' object has no attribute 'HAVE_DECL_MPZ_POWM_SEC'

Reviewboard时区问题

使用ReviewBoard进行代码评审

代码评审(CodeReview)一般有两种形式:pre-commit-review,post-commit-review。  
pre-commit-review是指代码提交到代码库前进行代码评审;  
post-commit-review是指代码提交到代码库后进行代码评审。

ReviewBoard同时支持以上两种形式,代码的评审主要通过ReviewRequest(评审请求)来进行的。

其中pre-commit-review的工作流为:

  • 在代码修改后,提交人创建代码评审请求

  • 相应的评审人通过评审请求对代码进行评审,如果评审不通过,提交人可以更新该评审请求

  • 评审通过之后,提交人将代码提交至版比库

当然,笔者始终认为代码评审的最好方式是提交前评审,这样能够很好的保证提交到版本库的代码都是经过评审的。

使用ReviewBoard客户端或Eclipse插件

在Web界面创建/更新评审请求的过程是比较繁琐的,好在有相应的工具简化了这个过程:

RBtools是ReviewBoard官方提供的命令行客户端,可以使用命令行进行评审请求的相关操作;

eReviewBoard是ReviewBoard的Eclipse插件;

TaoReviewBoard是淘宝开发的ReviewBoard的Eclipse插件。

笔者根据使用经历,整理出如下eReviewBoard和TaoReviewBoard功能对比表格:

功能

Tao-ReviewBoard(开源版)

eReviewBoard

pre-commit-review

post-commit-review

×

版本控制工具

目前只支持SVN

支持SVN、CVS、GIT

创建代码评审请求

更新代码评审请求

diff展示(比较编辑器中)

×

关闭或重新打开评审请求

×

创建或更新评审请求是否方便

可以在多处右击
可以跨Project
可以直接选择文件来创建评审请求      

(方便)

只支持在Project上右击
不能跨Project
先列出变更文件再从中选取文件来创建评审请求

(不方便)

安装过程

安装方便
jar包放到plugins/dropins目录即可

基于Mylvy和SCM Eclipse Plugin(Subclipse/Egit/CVS)
安装时如果需要联网下载相关依赖,较耗时
安装参考: eReviewBoard简要介绍及安装

SVN与ReviewBoard集成,实现post-commit-review

曾经尝试过用pre-commit-review进行代码评审,在实施或推广之时,遇到如下问题:

代码提交人在评审请求通过之后还需要再提交代码至版本库,同时无法确保被评审的代码和提交的代码的一致性

没有实现在代码评审请求评审通过后自动提交代码(以提交人的账号)至版本库(如同Gerrit那样)

总之,还没有类似Gerrit那样的成熟方案

所以,选择了post-commit-review,关于post-commit-review,可以参考如下文档:

svn post-commit脚本样例:  reviewboard源码中用户贡献的样例

rbt post 命令官方指南

svn集成ReviewBoard,让post-commit hook后台运行

最后,欢迎吐槽!

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
待兔 待兔
4个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Easter79 Easter79
3年前
svn集成ReviewBoard,让post
代码评审(CodeReview)不但可以提高质量,而且还是一个知识共享和指导的极好的手段。代码评审(CodeReview)一般有两种形式:precommitreview,postcommitreview。precommitreview是指代码提交到代码库前进行代码评审;postcommitreview是指代码提交到代码库
Jacquelyn38 Jacquelyn38
3年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
京东云开发者|代码评审的价值和规范
评审目的代码评审的目的就是为了保证公司整体代码的健康状况随着不断迭代,始终保持一个较高的水平,所有在评审中使用的工具和流程都应是为此目的而设计的。评审原则鼓励质疑保持代码风格,遵守开发规范
Python进阶者 Python进阶者
10个月前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这
京东云开发者 京东云开发者
4个月前
Code Review:提升代码质量与团队能力的利器
1.引言CodeReview(下文简称CR),即代码审查,是一种通过评审代码以发现并修正错误的实践。它不是一个新概念,但在软件开发中,它的重要性毋庸置疑。首先,它可以显著降低软件中的缺陷比例;其次,它促进了知识共享,通过评审的过程,团队成员可以相互学习,增
京东云开发者 京东云开发者
1个月前
Code Review:探索工程实践之道
作者:京东物流冯志文前言本文参考《京东JAVA代码规范V1.1》\&Google代码评审工程实践方法论,结合团队代码评审的实践经验整理成文档,这份文档是我们团队集体经验的结晶。我相信公司其他部门也有类似的经验和最佳实践。希望通过互相交流和学习,共同提高代码