Kadai2 simady #16

simady · 2019-07-29T15:43:01Z

1回目の宿題のテストを作ってみて下さい

$ go test -cover imgconv/...
ok      imgconv 0.434s  coverage: 88.2% of statements
ok      imgconv/converter       0.430s  coverage: 100.0% of statements

テーブル駆動テストを導入しました。
テストヘルパーの作成はまだできていません。

io.Readerとio.Writerについて調べてみよう

type Reader interface {
        Read(p []byte) (n int, err error)
}

byte型のスライスを引数に取り、pに値を読み込む。
読み込んだバイト数とエラーを返す。

type Writer interface {
        Write(p []byte) (n int, err error)
}

byte型のスライスを引数に取り、pから値を書き込む。
書き込んだバイト数とエラーを返す。

標準パッケージでどのように使われているか
- tarやzip等のアーカイブ形式
- bzip2やlzw等の圧縮形式
- ECDSAやtls等の暗号化形式
- base64や16進数等のフォーマット
- gifやpng等の画像形式
- 標準入出力や標準エラー出力
- http通信でのリクレス等
- MIMEマルチパートやQuoted-printable等の方式
- ファイル
- 文字列やバイトバッファ
- ログ

上記のように様々な箇所での読み書きに使用されていた。
また、以下のようなerrorの戻り値を利用するような使い方も見られた。

type errorReader struct {
	error
}
func (r errorReader) Read(p []byte) (n int, err error) {
	return 0, r.error
}

type eofReader struct{}
func (eofReader) Read([]byte) (int, error) {
	return 0, EOF
}

io.Readerとio.Writerがあることでどういう利点があるのか具体例を挙げて考えてみる
- io.Readerやio.Writerを実装したインスタンスをインターフェースを介して利用することで、使用する側は実体が何かを意識せずに扱うことができる。
- シンプルなインターフェースなので実装が容易。何に対して読み書きを行うかは定義されていないので、入出力先に応じて適宜実装すれば良い。
- テストやデバッグ時に、実際の処理とは別の処理に置き換えるといった差し替えが容易に行える。
- ioパッケージのpipeやio/ioutilパッケージで定義された既存の便利メソッドを利用できる。

tenntenn · 2019-07-31T10:02:28Z

kadai1/simady/converter/converter.go

+)
+
+// IConverter コンバーターインターフェース
+type IConverter interface {


Goでは先頭にIとつける習慣はない。

tenntenn · 2019-07-31T10:02:49Z

kadai1/simady/converter/converter.go

+
+// IConverter コンバーターインターフェース
+type IConverter interface {
+	convert(file *os.File, img image.Image) error


型名がexportされているのにメソッド名がexportされていない理由は？

tenntenn · 2019-07-31T10:03:44Z

kadai1/simady/converter/converter.go

+)
+
+// Validate フィールドのバリデーション処理を行う.
+func (c converter) validate() bool {


構造体の場合、特に理由がない場合はレシーバにはポインタを使う。
https://qiita.com/knsh14/items/8b73b31822c109d4c497#receiver-type

tenntenn · 2019-07-31T10:04:14Z

kadai1/simady/converter/converter.go

+	return validate(c.src) && validate(c.dst)
+}
+
+func validate(ext string) bool {


なぜメソッドでやらずに関数で行う？

tenntenn · 2019-07-31T10:06:42Z

kadai1/simady/converter/converter.go

+}
+
+func validate(ext string) bool {
+	for _, e := range convertibleExts {


mapを使えば関数不要そう。
https://play.golang.org/p/11bEbuN1BLW

tenntenn · 2019-07-31T10:07:54Z

kadai1/simady/converter/converter.go

+
+	src, err := os.Open(path)
+	if err != nil {
+		log.Fatalf("Faild to open file. err = %v\n", err)


log.Fatalは中でos.Exitを呼び出すので基本的にmain関数以外では使わない。
errorを返す。
main関数であってもox.Exitに渡す終了コードを指定することができないため、基本的には使わない。

tenntenn · 2019-07-31T10:08:22Z

kadai1/simady/converter/converter.go

+	if err != nil {
+		log.Fatalf("Faild to create file. err = %v\n", err)
+	}
+	defer dst.Close()


書き込み用のファイルは閉じる際にエラー処理をする。

tenntenn · 2019-07-31T10:08:42Z

kadai1/simady/converter/converter.go

+	switch dst {
+	case "png":
+		return pngConverter{c}
+	case "jpeg":


jpgも扱えるようにしたほうが良さそう。

tenntenn · 2019-07-31T10:09:02Z

kadai1/simady/converter/converter.go

+}
+
+// GetConverter 拡張子に対応したコンバーターを取得する.
+func GetConverter(src, dst string) IConverter {


GoではGetという単語はあんまり使わない。

tenntenn · 2019-07-31T10:09:14Z

kadai1/simady/converter/converter_test.go

+	"testing"
+)
+
+func TestGetConverter(t *testing.T) {


テーブル駆動テストをする

tenntenn · 2019-07-31T10:10:05Z

kadai1/simady/converter/converter_test.go

+func TestGetConverter(t *testing.T) {
+	var c IConverter
+	c = GetConverter("jpeg", "png")
+	if _, ok := c.(pngConverter); !ok {


せっかくインタフェースにしているのに、テストが具体的な実装に依存しているのはあまりよくない。

simady added 4 commits July 16, 2019 16:37

画像変換コマンドラインツールの実装

147c3d4

ディレクトリ構造の修正

58ee406

README追加

ca9741b

テスト関連の実装を追加

011a4c1

simady added the kadai2 label Jul 29, 2019

tenntenn reviewed Jul 31, 2019

View reviewed changes

kadai1/simady/converter/converter_test.go

"testing"

)

func TestGetConverter(t *testing.T) {

Copy link

Member

tenntenn Jul 31, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

テーブル駆動テストをする

tenntenn reviewed Jul 31, 2019

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Kadai2 simady #16

Kadai2 simady #16

simady commented Jul 29, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

tenntenn Jul 31, 2019

Kadai2 simady #16

Are you sure you want to change the base?

Kadai2 simady #16

Conversation

simady commented Jul 29, 2019

1回目の宿題のテストを作ってみて下さい

io.Readerとio.Writerについて調べてみよう

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment