テスト駆動開発を学ぶ

第5章 パッケージとモジュール Goのパッケージとモジュール

この作品はAIを使って翻訳されている。ご意見、ご感想をお待ちしている：[e-mail]

Goプログラムは、パッケージをリンクすることで構築される。Goパッケージは1つ以上のソースファイルから構成される。

Goプログラミング言語仕様書

この章では、Goコードをきれいにするためのいくつかのことを行う。 第0章で作成したGoモジュールを見て、コードを分離する目的を確認する。次に、パッケージを使ってテストコードと本番コードを分離する。最後に、コードから冗長性を取り除き、コンパクトで意味のあるものにする。

コードをパッケージに分ける

テストコードと本番コードを分離することから始めよう。これには2つの別々の作業が必要だ：

1. テストコードとプロダクションコードを分離する。

2. 依存関係がテストコードから本番コードへのみであることを確認する。

Money とPortfolio のプロダクション・コードとテスト・コードが、money_test.go という1つのファイルに並んでいる。まず、money.go とportfolio.go という名前の新しいファイルを2つ作成しよう。これらのファイルを$TDD_PROJECT_ROOT/go フォルダーに置く。次に、関連するクラス、Money とPortfolio のコードを適切なファイルに移動する。これがportfolio.go の外観である：

package main

type Portfolio []Money


func (p Portfolio) Add(money Money) Portfolio {
    p = append(p, money)
    return p
}

func (p Portfolio) Evaluate(currency string) Money {
    total := 0.0
    for _, m := range p {
        total = total + m.amount
    }
    return Money{amount: total, currency: currency}
}

ここには示していないが、money.go というファイルにも同様に、Money struct とそのメソッドが含まれている。

今テストを実行すると、すべてグリーンだ。やった！すべてがmain パッケージにあるので、テストからPortfolio とMoney のコードにアクセスするために特殊化する必要はない。特に、testing モジュールをインポートするときのように、import 文をテスト・クラスに追加する必要はない。

ソースコードを別々のファイルに分離したが、コードの上位レベルの組織化についてはどうだろうか？Portfolio 、Money 、どちらも「株式」市場に関するものであることを示すために、ネームスペースにまとめたい。

この分離を行う前に、モジュールとパッケージがGoでどのように機能するかを見てみよう。

囲碁モジュール

Goプログラムは通常、複数のソースファイルから構成される。 各Goソース・ファイルは、それが属するパッケージを宣言する。この宣言は、ファイル内のコードの一番最初の行にある。今回の3つのソース・ファイルでは、宣言はすべてpackage main 、現在すべてのコードがmain パッケージに存在することを指定している。

一般化すると、Goコード・リポジトリは正確に1つのモジュールで構成される。このモジュールには複数のパッケージが含まれ、パッケージにはそれぞれいくつかのファイルが含まれる。 ...