Go

在 Dockerfile 裡 build golang 程式總是要花個幾分鐘，雖然不多，但是反覆的測試跟修改程式下，往往也花掉了不少時間。 目前使用的 Dockerfile 大概如下，在舊筆電 build 一次大概要 2 分鐘多 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 FROM golang:1.24-alpine AS builder ARG VERSION=v0.0.0 ARG COMMIT=unknown WORKDIR /src ADD . /src RUN CGO_ENABLED=0 go build \ -ldflags "-X github.com/nyorc/go-ver.Version=${VERSION} \ -X github.com/nyorc/go-ver.BuildTime=$(date +%Y/%m/%dT%H:%M:%S) \ -X github.com/nyorc/go-ver.Commit=${COMMIT}" \ -o app FROM alpine:latest COPY --from=builder /src/app /bin/app ENTRYPOINT [ "/bin/app" ] 筆電環境 ...

現在寫程式常常都會有大量的 API 溝通，現實世界常會遇到像是網路不穩定等等的情況，這時有再試策略 (retry strategy) 就很重要了。 retry-go 是一個可以讓我們自定再試策略 (retry strategy) 的套件。 ...

gomock 原本是 golang 官方維護的套件，不過因為有一段時間沒有在維護了，在 2023 年 6 月時就改由 uber 團隊接手維護了。 停止維護: https://github.com/golang/mock 目前有在維護: https://github.com/uber-go/mock 安裝工具 安裝 mockgen 工具，gomock 套件 ...

Cobra 是一個很方便 cli 函式庫，有許多的 project 都是用他來寫 cli 應用程式，我自己也是很常使用的。 不同於 kubectl, hugo 這類的專案，自己寫的 cli 應用程式，常常會混著主要的應用場景指令、工具型指令或是更臨時的暫時性工具指令。當指令一多時，不免會覺得檔案過多過亂。 ...

go 的測試工具 go test 有 benchmark 工具可以使用。 不用自己寫工具就可以很輕鬆的測試程式碼效能。 開始寫 benchmark 測試 建立 _test.go 結尾的檔案 function 要以 Benchmark 開頭 使用 b *testing.B 參數 將要測試的程式放到 b.N 的 for 迴圈內 範例如下: ...

這裡有一段程式，執行時加上 -v 的參數就可以秀出程式的版號 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package main import ( "flag" "fmt" ) const Version = "v0.1.0" func main() { var flagVersion bool flag.BoolVar(&flagVersion, "v", false, "version") flag.Parse() switch { case flagVersion: fmt.Println("Version:", Version) default: fmt.Println("Hello world") } } 編譯程式 ...

想要用 go 開發一個 web service 很簡單，網路上有一大堆的範例， 但是通常你不太可能直接拿著範例就上戰場打仗。要應用在現實中的場景，通常還需要加一些程式。 這裡我以開發 web service 為例，整理一下目前我會在 main.go 寫什麼 ...

1.18 都 release 才想要看看怎麼把 go version 改到 1.17 修改 go.mod 使用 go mod edit 修改 go.mod 檔案的 go version 1 $ go mod edit -go=1.17 go 1.17 的 go mod tidy 增加了 -go 參數，可以直接修改 go.mod 檔案中的 go version 1 $ go mod tidy -go=1.17 升級依賴套件 升級依賴套件 + 更新 go.mod ...

在 2022-03-22 這天 Go 正式發佈 1.18 版了！ 這個版本其中一大特色就是增加了社群討論許久的泛型(Generics) 今天來玩看看 go 的泛型函數(Generics Function) 沒有泛型 我們來寫一個尋找 slice 資料索引的 function ...

使用 brew 安裝 go 可以很容易在不同的版本中切換。 Brew 目前我工作環境安裝的 brew 版本是 3.4.1，只要使用 link/unlink 指令就可以切換。 1 2 3 4 $ brew -v Homebrew 3.4.1-52-gf0f1eb6 Homebrew/homebrew-core (git revision 0192df1b390; last commit 2022-03-14) Homebrew/homebrew-cask (git revision 96b4f7dabd; last commit 2022-03-14) 安裝 go 安裝 go 最新版 (1.17) 跟 go 1.16 版 ...

Graceful shutdown 直接翻譯是 「優雅的關機」 這種做法是在收到程式終止的指令時，先處理好執行中的動作才結束程式。 使用這個機制可以正確的關閉連線，完成處理到一半的任務。能夠保障工作跟資料的完整性，避免突然的中止程式造成一些奇怪的問題。 ...

Interface Go 的 interface (介面) 是一堆方法簽章集合而成的 type (型態)， 只要一個 type 實作出 interface 定義的所有方法，就是實作 interface interface 是 Go 用來定義物件行為的方式，其概念是： 如果某個物件可以做「這件事」，那麼它就可以用來當成是「這種東西」。 ...

ORM (Object Relational Mapping) ORM 是一種把 資料庫 對應到 程式物件 的技術，可以讓開發者更快速的開發處理資料庫的程式 使用上常見優點： 快速開發 較高的安全性 也是有相對的缺點： 犧牲效能 額外的學習成本 難以處理複雜查詢 這次看在優點上，小試了一下 Go 裡面的 ORM 工具 ...

go 1.14 開始，go modules 可以在正式環境上使用了 你可能會建立自己私人的工具庫，這時要搭配 go modules 就需要做一些設定 基本的設定 假設現在要建立一個私有 module 倉庫，放在 gitlab.com/nyorc/module 1 2 mkdir module cd module 啟用 go module ...

Functional Programming 中文：函數式程式設計，是程式設計方法 (programming paradigm) 的其中一種 所謂的 Functional Programming 是以數學函數的概念來設計程式，並避免有狀態 (state) 與避免可變資料 (mutable data) 以下是一些 Functional Programming 的特點 ...

github.com/uber-go/zap, zap 是目前我比較常用的 logger package 在寫 log file 時，通常需要定期的封存檔案，避免單一檔案過大而導致之後難以整理 zap 本身沒有 rotation 功能，要自己寫，或是用 lumberjack 這個 package zap 官方的 FAQ 中 zap/FAQ.md ...

Go 原生的 Error Type 先認識 go 的 error interface 1 2 3 type error interface { Error() string } 只要 struct 實作 Error() 方法，就會是 error type，例如 os package 裡面的 PathError https://golang.org/pkg/os/#PathError 1 2 3 4 5 6 7 8 // PathError records an error and the operation and file path that caused it. type PathError struct { Op string Path string Err error } func (e *PathError) Error() string { return e.Op + " " + e.Path + ": " + e.Err.Error() } 建立自己程式裡的 Error struct 依照使用情境 error strcut ...

什麼是 gRPC Google 推出的 RPC framework 採用 Google 制定的 protocol buffers 當作資料傳輸格式 有 proto 工具可以把你寫好的 proto file 直接生成程式碼 比 RESTful API 更快、更有效率 更多請參考官網: grpc / grpc.io 安裝 開始寫 gRPC 服務之前，要先安裝一些 protocol buffer 的工具 ...

想要跑當前專案下的所有 test 1 $ go test ./... Reference How to go test all testings in my project? - Stack Overflow

Hugo 是用 Go 開發的靜態網站產生器 我為了把 blog 文章改放到 Github Page 上，一開始是想到 Jekyll 這個超熱門的工具 稍微研究一下後，發現是用 Ruby 寫的，讓我不太想用 最後是發現了 Hugo，評估過上手難易度後，決定就用他來試試了 ...