DTM开发测试指南

本文是为了给dtm做贡献的开发者准备的,或者是给准备调试dtm的开发者准备,普通开发者如果只是为了接入dtm,则不需要关注本文内容。

基础环境

dtm项目需要将数据存储在mysql|redis|postgres,因此需要准备好相关的服务器。

推荐采用docker-compose的方式准备环境,您可以安装docker20.04以上版本,然后在dtm项目路径下,执行 docker-compose -f helper/compose.store.yml up -d

添加测试用例

这步为可选,虽然这步为可选,但是对于bug或者新功能,强烈建议您添加测试用例,以便未来的每一个修改,都不会重新引入您已解决的问题

您可以参考现有的测试用例,在合适的位置添加您的新用例。现有的用例是比较全面的,各种正常/异常情况,都有覆盖,整个测试覆盖率能够达到95%

修改问题

如果您已经添加了测试用例,那么先确认测试用例在您修改前是失败的

您针对问题进行相关的代码修改,尽量做到代码简单清晰,让其他人容易读懂,逻辑复杂/奇怪的地方加上注释

修改后的测试

您完成相关问题的修改后,您可以通过go test运行相关的测试用例,确认已解决相关问题,然后再运行全部测试用例,保证您的新代码,没有引入新的问题

dtm没有测试人员,他的稳定性主要是靠自动化的测试保证的。我们在测试覆盖率上面要求很高,1.0版本后,都要求覆盖率在95%+

注意!!! 您完成修改后,请确保下面命令显示所有的测试用例已通过

make -f helper/Makefile

如果您的修改,涉及存储引擎部分,那么您需要设定环境变量,覆盖特定引擎下的测试用例

  1. go test ./... # 默认情况下,使用redis引擎
  2. TEST_STORE=redis go test ./... # 测试redis引擎
  3. TEST_STORE=boltdb go test ./... # 测试boltdb引擎
  4. TEST_STORE=mysql go test ./... # 测试mysql引擎
  5. TEST_STORE=postgres go test ./... # 测试postgres引擎

发起PR

您的修改完成后,按照流程发起PR,然后关注下面的内容

  • 您的PR是否通过了dtm的所有集成测试
  • 如果您新增代码,请关注您的代码测试覆盖率

对于通过上述两条内容的PR,dtm的人员将会尽快给您反馈,如果无大的问题,将合并您的PR

管理后台

dtm 从1.14.0开始,添加了管理后台的功能,该管理后台采用的技术栈包括:

  • vue3
  • ant-design-vue
  • typescript
  • pinia
  • vite

如果您修改的是管理后台功能,那么您按照前面的说明,启动了dtm服务器之后,进入admin目录,运行以下命令:

  1. yarn dev

然后访问localhost:6789即可