Goにはディレクトリ構成のスタンダードがあるらしい。

上記リポジトリにはGOプロジェクトでのスタンダードとなるディレクトリ構成の説明が書いてある。一つずつ見ていくことにします。

`/cmd`

一番メインとなるディレクトリ。このディレクトリの中にアプリケーションのエントリーポイントを作る。

.
└── cmd
    └── sampleapp
        └── main.go

注意点としてはmain.goに多くのことをさせないことである。各処理は基本的に後述する/pkgなどで実装していくのでそれをインポートする形を取るべきだとある。

`/internal`

/cmdで作ったエントリポイントで使いたいライブラリをおく。だが、このライブラリは各アプリケーション毎に書かれるものとなるので他のアプリケーションと共有するライブラリは置かない。そうゆうのをおくとすれば、後述の/pkgに置く。

├── cmd
│   └── sampleapp
│       └── main.go
└── internal
    └── apps
        └── sampleapp
            ├── pkg
            │   └── hello.go
            └── print.go

今回の例ではhello.goとかprint.goみたいなのが入ってあるがほんとはこんな共通化できるようなライブラリは入れてはならないので注意。

`/pkg`

このディレクトリがおそらく一番ファイルやディレクトリを配置することになるだろう。ここに置くライブラリは必ずどのアプリケーションから利用されてもいいように作成する必要がある。

.
├── cmd
│   └── sampleapp
│       └── main.go
├── internal
│   └── apps
│       └── sampleapp
│           ├── pkg
│           │   └── hello.go
│           └── print.go
└── pkg
    └── compute
        ├── add.go
        └── sub.go

例では計算用ライブラリを作って見た。その中のadd.goを見てみる。

package compute

func Add(x int, y int) (int) {
  return x + y
}

他に依存もしてないし、アプリケーションを選ばないように作った。

`/vendor`

これは特に考えることはないかと、自分で作ったライブラリを直接ここに置くことはしない。

`/api`

ここにはSwaggerとかAPIを作成する際のJSONファイルとかを入れる。

OpenAPI/Swagger specs, JSON schema files, protocol definition files.

`/web`

webページで使うtemplateとかimageとかcssとか入れとく。

`/configs`

コンフィグ系のテンプレートを入れとくフォルダ。自分のconfigは指定の配置に入れておこう。

`/init`

プロセスマネージャーがどうたらこうたら書いてある。使うことはあるのか？

`/scripts`

Makefileみたいなのを配置する。

`/build`

Dockerfileとか色々配置する様子。go buildしたものはここには入れないのかな？

`/deployments`

k8sとかのyamlファイルを配置して置くみたい。インフラ関係はここにおこう。

`/test`

外部テストとかはここにおこう。テストの時に使うデータはここに置いとくと管理がしやしいとかなんとか。

`/docs`

これは地味に大事、他の人に伝えたい情報などをドキュメント化して置くことは非常に大事なのでこのディレクトリは絶対に配置すべし。

まとめ

他にも/examplesとかあったのですが、解説するほどでもないのでまとめに入ります。

ディレクトリ構成はコーディングにも影響を及ぼすので大事です。プロジェクトごとに適切な構成にすることが必要。

.
├── cmd
│   └── sampleapp
│       └── main.go
├── configs
│   └── envrc.template
├── docs
│   ├── BUG.md
│   ├── ROUTING.md
│   └── TODO.md
├── internal
│   └── apps
│       └── sampleapp
│           ├── pkg
│           │   └── hello.go
│           └── print.go
├── pkg
│   └── compute
│       ├── add.go
│       └── sub.go
└── scripts
    └── Makefile