怎么進行圖數(shù)據(jù)庫 Nebula Graph 的代碼變更測試覆蓋率實踐

這期內(nèi)容當中小編將會給大家?guī)碛嘘P怎么進行圖數(shù)據(jù)庫 Nebula Graph 的代碼變更測試覆蓋率實踐，文章內(nèi)容豐富且以專業(yè)的角度為大家分析和敘述，閱讀完這篇文章希望大家可以有所收獲。

對于一個持續(xù)開發(fā)的大型工程而言，足夠的測試是保證軟件行為符合預期的有效手段，而不是僅僅依靠 code review 或者開發(fā)者自己的技術素質(zhì)。測試的編寫理想情況下應該完全定義軟件的行為，但是通常情況都是很難達到這樣理想的程度。而測試覆蓋率就是檢驗測試覆蓋軟件行為的情況，通過檢查測試覆蓋情況可以幫助開發(fā)人員發(fā)現(xiàn)沒有被覆蓋到的代碼。

測試覆蓋信息搜集

Nebula Graph 主要是由 C++ 語言開發(fā)的，支持大部分 Linux 環(huán)境以及 gcc/clang 編譯器，所以通過工具鏈提供的支持，我們可以非常方便地統(tǒng)計Nebula Graph的測試覆蓋率。

gcc/clang 都支持 gcov 式的測試覆蓋率功能，使用起來也是非常簡單的，主要有如下幾個步驟：

1. 添加編譯選項 --coverage -O0 -g 

2. 添加鏈接選項 --coverage 

3. 運行測試

4. 使用 lcov，整合報告，例如 lcov --capture --directory . --output-file coverage.info 

5. 去掉外部代碼統(tǒng)計，例如 lcov --remove coverage.info '*/opt/vesoft/*' -o clean.info 

到這里測試覆蓋信息已經(jīng)搜集完畢，接下可以通過 genhtml 這樣的工具生成 html，然后通過瀏覽器查看測試覆蓋率，如下圖所示：

但是這樣是非常不方便的，因為在持續(xù)的開發(fā)過程，如果每次都要手動進行這樣一套操作，那必然帶來極大的人力浪費，所以現(xiàn)在的常用做法是將測試覆蓋率寫入 CI 并且和第三方平臺（比如  Codecov， Coveralls）集成，這樣開發(fā)人員完全不必關心測試覆蓋信息的收集整理和展示問題，只需要發(fā)布代碼后直接到第三方平臺上查看覆蓋情況即可，而且現(xiàn)在的第三方平臺也支持直接在 PR 上評論覆蓋情況使得查看覆蓋率的變更情況更加方便。

集成 CI Github Action

現(xiàn)在主流的 CI 平臺非常多，比如  Travis， azure-pipelines 以及  GitHub Action 等。Nebula Graph 選用的是 GitHub Action，對于 Action 我們在之前的 《使用 Github Action 進行前端自動化發(fā)布》這篇文章里已經(jīng)做過介紹。

而 GitHub Action 相對于其他 CI 平臺來說，有和 GitHub 集成更好，Action 生態(tài)強大簡潔易用以及支持相當多的操作系統(tǒng)和 CPU 等優(yōu)勢。Nebula Graph 有關測試覆蓋的 CI 腳本片段如下所示：

- name: CMake with Coverage  if: matrix.compiler == 'gcc-9.2' && matrix.os == 'centos7'
  run: |
    cmake -DENABLE_COVERAGE=ON -B build/

可以看到這里我們將前文介紹的 coverage 相關的編譯選項通過一個 cmake option 進行管理，這樣可以非常方便地啟用和禁止 coverage 信息的收集。比如在開發(fā)人員在正常的開發(fā)編譯測試過程中通常不會開啟這項功能以避免編譯測試運行的額外開銷。

- name: Testing Coverage Report
  working-directory: build  if: success() && matrix.compiler == 'gcc-9.2' && matrix.os == 'centos7'
  run: |    set -e
    /usr/local/bin/lcov --version
    /usr/local/bin/lcov --capture --gcov-tool $GCOV --directory . --output-file coverage.info
    /usr/local/bin/lcov --remove coverage.info '*/opt/vesoft/*' -o clean.info
    bash <(curl -s https://codecov.io/bash) -Z -f clean.info

這里主要是測試報告的收集、合并以及上傳到第三方平臺，這個在前文中已經(jīng)比較詳細地敘述過，CI 的運行情況如下圖所示：

集成測試覆蓋率平臺 Codecov

Nebula Graph 選擇的測試覆蓋平臺是 Codecov——一個測試結(jié)果分析工具，對于 GitHub Action 而言，主要是在 CI 中執(zhí)行上述的測試覆蓋信息搜集腳本以及將最終的測試覆蓋文件上傳到 Codecov平臺。

這里用戶給自己的 repo 注冊 Codecov 后可以獲取一個訪問的 token，通過這個 token 和 Codecov 的 API 可以將測試覆蓋文件上傳到 Codecov 這個平臺上，具體的 API 可以參考  https://docs.codecov.io/reference#upload ，除了上傳報告外還有列出 pr，commit 等 API 可以讓用戶開發(fā)自己的 bot 做一些自動化的工具，然后就可查看各種測試覆蓋的信息，比如 Nebula Graph 的測試覆蓋情況可以查看  https://codecov.io/gh/vesoft-inc/nebula 。

比如可以通過這個餅狀圖查看不同目錄代碼的覆蓋情況：

也可以點開一個具體的文件，查看哪些行被覆蓋那些行沒有被覆蓋：

當然我們一般不會直接使用 Codecov 的 API，而是使用他提供的一個 cli 工具，比如上傳報告使用 bash <(curl -s https://codecov.io/bash) -Z -t <token> -f clean.info ，這里的 token 就是 Codecov 提供的認證 token，一般來說作為環(huán)境變量 CODECOV_TOKEN 使用，而不是輸入明文。

通過上述操作呢就可以在 Codecov 平臺上查看你的工程的測試覆蓋情況，并且可以看到每次 pr 增加減少了多少覆蓋率，方便逐漸提高測試覆蓋率。最后的話還可以在你的 README 上貼上 Codecov 提供的測試覆蓋率 badge，就像 Nebula Graph 一樣： https://github.com/vesoft-inc/nebula。

本文中如有錯誤或疏漏歡迎去 GitHub： https://github.com/vesoft-inc/nebula issue 區(qū)向我們提 issue 或者前往官方論壇： https://discuss.nebula-graph.com.cn/ 的 建議反饋 分類下提建議 ????；加入 Nebula Graph 交流群，請聯(lián)系 Nebula Graph 官方小助手微信號： NebulaGraphbot

推薦閱讀

• 應用 AddressSanitizer 發(fā)現(xiàn)程序內(nèi)存錯誤

• Github Statistics 一個基于 React 的 GitHub 數(shù)據(jù)統(tǒng)計工具

作者有話說：Hi，我是 shylock，是 Nebula Graph 的研發(fā)工程師，希望本文對你有所幫助，如果有錯誤或不足也請與我交流，不甚感激！

聲明：本文采用 CC BY-NC-ND 4.0 協(xié)議進行授權 署名-非商業(yè)性使用-禁止演繹 4.0 國際

上述就是小編為大家分享的怎么進行圖數(shù)據(jù)庫 Nebula Graph 的代碼變更測試覆蓋率實踐了，如果剛好有類似的疑惑，不妨參照上述分析進行理解。如果想知道更多相關知識，歡迎關注億速云行業(yè)資訊頻道。