Go でアプリケーションを開発していると、毎回同じようなパッケージ構造・ファイル名・初期実装を書くことに疲れてきませんか？
Rails には rails generate scaffold という便利なコマンドがあります。これがあるおかげで、開発者は構造を気にせず「まずは作る」ことに集中できます。
そんな体験を Go にも持ち込めないか？
そう思って作ったのが、CLI ツール gon です。
✪ gon ってなに？
gon は、Rails のように 1 コマンドで model、use-case、handler を生成できる、意見の強い Go 向けの scaffold ツールです。
gon g scaffold User name:string email:string
これを叩くだけで、以下のような構造が生成されます：
internal/
└── domain/
└── user/
├── model/
├── repository/
├── usecase/
├── handler/
└── fixture/
クリーンアーキテクチャに基づいた構成で、ディレクトリごとにパッケージも分けています。
✨ gon の特徴
- Rails ライクなコマンドで爆速開発
- model, usecase, や handler を一度に生成
- クリーンアーキテクチャ準拠のディレクトリ構成
- テストコードや fixture も自動で生成
- テンプレートは
embedベースでカスタマイズ可能
🔧 インストール
Go 1.17+ なら以下でインストールできます：
go install github.com/mickamy/gon@latest
Go 1.24+ の場合は go get -tool でもOK：
go get -tool github.com/mickamy/gon
初期化とテンプレートの準備は次の 2 ステップです：
gon init # gon.yaml を作成
gon install # テンプレートとテストヘルパーを準備
✨ 実際に使ってみる
modle の生成
gon g model User name:string email:string
use-case の追加
gon g usecase CreateUser
handler の生成
gon g handler User list create
ぜんぶ一括で
gon g scaffold User name:string email:string
このコマンドを実行すると、以下のようなファイルが自動生成されます：
internal/
└── domain/
└── user/
└── fixture/
│ └── user.go
├── model/
│ └── user_model.go
├── usecase/
│ ├── create_user_use_case.go
│ ├── get_user_use_case.go
│ ├── list_user_use_case.go
│ ├── update_user_use_case.go
│ └── delete_user_use_case.go
├── repository/
│ └── user_repository.go
└── handler/
└── user_handler.go
削除もできます：
gon d scaffold User
🧱 「意見の強さ」が gon の魅力
gon は柔軟性よりも、「迷わず使える」ことを重視しています。
ディレクトリ構成や命名規則を統一することで、チーム開発でも迷子になりません。
テンプレートは embed されており、必要なら gon install 後にカスタマイズも可能です。
🧩 作成されるコードの一例
実際に作成されるコードの一部をご紹介します。
handler（ListUserHandler）
type ListUserHandler echo.HandlerFunc
func ListUser(uc usecase.ListUser) ListUserHandler {
return func(c echo.Context) error {
ctx := c.Request().Context()
output, err := uc.Do(ctx, usecase.ListUserInput{})
if err != nil {
return c.JSON(http.StatusInternalServerError, err)
}
return c.JSON(http.StatusOK, output)
}
}
usecase（CreateUser）
package usecase
import (
"context"
)
type CreateUserInput struct {}
type CreateUserOutput struct {}
//go:generate mockgen -source=$GOFILE -destination=./mock_$GOPACKAGE/mock_$GOFILE -package=mock_$GOPACKAGE
type CreateUser interface {
Do(ctx context.Context, input CreateUserInput) (CreateUserOutput, error)
}
type createUser struct {}
func NewCreateUser() CreateUser {
return &createUser{}
}
func (uc createUser) Do(ctx context.Context, input CreateUserInput) (CreateUserOutput, error) {
return CreateUserOutput{}, nil
}
repository（User）
package repository
// ...
func (repo *user) List(ctx context.Context, scopes ...func(*gorm.DB) *gorm.DB) ([]model.User, error) {
var m []model.User
err := repo.db.WithContext(ctx).Scopes(scopes...).Find(&m).Error
return m, err
}
// 他のメソッドは省略
🤪 例を見てみたい？
example/ ディレクトリに、gon を使ったサンプルアプリを置いています。ぜひ覗いてみてください。
🔭 今後の展望
- DI ライブラリへの対応
- google/wire を想定
- http request/response につめる DTO の生成
- gorm/echo 以外のライブラリ対応
- より洗練されたアーキテクチャへの改造
など、いろいろアイデアがあります。Issue や PR も歓迎しています！
🙏 最後に
gon は「Go でも Rails みたいに開発したい！」という思いから生まれました。
ぜひ試して、フィードバックをもらえると嬉しいです。