【課題2】

kadai2/nas/Makefile

@@ -0,0 +1,35 @@
+# CONST
+BINARYNAME=imachan
+
+export GO111MODULE=auto
+
+# command
+.PHONY: help
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+.PHONY: build
+build: ## go build
+	go build -v ./cmd/${BINARYNAME}
+
+.PHONY: test
+test: ## go test
+	go test -v -cover ./pkg/${BINARYNAME}
+
+.PHONY: clean
+clean: ## go clean
+	go clean -cache -testcache
+
+.PHONY: analyze
+analyze: ## do static code analysis
+	goimports -l -w .
+	go vet ./...
+	golint ./...
+
+.PHONY: remove
+remove: ## remove binary and test output data
+	rm -f ./${BINARYNAME}
+	find testdata -type f -not -name *.jpg | xargs rm
+
+.PHONY: all
+all: remove clean test analyze build ## run 'build' with 'remove', 'clean', 'test' and 'analyze'

kadai2/nas/README.md

@@ -0,0 +1,72 @@
+# imachan
+
+## imachan is the CLI tool to convert images
+
+## How to build
+
+```sh
+$ cd kadai1/nas
+$ make build
+```
+
+## Can convert images under the directories
+
+```sh
+$ find .
+.
+./cmd
+./cmd/imachan
+./cmd/imachan/main.go
+./testdata
+./testdata/go2.jpg               // jpg file
+./testdata/sub
+./testdata/sub/go3.jpg           // jpg file
+./testdata/go.jpg                // jpg file
+./Makefile
+./README.md
+./pkg
+./pkg/imachan
+./pkg/imachan/imachan_test.go
+./pkg/imachan/imachan.go
+
+$ ./imachan
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go.png
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go2.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go2.png
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/sub/go3.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/sub/go3.png
+```
+
+## Can choose the taget directory
+
+```sh
+$ ./imachan -d testdata
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go.png
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go2.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go2.png
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/sub/go3.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/sub/go3.png
+```
+
+## Can choose the image format
+```sh
+$ ./imachan -f jpg -t gif
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go.gif
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go2.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/go2.gif
+success : path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/sub/go3.jpg -> path/to/github.com/gopherdojo/dojo7/kadai1/nas/testdata/sub/go3.gif
+```
+
+---
+
+# 【TRY】画像変換コマンドを作ろう
+
+## 次の仕様を満たすコマンドを作って下さい
+
+- [x] ディレクトリを指定する
+- [x] 指定したディレクトリ以下のJPGファイルをPNGに変換（デフォルト）
+- [x] ディレクトリ以下は再帰的に処理する
+- [x] 変換前と変換後の画像形式を指定できる（オプション）
+
+## 以下を満たすように開発してください
+
+- [x] mainパッケージと分離する
+- [x] 自作パッケージと標準パッケージと準標準パッケージのみ使う
+  - 準標準パッケージ：golang.org/x以下のパッケージ
+- [x] ユーザ定義型を作ってみる
+- [x] GoDocを生成してみる

kadai2/nas/cmd/imachan/main.go

@@ -0,0 +1,71 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/gopherdojo/dojo7/kadai2/nas/pkg/imachan"
+)
+
+// exit codes
+const (
+	ExitCodeOK  = 0
+	ExitCodeErr = 3
+)
+
+var usage = `imachanは指定のディレクトリ配下の画像を変換する CLI ツールです。
+変換元の画像形式および変換先の画像形式を指定できます。
+
+Usage:
+  imachan [flags]
+
+Flags:
+  -d string   select target file or directory            (default: ./)
+  -f string   select extension of image converted from   (default: jpg)
+  -t string   select extension of image converted to     (default: png)
+`
+
+func main() {
+	err := run()
+	if err != nil {
+		os.Exit(ExitCodeErr)
+		return
+	}
+	os.Exit(ExitCodeOK)
+}
+
+func run() error {
+	var (
+		dir        string
+		fromFormat string
+		toFormat   string
+	)
+
+	flag.Usage = func() {
+		fmt.Print(usage)
+	}
+
+	flag.StringVar(&dir, "d", ".", "target directory")
+	flag.StringVar(&fromFormat, "f", "jpg", "converted from")
+	flag.StringVar(&toFormat, "t", "png", "converted to")
+	flag.Parse()
+
+	path, err := filepath.Abs(dir)
+	if err != nil {
+		return err
+	}
+	c, err := imachan.NewConfig(path, fromFormat, toFormat)
+	if err != nil {
+		return err
+	}
+	data, err := c.ConvertRec()
+	if err != nil {
+		return err
+	}
+	for _, dd := range data {
+		fmt.Printf("success : %s -> %s\n", dd["from"], dd["to"])
+	}
+	return nil
+}

kadai2/nas/doc/homework.md

@@ -0,0 +1,157 @@
+# io.Readerとio.Writerについて調べてみよう
+
+- 標準パッケージでどのように使われているか
+
+- io.Readerとio.Writerがあることでどういう利点があるのか具体例を挙げて考えてみる
+
+---
+
+## 標準パッケージでどのように使われているか
+
+### 1. `io.Reader`は下記のように定義されている
+
+```go
+type Reader interface {
+	Read(p []byte) (n int, err error)
+}
+```
+
+`fmt.Fscan` は引数に `io.Reader` をとる
+
+```go
+func Fscan(r io.Reader, a ...interface{}) (n int, err error) {
+	s, old := newScanState(r, true, false)
+	n, err = s.doScan(a)
+	s.free(old)
+	return
+}
+```
+
+`fmt.Scan`で`fmt.Fscan`に`os.Stdin`を渡している
+```go
+func Scan(a ...interface{}) (n int, err error) {
+	return Fscan(os.Stdin, a...)
+}
+```
+
+
+`os.Stdin` は下記のように定義されている
+```go
+var (
+	Stdin  = NewFile(uintptr(syscall.Stdin), "/dev/stdin")
+	...
+	...
+)
+```
+
+`os.NewFile` は `*os.File` を返す
+```go
+func NewFile(fd uintptr, name string) *File {
+	kind := kindNewFile
+	if nb, err := unix.IsNonblock(int(fd)); err == nil && nb {
+		kind = kindNonBlock
+	}
+	return newFile(fd, name, kind)
+}
+```
+
+`*os.File` は `io.Reader` を実装している
+
+```go
+func (f *File) Read(b []byte) (n int, err error) {
+	if err := f.checkValid("read"); err != nil {
+		return 0, err
+	}
+	n, e := f.read(b)
+	return n, f.wrapErr("read", e)
+}
+```
+
+そのため`fmt.Fscan` は引数に `os.Stdin` を取れる
+
+
+### 2. `io.Writer`は下記のように定義されている
+
+```go
+type Writer interface {
+	Write(p []byte) (n int, err error)
+}
+```
+
+`fmt.Fprint`は`io.Writer`を引数に取る
+
+```go
+func Fprint(w io.Writer, a ...interface{}) (n int, err error) {
+	p := newPrinter()
+	p.doPrint(a)
+	n, err = w.Write(p.buf)
+	p.free()
+	return
+}
+```
+
+`fmt.Print`で`fmt.Fprint`に`os.Stdout`を渡している
+
+```go
+func Print(a ...interface{}) (n int, err error) {
+	return Fprint(os.Stdout, a...)
+}
+```
+
+
+`os.Stdout` は下記のように定義されている
+
+```go
+var (
+	...
+	Stdout = NewFile(uintptr(syscall.Stdout), "/dev/stdout")
+	...
+)
+```
+
+`os.NewFile` は `*os.File` を返す
+```go
+func NewFile(fd uintptr, name string) *File {
+	kind := kindNewFile
+	if nb, err := unix.IsNonblock(int(fd)); err == nil && nb {
+		kind = kindNonBlock
+	}
+	return newFile(fd, name, kind)
+}
+```
+
+`*os.File` は `io.Reader` を実装している
+
+```go
+func (f *File) Write(b []byte) (n int, err error) {
+	if err := f.checkValid("write"); err != nil {
+		return 0, err
+	}
+	n, e := f.write(b)
+	if n < 0 {
+		n = 0
+	}
+	if n != len(b) {
+		err = io.ErrShortWrite
+	}
+
+	epipecheck(f, e)
+
+	if e != nil {
+		err = f.wrapErr("write", e)
+	}
+
+	return n, err
+}
+```
+
+そのため`fmt.Fprint` は引数に `os.Stdout` を取れる
+
+
+## io.Readerとio.Writerがあることでどういう利点があるのか具体例を挙げて考えてみる
+
+- 幅広い箇所に拡張が可能
+  - `http`パッケージや`bytes`パッケージ 、`strings`パッケージで使用されている
+
+- Mock テストが用意になる
+  - 標準入出力の代わりにバイトで渡すということが可能