backend: まともに CLI 引数を渡せるようにする Go の flag パッケージは普通の `-a`/`--a-long` 形式をサポートせずに `-a-long` で全部ポインタのため。楽だが、成果物の UX が悪くなるという アンチパターン。 Go の標準ライブラリ割とだめじゃね...?

Changes

3 changed files (+14/-17)

• packages/backend/go.mod
  • @@ -13,6 +13,7 @@ google.golang.org/protobuf v1.36.5
    ) require ( + github.com/alecthomas/kong v1.10.0 // indirect github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc // indirect github.com/charmbracelet/lipgloss v1.1.0 // indirect
• packages/backend/go.sum
  • @@ -1,5 +1,7 @@
    connectrpc.com/connect v1.18.1 h1:PAg7CjSAGvscaf6YZKUefjoih5Z/qYkyaTrBW8xvYPw= connectrpc.com/connect v1.18.1/go.mod h1:0292hj1rnx8oFrStN7cB4jjVBeqs+Yx5yDIC2prWDO8= + github.com/alecthomas/kong v1.10.0 h1:8K4rGDpT7Iu+jEXCIJUeKqvpwZHbsFRoebLbnzlmrpw= + github.com/alecthomas/kong v1.10.0/go.mod h1:p2vqieVMeTAnaC83txKtXe8FLke2X07aruPWXyMPQrU= github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k= github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8= github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
• packages/backend/server/main.go
  • @@ -8,12 +8,12 @@
    import ( "database/sql" _ "embed" - "flag" "log/slog" "net/http" "os" "strings" + "github.com/alecthomas/kong" "github.com/charmbracelet/lipgloss" charmlog "github.com/charmbracelet/log" "golang.org/x/net/http2"
  • @@ -22,18 +22,6 @@ "pocka.jp/x/yamori/backend/core"
    "pocka.jp/x/yamori/backend/services" _ "modernc.org/sqlite" - ) - - var adminCreationPassword = flag.String( - "admin-creation-password", "", "Password for creating a user when there is no admin user in workspace", - ) - - var verbose = flag.Bool( - "verbose", false, "Whether output debug logs", - ) - - var jsonlLogger = flag.Bool( - "jsonl", false, "Whether output logs in JSONL format", ) // charmbracelet/log のデフォルトスタイルは見づらく 256 bit 色を利用しているため
  • @@ -80,17 +68,23 @@
    return slog.New(logger) } + var cli struct { + AdminCreationPassword string `help:"Password for creating a user when there is no admin user in workspace"` + Verbose bool `help:"Display debug logs?"` + Log string `help:"Log format." enum:"text,jsonl" default:"text"` + } + // TODO: エラーコードを定義する func main() { - flag.Parse() + kong.Parse(&cli) logLevel := slog.LevelInfo - if verbose != nil && *verbose { + if cli.Verbose { logLevel = slog.LevelDebug } var logger *slog.Logger - if jsonlLogger != nil && *jsonlLogger { + if cli.Log == "jsonl" { logger = slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{ Level: logLevel, }))
  • @@ -113,7 +107,7 @@ logger.Error("Failed to create core instance", "error", err)
    os.Exit(3) } - if err := core.Init(*adminCreationPassword); err != nil { + if err := core.Init(cli.AdminCreationPassword); err != nil { logger.Error("Failed to prepare application core", "error", err) os.Exit(4) }