擼了一個可調(diào)試 gRPC 的 GUI客戶端
本文轉(zhuǎn)載自微信公眾號「crossoverJie」，作者crossoverJie 。轉(zhuǎn)載本文請聯(lián)系crossoverJie公眾號。
前言
平時大家寫完 gRPC 接口后是如何測試的?往往有以下幾個方法：
寫單測代碼，自己模擬客戶端測試。
可以搭一個 gRPC-Gateway 服務(wù)，這樣就可以在 postman 中進行模擬。
但這兩種方法都不是特別優(yōu)雅;第一種方法當(dāng)請求結(jié)構(gòu)體嵌套特別復(fù)雜時，在代碼中維護起來就不是很直觀;而且代碼會特別長。
第二種方法在 postman 中與請求 HTTP 接口一樣，看起來非常直觀;但需要額為維護一個 gRPC-Gateway 服務(wù)，同時接口定義發(fā)生變化時也得重新發(fā)布，使用起來稍顯復(fù)雜。
于是我經(jīng)過一番搜索找到了兩個看起來還不錯的工具：
- BloomRPC
- https://github.com/fullstorydev/grpcui
首先看 BloomRPC 頁面美觀，功能也很完善;但卻有個非常難受的地方，那就是不支持 int64 數(shù)據(jù)的請求, 會有精度問題。
這里我寫了一個簡單的接口，直接將請求的 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
- }
會發(fā)現(xiàn)服務(wù)端收到的數(shù)據(jù)精度已經(jīng)丟失了。
這個在我們大量使用 int64 的業(yè)務(wù)中非常難受，大部分接口都沒法用了。
grpcui 是我在使用了 BloomRPC 一段時間之后才發(fā)現(xiàn)的工具，功能也比較完善; BloomRPC 中的精度問題也不存在。
但由于我之前已經(jīng)習(xí)慣了在 BloomRPC 中去調(diào)試接口，加上日常開發(fā)過程中我的瀏覽器幾乎都是開了幾十個 tap 頁面，導(dǎo)致在其中找到 grpcui 不是那么方便。
所以我就想著能不能有一個類似于 BloomRPC 的獨立 APP，也支持 int64 的工具。
準(zhǔn)備
找了一圈，貌似沒有發(fā)現(xiàn)。恰好前段時間寫了一個 gRPC 的壓測工具，其實已經(jīng)把該 APP 需要的核心功能也就是泛化調(diào)用實現(xiàn)了。
由于核心能力是用 Go 實現(xiàn)的，所以這個 APP 最好也是用 Go 來寫，這樣復(fù)用代碼會更方便一些;正好也想看看用 Go 來實現(xiàn) GUI 應(yīng)用效果如何。
但可惜 Go 并沒有提供原生的 GUI 庫支持，最后翻來找去發(fā)現(xiàn)了一個庫：fyne
從 star 上看用的比較多，同時也支持跨平臺打包;所以最終就決定使用該庫在構(gòu)建這個應(yīng)用。
核心功能
整個 App 的交互流程我參考了 BloomRPC ，但作為一個不懂審美、設(shè)計的后端開發(fā)來說，整個過程中最難的就是布局了。
這是我花了好幾個晚上調(diào)試出來的第一版頁面，雖然也能用但查看請求和響應(yīng)數(shù)據(jù)非常不方便。
于是又花了一個周末最終版如下(乍一看貌似沒區(qū)別)：
雖然頁面上與 BloomRPC 還有一定差距，但也不影響使用;關(guān)鍵是 int64 的問題解決了;又可以愉快的擼碼了。
安裝
有類似需求也想體驗的朋友可以在這里下載使用：https://github.com/crossoverJie/ptg/releases/download/0.0.2/ptg-mac-gui.tar
由于我手上暫時沒有 Windows 電腦，所以就沒有打包 exe 程序;有相關(guān)需求的朋友可以自行下載源碼編譯：
- git clone git@github.com:crossoverJie/ptg.git
- cd ptg
- make pkg-win
后續(xù)計劃
當(dāng)前版本的功能還比較簡陋，只支持常用的 unary 調(diào)用;后續(xù)也會逐步加上 stream、metadata、工作空間的存儲與還原等支持。
對頁面、交互有建議也歡迎提出。
原本是準(zhǔn)備上傳到 brew 方便安裝的，結(jié)果折騰了一晚上因為數(shù)據(jù)不夠被拒了，所以對大家有幫助或者感興趣的話幫忙點點關(guān)注(咋有種直播帶貨的感覺??)
源碼地址：https://github.com/crossoverJie/ptg
