擼了一個可調試 gRPC 的 GUI 客戶端 前言 核心功能 後續計劃

前言

平時大家寫完 gRPC 接口後是如何測試的?往往有以下幾個方法:

  1. 寫單測代碼,自己模擬客戶端測試。


  2. 可以搭一個 gRPC-Gateway 服務,這樣就可以在 postman 中進行模擬。

但這兩種方法都不是特別優雅;第一種方法當請求結構體嵌套特別複雜時,在代碼中維護起來就不是很直觀;而且代碼會特別長。

第二種方法在 postman 中與請求 HTTP 接口一樣,看起來非常直觀;但需要額爲維護一個 gRPC-Gateway 服務,同時接口定義發生變化時也得重新發布,使用起來稍顯複雜。

於是我經過一番搜索找到了兩個看起來還不錯的工具:

首先看 BloomRPC 頁面美觀,功能也很完善;但卻有個非常難受的地方,那就是不支持 int64 數據的請求, 會有精度問題。

這裏我寫了一個簡單的接口,直接將請求的 int64 返回回來。

func (o *Order) Create(ctx context.Context, in *v1.OrderApiCreate) (*v1.Order, error) {
    fmt.Println(in.OrderId)
    return &v1.Order{
        OrderId: in.OrderId,
        Reason:  nil,
    }, nil
}

會發現服務端收到的數據精度已經丟失了。

這個在我們大量使用 int64 的業務中非常難受,大部分接口都沒法用了。



grpcui 是我在使用了 BloomRPC 一段時間之後才發現的工具,功能也比較完善; BloomRPC 中的精度問題也不存在。

但由於我之前已經習慣了在 BloomRPC 中去調試接口,加上日常開發過程中我的瀏覽器幾乎都是開了幾十個 tap 頁面,導致在其中找到 grpcui 不是那麼方便。

所以我就想着能不能有一個類似於 BloomRPC 的獨立 APP,也支持 int64 的工具。


準備

找了一圈,貌似沒有發現。恰好前段時間寫了一個 gRPC 的壓測工具,其實已經把該 APP 需要的核心功能也就是泛化調用實現了。

由於核心能力是用 Go 實現的,所以這個 APP 最好也是用 Go 來寫,這樣複用代碼會更方便一些;正好也想看看用 Go 來實現 GUI 應用效果如何。

但可惜 Go 並沒有提供原生的 GUI 庫支持,最後翻來找去發現了一個庫:fyne

star 上看用的比較多,同時也支持跨平臺打包;所以最終就決定使用該庫在構建這個應用。

核心功能

整個 App 的交互流程我參考了 BloomRPC ,但作爲一個不懂審美、設計的後端開發來說,整個過程中最難的就是佈局了。

這是我花了好幾個晚上調試出來的第一版頁面,雖然也能用但查看請求和響應數據非常不方便。

於是又花了一個週末最終版如下(乍一看貌似沒區別):

雖然頁面上與 BloomRPC 還有一定差距,但也不影響使用;關鍵是 int64 的問題解決了;又可以愉快的擼碼了。

安裝

有類似需求也想體驗的朋友可以在這裏下載使用:
https://github.com/crossoverJie/ptg/releases/download/0.0.2/ptg-mac-gui.tar

由於我手上暫時沒有 Windows 電腦,所以就沒有打包 exe 程序;有相關需求的朋友可以自行下載源碼編譯:

git clone [email protected]:crossoverJie/ptg.git
cd ptg
make pkg-win

後續計劃

當前版本的功能還比較簡陋,只支持常用的 unary 調用;後續也會逐步加上 streammetadata、工作空間的存儲與還原等支持。

對頁面、交互有建議也歡迎提出。

原本是準備上傳到 brew 方便安裝的,結果折騰了一晚上因爲數據不夠被拒了,所以對大家有幫助或者感興趣的話幫忙點點關注(咋有種直播帶貨的感覺🐶)

源碼地址:https://github.com/crossoverJie/ptg

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章