Go

Goのnilを理解する。

Go言語でありがちな間違い。

oapi-codegenの使い方。とくにバリデーションが参考になる。

factory-botを便利に使う方法。

引数にポインタをとるとき。↓のようにしたくなる。

i := 1
xxxx(&i)

実際は↓のように短く書ける。

func GetPtr[T any](x T) *T {
        return &x
}

xxxx(GetPtr(1))

• Frequently Asked Questions (FAQ) - The Go Programming Language

func main() {
    done := make(chan bool)

    values := []string{"a", "b", "c"}
    for _, v := range values {
        go func() {
            fmt.Println(v)
            done <- true
        }()
    }

    // wait for all goroutines to complete before exiting
    for _ = range values {
        <-done
    }
}

• v に入るインスタンスはループ間で共通である
• ループがまわり切ってから、goルーチンが実行される。goルーチンが実行されるときには、インスタンスは最後の "c" になっている

gdbだと謎のgoroutineらしきものがたびたび挿入される( runtime.sigtramp )。直し方がよくわからないのでやめた。代わりにdelveを使うことに。構造体の表示がいい感じだ。使い方はだいたい同じ。

Emacsの M-x gdb と同等になるのがbenma/go-dlv.elで配布されている。dap-modeよりこちらが好み。 (dlv-current-func) を使う。

コンパイル時に最適化した結果、変数や式を削除することがある。その場合デバッガで表示できなくなる。コンパイルオプションで最適化を無効化すると表示できる。

go build -gcflags="-N -l" main.go

オプションがたくさんある、でかいコードベースで見る表現の解説を見つけた。

• Functional Options Pattern in Golang

package main

import "fmt"

type Config struct {
    Host     string
    Port     int
    Username string
    Password string
}

type Option func(*Config)

func WithHost(host string) Option {
    return func(c *Config) {
        c.Host = host
    }
}

func WithPort(port int) Option {
    return func(c *Config) {
        c.Port = port
    }
}

func WithCredentials(username, password string) Option {
    return func(c *Config) {
        c.Username = username
        c.Password = password
    }
}

func NewConfig(options ...Option) *Config {
    config := &Config{
        Host:     "localhost",
        Port:     8080,
        Username: "",
        Password: "",
    }

    for _, option := range options {
        option(config)
    }

    return config
}

型で挙動を変える書き方ができる。

type Mover bool
const (
        Animate = Mover(true)
        DontAnimate = Mover(false)
)
func (m Mover) move() { }

Animate.move()
DontAnimate.move()

Go言語による並行処理から。

ゴルーチンの中でクロージャーを実行すると、クロージャーはこれらの変数のコピーに対して操作するのか、それとも元の変数の参照に対してか。

var wg sync.WaitGroup
salutation := "hello"
wg.Add(1)
go func() {
        defer wg.Done()
        salutation = "welcome"
}()
wg.Wait()
fmt.Println(salutation)

ゴルーチンはそれが作られたアドレス空間と同じ空間で実行する、ということ。

var wg sync.WaitGroup
for _, salutation := range []string{"hello", "greetings", "good day"} {
        wg.Add(1)
        go func() {
                defer wg.Done()
                fmt.Println(salutation)
        }()
}
wg.Wait()

• ゴルーチンが開始する前にループが終了してしまう
• salutation変数はスコープ外になる
• Goランタイムは変数salutationの参照がまだ保持されているのを知っていて、ゴルーチンがそのメモリにアクセスし続けられるようにメモリをヒープに移す
• 文字列スライスの最後の“good day”への参照を保持したままヒープに移される

ループを想定したようにただしく書くには、salutationのコピーをクロージャーに渡して、ゴルーチンが実行されるようになるまでにループの各繰り返しから渡されたデータを操作できるようにする。

var wg sync.WaitGroup
for _, salutation := range []string{"hello", "greetings", "good day"} {
        wg.Add(1)
        go func(salutation string) {
                defer wg.Done()
                fmt.Println(salutation)
        }(salutation)
}
wg.Wait()

原因はよくわからない。ツールをインストールしてフォーマットをかける。

• main.go:24: File is not `gci`-ed with –skip-generated -s standard,default (gci)

main.go:24: File is not `gci`-ed with –skip-generated -s standard,default (gci)

go install github.com/daixiang0/gci@latest
gci write --skip-generated -s standard,default .

カバレッジフラグをオンにしているとコンパイル時、各ブロックにカウンタが挿入されて実行されている。

ファイル指定でテストを実行しようとすると、ほかのパッケージを読み込んでくれないため走らせられないことがある。多くの場合、ほかのファイルへの読み込みがあるので、現実的ではない。なので、読み込むファイルは全体にして、走らせる関数を指定して一部だけ実行する。

go test ./... -run Buildinfo

• メモリの読み書きを行う場所は、スタックとヒープに分かれる
  • スタックはメモリの使い方や使用量がコンパイル時に決定できる場合に用いられる
    • 関数呼び出し時に確保され、関数から抜けるときに開放される。
    • あらかじめどのメモリをどれだけ使うかわかっているため、必要になる直前で確保し、いらなくなったらすぐに破棄できメモリを効率よく使える
  • ヒープはメモリの使い方や使用量が実行時にしかわからない場合に用いる
    • ヒープに確保した変数の生存期間は用途によってバラバラ
    • ガベージコレクタを用いてヒープのメモリを集中管理し、しかるべきタイミングで解放する
    • GoではGC時にSTW(Stop The World)が発生するものを採用しているので、GCが動いている間はプログラムの実行が止まる
  • なので、パフォーマンスを考慮するときはメモリを確保する先がスタックになるかヒープになるかは重要
  • 変数の型が実態で定義される場合、Goはその変数をスタック上に確保する。C languageと同じ
  • 変数の型をポインタにすると、メモリはヒープかスタックのどちらかに確保される

• os.CreateTemp が便利
• os.MkdirTemp → ディレクトリ
• (*testing.T).TempDir → テストで便利。テスト関数の終了時にディレクトリを消してくれる

goimportsは面倒なimportを自動で書いてくれる便利なパッケージ。必要なパッケージを自動で消してしまうのでハマった。チェックリストを残す。

• 名前は合っているか。特に自分のパッケージを読み込む場合、module名と一致しているか
• 本当にその箇所から読み込めている記述になっているか。publicな呼び出しになっているか

copyはその名の通りsliceをコピーするメソッド。固定長でないとコピーされない。

$ go test -coverprofile=cover.out .
$ go tool cover -html=cover.out -o cover.html

Golang/goのリポジトリ全体を計測する。

cd ./src
./all.bash
../bin/go test -cover ./... -coverprofile=cover.out
../bin/go tool cover -html=cover.out -o cover.html

func (w *Wallet) Withdraw(amount Bitcoin) error {
	if amount > w.balance {
		return ErrInsufficientFunds
	}

	w.balance -= amount
	return nil
}

成功したときは、errorにnilが入る。

error時の処理は呼び出し元で定義し、errorを返す可能性のある関数定義では単にerrorを返すことだけに集中する。

返り値に名前をつける機能。最初に初期化され、returnするとそれ時点の名前のついた変数が返される。

func test() (value1, value2 int) {
        value1 = 1
        value2 = 2
        return
}

とすると、返り値には1, 2が返る。長い関数だとわかりづらくなるので注意。

どの関数がどこから呼び出されているかの図を生成する。

go install github.com/ofabry/go-callvis@master # なぜかlatestバージョンでは失敗した

そして調べたい関数を呼び出したmain.goのあるディレクトリで実行する。

go-callvis -group pkg,type ./ # -groupはグルーピング表示するオプション

go-callvis -group pkg,type -focus fmt ./ # フォーカス表示

と、ブラウザが立ち上がって、図が表示される。図の中のライブラリをクリックすると、さらにそのライブラリの呼び出しを描画する。

go get したとき x509: certificate signed by unknown authority エラーになる。

証明書の更新をすればよいとのこと。

$ sudo apt update
$ sudo apt install --only-upgrade -y ca-certificates #最新
$ update-ca-certificates

リクエストを使うときに通常使われる方法。値の検証と後で利用しやすくするため、定義した構造体に入れる。

• Binding Request Data | Echo - High performance, minimalist Go web framework

• Go言語の埋め込みについて4つのポイントでまとめました - Qiita

Goの埋め込みの解説。

埋め込みはあくまでも借りているだけで、埋め込み元のオブジェクトのメソッドとして実行される。埋め込み先の構造体が埋め込み元のメソッドを実行しても埋め込み先のオブジェクトには影響を与えない。

図によるポインタのわかりやすい解説。

var x = 100
fmt.Println("1: x address:\t", &x)

var y *int
fmt.Println("2: y value:\t", y)
fmt.Println("3: y address:\t", &y)
y = &x
fmt.Println("4: y value:\t", y)	// yの値には、xのアドレスが入っている
fmt.Println("5: y address:\t", &y)

• 型としての *
  • ポインタ変数はメモリ上のアドレスを値として入れられる変数
  • 変数の中身(つまり値)はメモリアドレス
• 変数の演算子としての *, &
  • * ポインタの指すメモリアドレスの実データ(value)
  • & 変数がメモリ上で確保された際のアドレス(address)

*x だけど x がポインタ型変数でない場合、値にアドレスがなくて辿れず当然値も取得できないのでエラー。

• メモリアドレスは変数であれば必ず存在する。なのでどの変数でも & が使える
• valueは値(1)か、メモリアドレス(0xc00001a0c0)が入っているか、nil。値にメモリアドレスが入っている場合のみ * が使える

var x *int
fmt.Println("x value:\t", *x)

ポインタ変数のvalueにメモリアドレスがないのでpanicが起きる。動かしてみないとわからないのでコンパイルエラーでなくruntimeエラー。

Goはすべて値渡し(=コピー)。

func main() {
        var x = "alice"
        fmt.Println("x address:\t", &x)
        y := &x
        fmt.Println("y value:\t", y)
        fmt.Println("y address:\t", &y)

        show(y)
}

func show(s *string) {
        fmt.Println("f value:\t", s)
        fmt.Println("f address:\t", &s)
}

定義された変数と、関数引数として使われた変数では、参照先アドレスは同じ(xのアドレス)。アドレスは異なる、つまりコピーされている。

ポインタレシーバ。

type Person struct {
        Name string
        Age int
}

func main() {
        x := &Person{"alice", 20}
        fmt.Printf("x value:\t%p\n", x)
        fmt.Printf("x address:\t%p\n", &x)
        x.Greet("test")

        fmt.Printf("new x value:\t%v\n", x)
}

func (p *Person) Greet(msg string) {
        fmt.Printf("p value:\t%p\n", p)
        fmt.Printf("p address:\t%p\n", &p)

        // ポインタ変数を上書きするのではなく、参照先を上書きする
        p.Name = "hahaha"
}

メソッドのレシーバーを値にするかポインタにするかは、レシーバのフィールドに変更をしたいかによって決める。

func (s Struct) SetValue(v int {
        s.v = v
})

func (s *Struct) SetValue(v int {
        s.v = v
})

• ポインタ型を示すときは *Person と宣言。これによってPerson型の変数のポインタが入ることが示される
• ポインタ型を生成するときは & を使う。これは変換関数のようなもの。 &変数名 という形式。実際に変数宣言されているものに対してポインタがある。それぞれにアドレスが割り当てられるようなもの。だから、型とか関数自体はポインタにしない(意味がない)。あくまで変数をリンクさせて、変更を波及させられるのが良いところだから
• ポインタを解決実際の値を見るときは *p
• &p で*Person型を生成する、というような関係性

var p *int // 変数pには、int型の変数のポインタが入るという宣言
i := 1
p = &i				// 変数iを参照するポインタ型変数p

// p 				// -> 0xc000010000
// *p 				// -> 1

fmt.Println(p)
fmt.Println(*p)
i = 2				// あくまで変えるのは参照先の値であって、p -> i のリンク自体を変えるわけじゃない
fmt.Println(p)			// メモリアドレスは変わらない
fmt.Println(*p)			// 参照先のアドレスが変わった

• 「アドレスを取得(&)」という操作と「アドレスを解決(*)」という操作がある。

存在チェックの方法。

//go:embed sample.json
var sampleBytes []byte

ファイルを直に変数に入れることができる。いちいち読み込みのコードを書かなくて良くなる。

複数ファイルの埋め込みもできる。

//go:embed README.md version.txt
var static embed.FS

r, err := static.Readfile("README.md")

確かに短く書ける。しかしこれだけなら、従来の方法でもできる。メリットは、設定ファイルをバイナリに埋め込めること。

• Go 1.16からリリースされたgo:embedとは | フューチャー技術ブログ

型名と同じ変数名を宣言すると、よりローカルな変数名が優先されるため、その型が使えなくなる。それだけでなく、型指定で~は型ではありませんエラーが謎に出るため、ハマる可能性が高い。Lintで防げるだろうか。

• fdはファイルディスクリプタ。プログラムからファイルを操作する際、操作対象のファイルを識別・同定するために割り当てられる番号

https://github.com/kd-collective/go/blob/a813be86df74bf2a9c5b272c0b0934d196ac665d/src/os/file_unix.go#L54-L61

• ネットワークで使うConnインターフェース

https://github.com/kd-collective/go/blob/a813be86df74bf2a9c5b272c0b0934d196ac665d/src/net/net.go#L113-L168

• Open(), Create() は引数が違うだけで同じ関数OpenFile()を呼び出している
• よく使う権限の組み合わせでラップしているだけ

https://github.com/kd-collective/go/blob/a813be86df74bf2a9c5b272c0b0934d196ac665d/src/os/file.go#L311-L313

https://github.com/kd-collective/go/blob/a813be86df74bf2a9c5b272c0b0934d196ac665d/src/os/file.go#L320-L322

https://github.com/kd-collective/go/blob/a813be86df74bf2a9c5b272c0b0934d196ac665d/src/os/file.go#L330-L339

go mod init example

go install

go run hello.go

Emacs dap-modeでデバッガ起動。行の横をクリックしてブレークポイントをセットしたのち、コマンド実行。

M-x dap-debug

ob-goをインストールして (require "ob-go") する。実行方法が少し変わっていて、下のように指定する。

fmt.Println("hello world")

• pope/ob-go: Org-Babel support for evaluating go code.

DAP(Debug Adapter Protocol)はデバッガー補助。エディタ関係なくIDEのようにエディタ上でブレークポイントをセットできるプロトコル。LSPのデバッガーバージョンな概念。

Go用のデバッガはemacsコマンドでインストールできず、go installでインストールする必要がある。

• Configuration - DAP Mode
  • 外部コマンドをgo installでインストール
    • LSPのライブラリ名は gopls
    • Debuggerのライブラリ名は delve (注意: VScode用のプログラムを用いる方法はdeprecatedで、現在は直接installするのが最新)
  • go installしたあと、Emacs側が認識できるように設定する

$ go install golang.org/x/tools/gopls@master            # Language Server
$ go install github.com/go-delve/delve/cmd/dlv@master   # debugger

自分の環境では一瞬デバッガのボタンが表示されて Debug Adapter finished になってしまう状態になった。Warningには Warning (emacs): Initialize request failed: Failed to launch Disable showing Disable logging が表示される。理由がよくわからないため、表示させる。 (setq dap-print-io t) を評価すると、messageバッファに詳細なログを出力する。

原因は、しっかりと表示されていた。

“format”: “Failed to launch: Go version 1.14.15 is too old for this version of Delve (minimum supported version 1.17, suppress this error with –check-go-version=false)”,

ということで、goのバージョンを上げると無事デバッガが起動するようになった。

$ go install github.com/uudashr/gopkgs/cmd/gopkgs       # Go パッケージ
$ go install golang.org/x/tools/cmd/goimports@master    # import の過不足を自動で補完

プリンターの状態を保存している、重要そうな構造体。

https://github.com/golang/go/blob/122a22e0e9eba7fe712030d429fc4bcf6f447f5e/src/fmt/print.go#L119-L120

https://github.com/golang/go/blob/122a22e0e9eba7fe712030d429fc4bcf6f447f5e/src/fmt/print.go#L188-L202

https://github.com/golang/go/blob/122a22e0e9eba7fe712030d429fc4bcf6f447f5e/src/fmt/print.go#L271-L273

• doPrintf
  • printArg
    • printValue
• 実際画面に表示してるのはどこなんだろう
  • print系の中でbufに書き込みをしているのはよく見る
  • 関数の中に画面出力、みたいな部分は見当たらず
  • 別に「画面に出力する」という関数があるわけじゃなくて、「標準出力にあたるファイルに書き込みをする」関数があるだけ。だから、標準出力以外への書き込みとの差は一切ない
  • /dev/stdin は特殊ファイルという。画面への入出力などをファイルとして操作できるようにしたものだから、ファイル書き込みとなんら変わらずに操作できる
  • Stdoutは1と定義されている。なので、fd1つまり/dev/stdout/1を作成する

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/os/file.go#L66

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/cmd/vendor/golang.org/x/sys/unix/syscall_unix.go#L20

• print系は、ベースになる関数がある。書き込み先とフォーマット解析の組み合わせで、いろいろ名前がついている
• 本質的に、ファイル書き込みにすぎない
• フォーマット解析でいろいろ処理があって、多くを占める。各型での文字列の取り出し方とか

よく見るが、何か。

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/fmt/print.go#L63-L65

type MyString string

func (s MyString) String() string {
  return "mystring"
}

func main() {
  s := MyString("hello")
  fmt.Println(s) // String()の結果が使われる
}

printするときには、先にStringerの判定が入る。Stringerを満たしていれば、String()を使う。満たさなければ、通常の、printに渡された文字列引数を使って表示する。

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/fmt/print.go#L670-L675

• Goのruneを理解するためのUnicode知識 - Qiita
• 文字と01の並びを対応づける仕組み、それが文字コード。その1つのUnicodeは世界中のあらゆる文字列を収録されるために作られている規格
  • aはUnicodeでu+0041と表される。16進数で0041という値と対応づけられる。この値はcode point(code position)と呼ばれ、文字コード中の位置を指し示す文字のIDといえる
  • 符号化方式は41とか1F601といったcode pointの値をコンピュータが扱うデータ形式に置き換えるための規則。方式によってcode pointを何byte単位で扱うかが異なってくる
  • Goでは符号化方式としてUTF-8を使用している。UTF-8では1byteから4byteの可変長データでcode pointを置換する。数字やアルファベットのような広く使われている文字は1byteになり、Unicodeに後から追加された絵文字などは4byteになる。
  • Unicodeの符号化方式にはUTF-16やUTF-8がある
• stringにインデックスでアクセスしたときに得られるbyte値は文字コードをUTF-8で1byteごとに区切った値

s := "あ"
for i := 0; i < len(s); i++{
  fmt.Printf("% x", s[i])
}

• ひとつの文字は複数byteで表現される可能性がある。文字を表すbyteをまとめて読まないと正しい文字として認識できなくなる
• なので文字を数える単位としてはbyteではなくcode pointのほうが都合がいい。Goではcode pointを単位として文字を扱うための仕組み、つまりruneを用意している
• runeの実体はint32のエイリアス。int32なのはUnicodeの4byte分のcode pointを表現するため

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/builtin/builtin.go#L90-L92

fmt.Println('あ')
fmt.Println('a')
fmt.Println(' ')
fmt.Println('!')
fmt.Println('"')
fmt.Println('a' * 2)
fmt.Println('a' - 'b')

s := "あいう"
fmt.Println([]rune(s))
fmt.Println([]byte(s))

Goルーチンの解説。ベースがないのでよく理解できなかった。

Goルーチンの解説。よくわからなかった。

非同期処理の解説。

Goのパフォーマンス最適の読み物。

GoのiotaのTips。

Goアセンブリの解説記事。

Goの内部仕様についての本。

Goアセンブリの解説。

package main
func add(a, b int32) (int32, bool) { return a + b, true }
func main() { add(10, 32) }

Mapの中身の解説。

再現可能なビルド。

型のクイズ。

ジェネリクスの解説。

Untyped Constantsの解説。

iotaで作るのがデフォルトではあるけれど。

Golangの本。

シンタックスの意味。

Goの整数の仕様の解説。

go buildの仕組み解説。全然わからん。

Goの言語デザインの解説。

Russ Coxによるインターフェースの詳しい解説。

CSPを理解する。

Cのシンタックスとの違い、理由。

公式ドキュメントの翻訳。

低レイヤーの解説。

Goアセンブラの解説。

go buildの仕組み。実際に動かして取っ掛かりを見つけるのが面白い。そういうアプローチもあるのか。

私はソースを読むよりもリバースエンジニアリングする方が得意なので、今回もログだけを見て処理内容を推測して自作しました。

ビルドタグで言及されてたページ。

- Goのビルドタグの書き方が// +buildから//go:buildに変わった理由

Go Docのコメントの仕様。

コンパイラの最適化。

Goエスケープの説明。

Profile-Guided Optimizationは、コンパイル時最適化のヒントとして、ランタイムのプロファイル情報を使うことでより効率よく最適化する手法です。

並列実行の注意点。

Goのメモリモデル。

sync.Onceの仕組み。

チャネルの矢印がないときに、パッケージがないエラーになることがある。ちゃんとそっちを示してほしいのに。フォーマッタとビルドの検知が合ってないために起こるように見える。

公式の記事。

コンパイル時になにが起きているか、ログから調べる。

GCの解説。

Goのランタイムの解説。

言語処理系の作り方。

Goコンパイルの流れ。

ベンチマークする方法。

エラーハンドリングの本。

じつは複雑な定数。

値。

どうするんだっけ。

例で学ぶ解説。

直感に反する挙動からわかる、内部の仕組みの話。

来月発売される本。

日本語訳。

日本語訳された公式ドキュメント。

並行処理の解説本。

並行処理と並列処理は全く異なる。

• 並行処理(Concurrency)
  • ある時点の範囲において、複数のタスクを扱うこと
  • どういう風にふたつを終わらせるかは自由
  • 複数の処理を独立に実行できる 構成 のこと
  • 「並行処理できる設備がある」
  • 一度に多くのことを扱うこと
  • 問題解決の手段としてのプログラミングパターン
  • 平行性はコードの性質
• 並列処理(Parallelism)
  • ある時点の点において、複数のタスクを扱うこと
  • 1点において、タスクAとBを同時に実行する
  • 複数の処理を同時に 実行 すること
  • 「並列処理で生産する」
  • 一度に多くのことを行うこと
  • 並行処理を可能にするハードウェアの特性のこと
  • 並列性は動作しているプログラムの性質

チャネルは送受信、実行同期のための機構。

• ゴルーチンは他のコードに対して並行に実行している関数のこと(必ずしも並列ではない)

Goのハンズオン集。

IdをIDに変換する例。

読む。

Goらしく書くためのtips。

Goで役立つパターン。

bufioのわかりやすい解説。

TCPの仕組み、作り方。

どちらも大まかには初期化するものだが、微妙に異なる。

• newはゼロ値で確保された値へのポインタを得る関数

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/builtin/builtin.go#L212

• makeはマップ、スライス、チャンネル（map[type]type, []type, chan）の確保と初期化を行い型そのものを得る関数

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/builtin/builtin.go#L207

#+begin_resultsg go func make(t Type, size …IntegerType) Type #+end_results

スライスなどの長さを調べるLen()はどういう実装になっているのだろうか。組み込みだから、ほかの関数とは異なりそう。

https://github.com/kd-collective/go/blob/9b8750f53ed89fb326e4d811524e647683136bac/src/builtin/builtin.go#L161-L173

contextの詳しい解説。この人すごいなあ。

• contextのvalueに入れるのにふさわしい値はリクエストスコープな値
  • 1つのリクエストが処理されている間に共有される
  • ユーザーID
  • 認証トークン
  • トレースのためにサーバ側でつける処理ID

パーサの理解を深めるためにやる。

参考。

• マークダウンパーサを作ろう - エムスリーテックブログ

最終的にフォーマッタにしたい。

• 複数行で継続するものと、行内だけで有効化されるものがある。基本的に行内
• 先頭行で効果を発揮するものと、囲むことで有効化するものがある

Goでインタプリタを書く本の続編。

Go Web プログラミング。

Goドキュメント。

GoのTips集。

言語仕様の日本語訳。

ゴルーチンの解説。

typeとstructの違いの解説。

GitHub Actionsですぐに実行できるようにする。

• workflow化する
• スターターパッケージを作成する

フォークをどう扱うか問題がある。自分は運用でカバーしてるけど。自分で使うには十分だけど、他の人に利用してもらうにはまだビミョー。

mainを使ってるので、バージョンを固定して安全に使えるようにする。

READMEのタグをmainにしてるので、バージョン番号にする。タグを切り替えると画像も変わるようにして、安全にする。安心して使えるようにする。

読みたいライブラリがmoduleで、直接実行できない。実行できないと、printデバッグもできない。テストでもできるか。だが引数が面倒なのだと大変。

ローカルimportの方法も一応知っておきたい。

• k1LoW/octocov

何か作っていて参考にするときは、よく読める。理解できる。が大雑把なスコープで「理解しよう」でやるとあまり進まない。

goclocはリポジトリのコード量を調べるツール。

• hhatto/gocloc: A little fast cloc(Count Lines Of Code)

参考になるところのメモ。

• 気軽にコマンド実行できるようにdockerイメージを用意する
• オプションの取り回し方。構造体に入れておく
• 結果を構造体に入れておく
• 本体とCLIは別packageになっている

気になる部分。

• 言語判定のライブラリを使っているみたいだが、大きな、割と雑なマップがある

CLIに色をつけるライブラリ。

• fatih/color: Color package for Go (golang)

別の色関係のライブラリが出てくる。何が違うのかわからない。

• mattn/go-colorable

https://github.com/kd-collective/color/blob/dbae876e45b9c53e464d101d63f4758c9f0bd8e8/color.go#L131-L137

https://github.com/kd-collective/color/blob/dbae876e45b9c53e464d101d63f4758c9f0bd8e8/color.go#L149-L157

なんだか地味に長いし、よくわからない。

reflectの解説。

Goを使ったサーバレスの解説。

平行処理の解説。

• 57
• デッドロックが発生するために存在しなければならない条件
  • 相互排他
    • ある並行プロセスがリソースに対して排他的な権利をどの時点においても保持している
  • 条件待ち
    • ある並行プロセスはリソースの保持と追加のリソース待ちを同時に行わなければならない
  • 横取り不可
    • ある並行プロセスによって保持されているリソースは、そのプロセスによってのみ解放される
  • 循環待ち
    • ある並行プロセス(P1)は、他の連なっている並行プロセス(P2)を待たなければならない。そしてP2はP1を待っている
• たいていの言語はCSPのメッセージパッシング形式よりもメモリを共有し同期するほうを好んでいる。共有メモリのモデルは正確に使うことが難しくなる
• GoでははじめからCSPを導入している
• syncパッケージは伝統的なメモリアクセス同期で並行処理を達成する。問題解決する平行処理の書き方を高水準(Goルーチン、チャネル)、低水準(sync)で選択できる
• プログラムを書く際にはある瞬間にただ1つのゴルーチンがある特定のデータの責任を持つように心がける。メモリを共有することで通信してはいけない。かわりに通信することでメモリを共有する
• Goのモットー「通信によってメモリを共有し、メモリの共有によって通信してはいけない」
• 何かしら結果を生成するコードがあり、その結果を別のコードに共有したい場合、これはデータの所有権を移動していることになる。ガベージコレクションをサポートしていない言語でのメモリの所有権と同じ考え方。データには所有権があり、平行プログラムを安全にする方法の1つとして、1度に1つの並行処理のコンテキストのみがデータの所有権を持つようにする。チャネルを使うと、この意図をチャネルの形で表現することで並行プログラムを安全にする構想を伝えることができる
  • 大きな利点は、バッファ付きチャネルを生成して、コストが低いインメモリのキューを実装し生産者(Producer)と消費者(Consumer)を切り離すことができる
• OSスレッドを使う言語では平行処理を抽象化する方法として便利なほかのパターンや実装方法がある。たとえばスレッドプール。こうした抽象化はたいていOSスレッドの補強や強化をする目的で作られていて、Goで使うことはあまりない
• 問題空間をゴルーチンに当てはめられるようにして、ワークフロー内の並行処理部分をうまく表現し、どんどんゴルーチンを起動する
• 他のコードに対して並行に実行している関数のこと(必ずしも並列ではない)
• ゴルーチンはコルーチンとして知られる高水準の抽象化

分散サービスの解説。

• 45, 94, 102, 199, 232

業務に役立つGoの解説。

Javaの世界では、親のコントロールクラスを継承して必要なメソッドを再定義しフレームワークから利用する、といった大規模なフレームワーク風のコーディングスタイルがあります。これはmain()関数が見えない、「ハリウッドの法則」にのっとったもので、一見コード量が少なく効率も良さそうに思えますが、フレームワークの進化が進めば進むほど、ソフトウェアの構造を考えて実装するという経験が得られず、「ソフトウェアの仕組みや開発技術を学ぶ」よりも「フレームワークの作法」を学ぶことが要求されるようになります。ジュニアな開発者でもレールから外れることなく、一定の成果をあげられるという利点がありますが、プログラマーとしての成長が難しいという欠点があります。

• Goでパフォーマンスに差があらわれがちなポイントはスライスとマップのメモリ確保
  • スライスはその実態として固定長の配列が確保されており、スライスはそれを参照する窓として使われメモリの読み書きが行われる
  • 長さが足りないといって好き勝手に拡張できない
  • 裏の配列に要素を追加し続けて割り当てられたサイズを使い果たした場合、Goのランタイムは新しくメモリを確保し、それに配列の内容をコピーして移動する
  • 確保しているメモリのことをキャパシティという。cap()で取得できる
• オーバーライド・継承のあるオブジェクト指向プログラミングではテンプレートメソッドパターンが一般的に用いられる
  • テンプレートメソッドパターン: フレームワーク側でロジックの大部分をにない、一部のカスタマイズ可能なポイントのロジックのみを変更する設計
• Goではテンプレートメソッドパターンを使用しない代わりにストラテジーパターンを用いる
• シンプルなインターフェースを使うAPI(Reader, Writerを引数にとる)をコアとして作り、それをラップして使いやすいAPIを別に提供するのが、Goで広く行われている設計方法
  • ユニットテストなどが行いやすい。
• 文法がシンプルだからこそ、どう使うかが重要になっている
• エラーのラップ、アンラップができる。たとえば「ファイルパスエラー」という低レベルなエラーをラップして「設定ファイルの読み込みエラー」とより抽象度の高いエラーで表現でき、必要に応じてアンラップし、詳細情報にもアクセスできる
• エラーのチェック忘れをkisielk/errcheckで確かめられる
• go install はgo.modに影響なくインストールできる。 go get はgo.modに反映する
• Goの場合、パッケージを相互依存の関係にできないことから、パッケージ連携ごとに同じような構造体を量産することになりコード量が増加する。まずはシンプルに、パッケージを細かく分割しないことを考える
• フォークしたGoプロジェクトはハッシュが異なるため、そのままでは依存関係に記述できない

簡単なゲームのチュートリアル。

ゲームのチュートリアル。

Ebitenでローグライクを作るチュートリアル。

Ebitenの小さなチュートリアル。

エミュレータの作り方の概要。

作り方の解説。

GoのAPIハンズオン。

Dockerコードの概略。

サーバ側Go, クライアント側Rubyと異なる言語を用いてサンプルアプリケーションを実装する。

わかりやすいという入門書。

• 27, 68, 73, 93, 148

ゼロから実装する。あまりピンとこない。

GoのGitHubアクセスのためのライブラリ。

実際の参考になる使用例。

• https://github.com/k1LoW/octocov/blob/main/gh/gh.go

Goのコンパイラの解説。

面白くためになる題材の紹介。

読み方。より深い理解のやりかた。

GoSpecは言語仕様書であり、全ての記述には意味があるはずです。

例えばTypesの章で導入される「全ての型にはunderlying typeがある」という概念は、一見すると「なんでこんなものを導入するんだ？？」と思うかもしれません。

(略)

しかし、このunderlying typeはassignability(代入可能性)を定義するために不可欠なものです(後述)。

このように「この記述はどこで役に立つの？」という意識を持つことで、全体像の理解につながります。

某書籍に「例示は理解の試金石」という言葉があります。

(略)

これは本当にそうで、読んだ内容を元に「こういうコードはこの記述を元に確かにこういう挙動をする」という例が作れるかどうかで理解の深さが段違いだという実感があります。

invoke_virtualのメソッド呼び出しで詰まっていた。

https://github.com/rodbate/jvm-on-go/blob/eb536d93317d0ef24ae9e2f298fd08b8ad4e49f8/pkg/rtda/method_ref.go#L27-L42

このへんが参考になるか。関数オブジェクトをハッシュに入れておいて、検索して呼び出せばいい。

Goのコントリビューションガイド。

Goにコントリビュートするチュートリアル。開発環境構築、Googleの規約へのサイン、変更、レビューまでの流れを全てカバーしている。わかりやすい。

• 388fbf287c

毎日たくさんのコミットがある。どういったことをやって、より良くしているのだろうか。コードの種類、議論の進め方。ファイルを見てイチから理解していくのは難しいが、差分から少しずつ見ていけば糸口がつかめるのではないか。また、プログラミング言語の場合、ライブラリでも全然違うはずなので調べる。

開発参加に必要な段階として、コードというより周辺知識をつければいいように見える。

• 未使用コード削除
• contextオプション追加
• オーバーフローを防ぐためuint型へ
• 画像変換の高速化
• 特定の条件でvendorモードに入るのを防ぐ
• cmd.StdinPipe()を使ってテストのsleepヘルパーを消す
• 特定のテスト失敗時のデバッグ情報を増やす
• メモリ効率の良いコードに置き換える
• OSごとに異なる部分の一部を修正する
• フレーキーテストを修正する
• テストのカバーしてない部分を追加する
• エラー時の挙動
• 意味のない中間変数の削除
• エラーコードの修正
• エラーコードの共通化
• 変数名の修正
• ドキュメントの修正
• Plan9での、ファイル並列アクセス
• バージョンによって異なる挙動部分のエラーについて、メッセージにバージョン情報を追加
• テストを並列にする
• 不要になったテストの削除
• 無限ループになってタイムアウトする問題の修正
• 便利関数を使う(strings.Cut) 2e054128bf
• tarのヘッダーにファイルサイズ制限をつける 0bf7ee9977

こうやって列挙してみると、多くの領域をカバーする必要はないことがわかる。取り組みやすいところや、集中的にやる領域を決めればよさそう。

issueを見てみる。これらがうまく解ければ楽なのだが。種類。今の段階でよくわからなくても、議論を見ることは調べる取っ掛かりになりそう。何を理解することがゴールになるのか、ということだ。散漫に読むより、ある問題があることを念頭において、仕組みを知ろうとするほうが頭に入る。解くために必要だからだ。

• go fmtのバグ
• 機能リクエスト
• フレーキーテスト

メモ。

• 経験豊富なプログラマーがどうやって問題解決しているかの生の資料になる。
• 全体をふんわりではなく、特定のコマンドに絞って知識を深める、問題に取り組むのがよさそう

開発を開始するには、まずGo自体をコンパイルする必要がある。そうでないと、テストも実行できない。

src/all.bash にシェルスクリプトがあり、それでコンパイルできる。実行にはgoが必要。goを使ってgoをコンパイルする。

$ cd src # カレントディレクトリがsrc下である必要がある
$ ./all.bash

手元でコンパイルしてgo処理系を最新にしてない場合、↓のような状態になる。

• テストを実行するとパッケージ関連で失敗する
• 実行できるテストもあるが、ソースコード(本体、テスト)への変更が全く反映されず、すべて成功する

$ go test -v package std/math/big arith_amd64.go:10:8: use of internal package internal/cpu not allowed

いじってテストを走らせたりビルドしても反映しない。通常であれば構文レベルになるものも無視される。別のソースコードを見ているぽい。本体コードについてはワーキングディレクトリではなく、マシンにインストールしてあるgoを使っている気がするな。テストが反映しないのはよくわからない。

• 手元ビルドした最新のgoへのパスが通っていないためだった。パスを通すと、テストを失敗させられるように
• どうしてテストが反映されないという結果になるのかわからない

cliアプリを作るライブラリ。

GoでCUIツールを作れるライブラリ。

CLIでDockerの状態を閲覧できるライブラリ。

Unixライクなインターフェースにするメリット・やり方。

filepathの本。

Goの読み物リスト。

Goのリポジトリトレンド。

Goの名前に関する解説。よく言われることがだが、標準ライブラリが参考になると書いてある。

Goのパッケージ構成や名前などの解説。実際のリポジトリを上げていてわかりやすい。

クリーンアーキテクチャの本。

ミドルウェアで返したレスポンスを取得する方法。

サーバ自体でAPIドキュメントを提供する方法。

openapi3filterの例。

メモ。

モックを極力しない流儀の、古典学派のテスト本。

Goの歴史。

理由が書かれている。

MacOSでの Go1.14のコンパイルにX Codeが必要なのは意図的でなかった。しばらくの間、誰もそれをバグとして気づかなかった。

タダのバックエンドサーバ。

goreleaserの使い方。

デバッグ方法の解説。

1.20の変更。比較可能な型。

Goツールチェイン。

go.modで指定するバージョンでは、Goツールチェーンを指定するわけではない。それを変えようという提案。

比較的わかりやすい、小さなバグ。

randの実装を効率が良いものに変える提案。

go pluginの例。

素数に9が含まれているのはタイポではなく、そういうジョークとのこと。

高品質なGoのチュートリアル。

ロブ・パイクによるGoのスライド。

Goのスケジューラを実装する。

わかりやすい説明。

• go get はgo.modに変更を加える
• go install はバイナリをインストールする

知らなかったな。

• プロダクトコードとテストは別パッケージしたほうがいい
  • はじめてのユーザになり、インターフェースや公開の状態を考えられるから
• 非公開な関数や変数をテストしたときは、テスト用にエクスポートすればいい

サーベイ結果。

proposal一覧。

Go言語のproposal。

Goで静的解析をする入門本。

GoのASTビューワー。

ソースコードの呼び出し関係をグラフィカルに表示する。

XMLからGoの構造体に変換するツール。

Goプログラマー、Youtuber。チャンネルは更新止まってるぽい。

Goの公式ブログ。

公式ドキュメント。

参考になるissue。バグ報告のうまいやり方。playgroundを使う。タイムアウトになるバグの原因。

Emacsのgo-modeでのフォーマット、定義ジャンプ、便利なさまざまな機能。

• C-c C-a でimportを追加できる

Goルーチンの解説。

手軽に使える。

Goのゲームライブラリ。

スライスの詳しい解説。

キャパシティは参照するメモリ配列の範囲。

画像処理やWebAssemblyなど。

ざっと読んだだけ。コードの中は読んでないので必要になったら確認する。

最初のチュートリアル。

小さなコマンドラインツールの例。

goとdockerの解説。

APIのサンプルコード。

• 117, 133, 141, 155

Go言語の入門本。

• Goでは、最初の文字が大文字で始まる名前は、外部のパッケージから参照できるエクスポートされた名前。例えばPiはmathパッケージでエクスポートされる

package main
import (
        "fmt"
        "math"
)
func main() {
        fmt.println(Math.pi)
}

• 変数が存在するメモリ上の位置を「アドレス」といい、そのアドレスを格納可能な変数を「ポインタ」という
• int 型変数のアドレスを格納できるポインタの型は *int 型というように、アスタリスクをつける

var ptr *int
var i int = 12345
ptr = &i

fmt.Println("iのアドレス:", &i)
fmt.Println("ptrの値(変数iのアドレス):", ptr)

fmt.Println("iの値:", i)
fmt.Println("ポインタ経由のiの値:", *ptr)

*ptr = 999
fmt.Println("ポインタ経由で変更したiの値:", i)

func main() {
        a, b := 1, 1

        double(a, &b)
        fmt.Println("値渡し:", a)
        fmt.Println("ポインタ渡し:", b)
}

func double(x int, y *int) {
        x = x * 2
        *y = *y * 2
}

関数リテラル。

func main() {
        val := 123

        // 関数リテラルの記述と呼び出しを同時に行う
        func(i int) {
                // 関数リテラル外の変数valにアクセス可能
                fmt.Println(i * val)
        }(10)

        // 関数リテラルを変数に代入
        f := func(s string) {
                fmt.Println(s)
        }

        f("hoge")
}

関数型。

func main() {
        // 関数型の変数宣言
        var f func(int, int) int

        // 関数リテラルの値を代入
        f = func(a int, b int) int {
                return a + b
        }

        // 関数型の変数経由で関数を呼び出す
        fmt.Println(f(1, 2))


        // 関数型の変数に値を代入
        f = multiply

        // 関数型の変数経由で関数を呼び出す
        fmt.Println(f(1, 2))
}

func multiply(x int, y int) int {
        return x * y
}

メソッドの宣言。

type myType int

// myType型をレシーバに持つ関数、すなわちmyType型のメソッドを宣言。レシーバは一番最初に書く
func (value myType) println() {
        fmt.Println(value)
}

func main() {
        // myType型の変数を宣言する
        var z myType = 1234

        // myType型のメソッドを呼び出す
        z.println()
}

メソッドのレシーバをポインタにする。

// int型
type myType int

func (value myType) setByValue(newValue myType) {
        // ここで値を代入しても無意味。Valueはコピーされるので
        value = newValue
}

func(value *myType) setByPointer(newValue myType) {
        // 代入した値が反映される
        *value = newValue
}
func main() {
        var x myType = 0

        // レシーバは値。値は変更できない
        x.setByValue(1)
        fmt.Println("値: 0 ->", x)

        // レシーバはポインタ。値は変更できる
        x.setByPointer(2)
        fmt.Println("ポインタ: 0 ->", x)
}

構造体型に名前をつける。

type MyData struct {
      s string
      b byte
}

• メソッドの宣言には値レシーバ、ポインタレシーバの2つがある。混在させるべきではない
  • 変数レシーバではメソッドの操作は元の変数のコピーを操作する
  • ポインタレシーバでは、ポインタを使うので元の変数を変更できる
• ポインタレシーバを使う2つの理由
  • メソッドがレシーバが指す先の変数を変更するため
  • メソッドの呼び出しごとに変数のコピーを避けるため

匿名フィールド。匿名フィールドが持つフィールドとメソッドが、埋め込み先の構造体型にも実装されているかのように扱われる。Go言語には型の実装はないが、構造体に他の型を埋め込むことで継承似たようなことを実現できる。

// 埋め込まれる型の構造体
type embedded struct {
        i int
}

// embedded型のメソッド
func (x embedded) doSomething() {
        fmt.Println("test.doSomething()")
}

// 埋め込み先の構造体
type test struct {
        embedded // embedded型の埋め込み
}

func main() {
        var x test

        // embedded型に実装されているメソッドに、test型の値でアクセス
        x.doSomething()

        // embedded型のフィールドに、test型の値でアクセス
        fmt.Println(x.i)
}

構造体の初期化。

type Person struct {
        name string
        age int
}

func main() {
        // 構造体リテラルを使用せず、フィールドを個別に初期化
        var p1 Person
        p1.name = "Jhon"
        p1.age = 23

        // 構造体リテラルで初期化
        p2 := Person{age: 31, name: "Tom"}
        p3 := Person{"Jane", 42}
        p4 := &Person{"Mike", 36}
        fmt.Println(p1, p2, p3, p4)
}

埋め込みを行った構造体を構造体リテラルで初期化する。

type Person struct {
        name string
        age int
}

type Employee struct {
        id int
        Person // 埋め込み
}

func main() {
        e := Employee{1, Person{"jack", 28}}
        fmt.Println(e)
}

Go言語のインターフェースの役割は「振る舞い」を規定すること。Go言語のインターフェースは「インターフェース」と「それを実装した型」との関係性を明示的に記述する必要がない。インターフェースに定義されている関数をメソッドとして実装している型は、自動的にそのインターフェースを実装していることになる。

type Calculator interface {
        // 関数の定義
        Calculate(a int, b int) int
}

type Add struct {
        // フィールドは持たない
}

// Add型にCalculatorインターフェースのCalculator関数を実装
func (x Add) Calculate(a int, b int) int {
        return a + b
}

type Sub struct { }

func (x Sub) Calculate(a int, b int) int {
        return a - b
}

func main() {
        var add Add
        var sub Sub

        var cal Calculator // interface

        cal = add // interfaceを満たす関数を持っているので、自動的にインターフェースを実装していることになり、代入できる
        fmt.Println("和:", cal.Calculate(1, 2))

        cal = sub
        fmt.Println("差:", cal.Calculate(1, 2))
}

空インターフェース。関数を持たない空のインターフェース。定義関数をすべて実装している型はインターフェースを実装したことになるので、すべての型は空インターフェースを実装していることになる。

var empty interface {}

empty = "abc"
empty = 12345
empty = 3.14

_ = empty

関数を1つしか持たないインターフェースの場合、そのインターフェース名は「関数名+er」とするのが慣わし。

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

型アサーションはインターフェース型の値を他の型へ変換するとき、または変換できるか確認するときに使う。

func main() {
        // 空インターフェースにstring型の値を格納
        var i interface{} = "test"
        // 型アサーションを使いstring型へ
        var s string = i.(string) // 型アサーション
        fmt.Printf("i: %T\n", i)
        fmt.Printf("s: %T\n", s)
}

型アサーション失敗時にランタイムパニックを発生させない。チェックに使う。

func main() {
        // 空インターフェースにstring型の値を格納
        var i interface{} = "test"

        // 型アサーションに成功する例
        s1, ok := i.(string)
        fmt.Println(s1, ok)

        // 型アサーションに失敗する例
        // string型はdummyメソッドを持たないので変換できない
        s2, ok := i.(interface {
                dummy()
        })
        fmt.Println(s2, ok)
}

型switch文。通常のswitch文とは異なる。式switchが値によって分岐するのに対し、型switch文は値が持つ型によって分岐する。

func main() {
        showType(nil)
        showType(12345)
        showType("abcdef")
        showType(3.14)
}

func showType(x interface{}) {
        switch x.(type) {

        case nil:
                fmt.Println("nil")

        case int, int32, int64:
                fmt.Println("整数")

        case string:
                fmt.Println("文字列")

        default:
                fmt.Println("不明")
        }
}

配列アクセス。

func main() {
        var date [7]string

        date[0] = "日曜日"
        date[1] = "月曜日"
        date[2] = "火曜日"
        date[3] = "水曜日"
        date[4] = "木曜日"
        date[5] = "金曜日"
        date[6] = "土曜日"

        // indexバージョン
        for i := 0; i < len(date); i++ {
                fmt.Print(date[i], " ")
        }

        // rangeバージョン
        // 改行
        fmt.Println()

        for _, value := range date {
                fmt.Print(value, " ")
        }

        fmt.Println()
}

• スライス → 可変長
• 配列 → 非可変長

スライス式。

func main() {
        // 配列を宣言
        x := [5]string{"a", "b", "c", "d", "e"}
        // スライス型の変数を宣言
        var s1 []string

        // 配列全体をスライス
        s1 = x[:]
        fmt.Println(s1)

        // インデックス1~3までをスライス
        s2 := x[1:4]
        fmt.Println(s2)

        // インデックス3~をスライス
        s3 := x[3:]
        fmt.Println(s3)

        // インデックス1~3をスライス
        s4 := x[:4]
        fmt.Println(s4)
}

スライスは「参照型」の1つ。Go言語にはスライス、マップ、チャネルという3つの参照型がある。データの実体を持たず、データへの参照情報しか持たない。

スライスを可変長パラメータに直接受け渡す。

func main() {
        s := []string{"a", "b", "c"}

        // 以下2つの結果は同じ
        test(s...)
        test("a", "b", "c")
}
func test(s ...string) {
        fmt.Println(len(s), s)
}

エラーハンドリング。

func main() {
        file, err := os.Open("test.txt")

        if err != nil {
                fmt.Println(err.Error())
                // os.Exit(1)
        }

        file.Close()
        fmt.Println("finish")
}

独自のエラー処理。

        type MyError struct {
                message string
        }

        func (err MyError) Error() string {
                return err.message
        }

      func main() {
          val, err := hex2int("1")
          fmt.Println(val, err)

          val, err = hex2int("00000f")
          fmt.Println(val, err)

          val, err = hex2int("abcd")
          fmt.Println(val, err)

          val, err = hex2int("z")
          fmt.Println(val, err)
    }

// 16進数文字列をint型に変換する
  func hex2int(hex string) (val int, err error) {
        // 1文字づつ取り出す
      for _, r := range hex {
            val *= 16
            switch {
                  case '0' <= r && r <= '9':
                  val += int(r - '0')
                  case 'a' <= r && r <= 'f':
                  val += int(r-'a') + 10
                  default:
                  return 0, MyError{"不正な文字列です。" + string(r)}
            }
      }

      // 戻り値errには初期値であるnilが返る
      return
}

処理終了。

func main() {
        f1()
}

func f1() {
        panic("パニック発生 ")
}

チャネルはGoプログラムの中の通信機構で、ゴルーチン間における通信、同期、値の同期に使用する。

func main() {
        c := make(chan int, 10)
        c <- 0

        fmt.Println("cap:", cap(c))
        fmt.Println("len:", len(c))
}

selectは複数のチャネルに対して同時に送受信待ちを行うときに使用する。

goとdocker。

環境変数、カラー、インジケータ。

clonerのgoバージョンを作成する。

goclocを読んでいると、gcloneのひどい書き方が目につく。型、構造体の使い方、ファイルやモジュール分割。一通り完了。非常に勉強になった。

GoのIOの解説。

os.File型のReadメソッドは以下のような実装となっています。

1. os.file型のReadメソッドを呼ぶ
2. 1の中でos.file型のreadメソッドを呼ぶ
3. 2の中でpoll.FD型のReadメソッドを呼ぶ
4. 3の中でsyscall.Readメソッドを呼ぶ
5. OSカーネルのシステムコールで読み込み処理

• networkもI/Oと捉えられる。コネクションからデータを読み取る・書き込むといえるから
• Linuxの設計思想として“everything-is-a-file philosophy”というものがある。キーボードからの入力も、プリンターへの出力も、ハードディスクやネットワークからのI/Oもありとあらゆるものをすべて「OSのファイルシステムにあるファイルへのI/Oとして捉える」という思想。ネットワークからのデータ読み取り・書き込みも、OS内部的には通常のファイルI/Oと変わらない。そのため、ネットワークコネクションに対しても、通常ファイルと同様にfdが与えられる
• ファイル読み込みでもネットワークコネクションでも、システムコールsocket()を呼んで、fdを取得し、fdを内部フィールドに含んだ型を生成するところは共通
• リスナーからコネクションを得る = リスナーからfdを取り出して、それをTCPConnにラップする

ファイルサイズの増分、各所要時間を表示する。

ダウンロードしているとき先にリポジトリ名を表示して、あとから結果に応じて記号をつける。

github@gclone... ✔ (10s)
github@go............ ✗ (0.6s)
...
40.4s
10.1G

インラインに表示するのがむずかしい。spinnerとコンフリクトしてるのか。

アイデア。

• 言語別のリポジトリ数、行数、コミット数
• シールド
  • 定期的にGitHub Actionsでビルドすることで、数値を画像に反映させる
• データストア用リポジトリという考え方を深める(octcovやupptime的な)
  • 汎用的なデータストアとして用いる
  • 別リポジトリから簡単に扱えるworkflowを作成する
  • データストアリポジトリのURLと、キーによって、保存する
  • データを元に画像なり生成して、時系列を見られるようにする
• リポジトリ一覧を作る。コミット数、言語情報を一覧する
• データストアに保存、加工しやすい形にする
• 画像/jsonで出力する
• 他サイトに貼れるようにする

総コミット: 5000

| 名前     | 概要           | 言語       |
|----------+----------------+------------|
| .emacs.d | emacs dotfiles | Emacs Lisp |
| dotfiles | system config  | Shell      |
| gclone   | git clone tool | Go         |

| 言語         | リポジトリ数 | コミット数 |
|------------+--------------+------------|
| Go         |            4 |        100 |
| Ruby       |            5 |        200 |
| Emacs Lisp |            2 |        100 |

• 汎用的なデータストアリポジトリ(配信用)。ツールを実行して更新する
• CLIツール
  • 情報取得
  • json出力
  • 画像出力
  • README.md出力
  • コミット機能
• フロントエンド

言語別の色の丸画像を生成するパッケージ。

1. keyだけを別のスライスにして、ソートする。
2. keyをイテレートして、mapの中身を取り出す

ほかの形も追加する。

• golang/go: The Go programming language
• TestStdErrorHander
• hexdecimal

• 31, 42, 45, 52, 75, 86, 105, 115, 162, 184, 238, 252, 297

インタプリタを実装する。

• 字句解析フェーズが文字列をトークン列に変換
• 構文解析フェーズがトークン列をASTに変換
• マクロ展開フェーズがASTを受け取り、修正して、返却
• 評価

一通りやったが、あまり腑に落ちてない。部分的なコードの多くは読んで理解できたが、自分で別のことに利用したり、拡張は全くできそうにない。

動画検索アプリを題材に、NuxtとGoを使ったアプリ開発をやる本。

ところどころSDKのバージョンの違いで本の記述では動かないところがある。どこか間違ったらしく、jsonトークンを受け取る箇所がうまくできない。Firebaseへのログイン状態を判断する箇所がうまくいってないので、データベースの動きも確かめられていない。

バックエンドGo, フロントReactで作る。

• kijimaD/golife: implement Conway’s Game of Life

整形の方法を読む。

主要な関数を見ていく。

https://github.com/golang/go/blob/51af90445696772703ed88d967e8c23c8e9e992d/src/cmd/gofmt/gofmt.go#L229

1. ファイル読み込み
2. ast取り出し
3. フォーマット
4. 差分があれば、結果に対する各種処理
   • 複数ファイルオプションがあれば、ファイル名をプリント
   • 書き込みオプションがあれば、ファイルに書き込み。最初にバックアップを別ファイルに保存し、目標ファイルへの上書きにエラーがあれば戻せるようにする。エラーがなかった場合は完了
   • 差分表示オプションがあれば、差分をプリント

https://github.com/golang/go/blob/51af90445696772703ed88d967e8c23c8e9e992d/src/cmd/gofmt/gofmt.go#L387

疑問。

• fdSem とは
  • fdSem guards the number of concurrently-open file descriptors.
  • file descriptor semaphore か。セマフォとは、同時実行を制御する仕組み
  • 定義の make(chan bool, 200) はバッファ作成。チャネルに一時データを保存する
  • fdsem <- true は入れる
  • <-fdSem は取り出し
  • ファイル関係の処理が入るときにfdSemをコントロールして、file descriptorの上限を超えないようにしている
• weight とは
  • maxWeightはコア数の環境変数から計算した値を使う
  • maxWeightは最大の同時接続数のことで、weightはその接続数のカウントのこと。接続が増えるとカウントが減り、0になるとほかのゴルーチンは並列実行できない
  • weightはファイルサイズから計算する
  • ファイルサイズによって同時実行数を制御する…ということか。あまりピンとこない
• sequencer とは
  • スライス等ではないが、prevフィールドで辿れるグループピング構造に見える
  • weight, ファイル処理を含む無名関数が入っている
  • エラーを出す無名関数を入れることもある

結局全然ピンと来てない。

まずバッファの概念を理解することが必要そう。解説してあった。こういうのを自分でコードから調査できるようになりたい。

• bufioパッケージによるbuffered I/O｜Goから学ぶI/O

あるバイト数に達するまでbufioの内部バッファにためておく処理がある。それが普通のbufioとioの違い。

https://github.com/golang/go/blob/122a22e0e9eba7fe712030d429fc4bcf6f447f5e/src/bufio/bufio.go#L662-L685

ノウハウ集。通読するものというよりは、好きな箇所をつまみ食いする本。

必要になったので参考にする。

デザインパターンの紹介。

テスト駆動開発によるGo入門。動かしてわかりやすいだけでなく、後の学習に役に立ちそうな言葉も多い。

• 標準ライブラリを使ってみるときにテストで動作チェックしてみると、勉強になる

Go標準ライブラリは本当に良いです。時間をかけて勉強してください。 このようにio.Writerインターフェースにある程度慣れていることで、テストでbytes.Bufferを Writerとして使うことができ、標準ライブラリの他のWriterを使ってコマンドラインアプリやウェブサーバで関数を使うことができます。 標準ライブラリに慣れるほど、これらの汎用インターフェイスが表示され、独自のコードで再利用して、ソフトウェアをさまざまなコンテキストで再利用可能にすることができます。

システムの実行にとって実装が本当に重要でない限り、テストが有用な動作をチェックするようにしてください。

• リファクタリングの定義では、コードは変更されますが、動作は同じです。理論的にリファクタリングを行うことに決めた場合は、テストを変更せずにコミットを実行できるはずです。だからテストを書くときは自問してください
  • 必要な動作や実装の詳細をテストしていますか？
  • このコードをリファクタリングする場合、テストに多くの変更を加える必要がありますか？
• テストが3つ以上のモックで動作している場合、それは危険信号であるように感じます（デザインを再検討する時間）

TDDアプローチの詳細

• ささいな例に直面した場合は、問題を「薄いスライス」に分解してください。ウサギの穴に入り込み、「ビッグバン」アプローチをとらないように、できるだけ早く_testsで動作するソフトウェアを使用できるようにしてください。
• 動作するソフトウェアを入手したら、必要なソフトウェアにたどり着くまで小さなステップで繰り返すのが簡単です。

都度printするのではなく、貯めておいて、表示する箇所で整形して表示したい。表示部分と処理が分離される効果もある。何か公開されているツールを参考にすればできそう。

• 単純に1階層の結果であれば、構造体に入れて普通に返せばいい
• 複数階層であれば、工夫が必要そう

[python 2/4]RUN pip3 install
[build  2/13] COPY . .

スコープの解説。

スコープには4つの種類がある。

• ユニバース
• ファイル
• パッケージ
• ローカル

それぞれの種類のスコープでは以下のオブジェクトが定義できる。

比較可能な型の説明。

• 比較可能
  • 真偽値
  • 整数値
  • 浮動小数点値
  • 複素数値
  • 文字列
  • ポインタ
  • チャネル
  • インタフェース
    • 動的型と動的値の2つから構成される
    • 動的型が %T verbで表示できる
  • 構造体(条件あり)
  • 配列(条件あり)
    • 構成するフィールドや要素に比較できない型がある場合は比較できない
• 比較可能の場合、 == 演算子、 != 演算子で比較できる。
• 順序付け可能な場合はさらに < , <= , > , >= が使用できる

var x, y any = 100, 200
fmt.Println(x == y)

var x, y any = int(100), int32(100)
fmt.Println(x == y)

まとめ。

• 動的型が違う場合は必ずfalse
• 動的型が同じでどちらかの動的型が比較不可能な場合はパニック
• 動的型が同じでcomparableでかつ動的値が同じ場合はtrue
• 動的型が同じでcomparableでかつ動的値が違う場合はfalse

• kijimaD/oav

検知してない疑惑。問題なかった。

• type: objectをつけてない項目があった
• その項目はarrayだけを子に持っていた。そのため、自身のtypeもarrayになっていた
• おそらく、子の項目で自身のtypeが決定する。ほとんどは複合型で、objectに自動で決定して問題ないが、今回のように問題があるケースがある

途中まで読んだが、あまりおもしろくないので後回しにする。

システムプログラミングをGoで学ぶ本。

• まずデバッガ環境を整えることから
• ファイルディスクリプタに対応するものは、通常のファイルに限らない。標準入出力/ソケット/OS/CPUに内蔵されている乱数生成の仕組みなど、ファイルではないものにもファイルディスクリプタが割り当てられ、どれもファイルと同じようにアクセスできる
• OSは、プロセスが起動されるとまず3つの疑似ファイルを作成し、それぞれにファイルディスクリプタを割り当てる。0が標準入力、1が標準出力、2が標準エラー出力
• 可能な限りすべてのものがファイルとして抽象化されている
• go言語ではファイルディスクリプタのような共通化の仕組みを言語レベルで持ってOSによる差異を吸収している。io.Writer
• インターフェースは、構造体と違って何かしら実体を持つものを表すのではなく、「どんなことができるか」を宣言しているだけ
• リクエストではスロースタートによって、最適な速度を決定している。大きなファイル転送するときに徐々に速度が上がっていくのはこのためか
• Linuxのファイルの管理情報を格納している領域を、inodeという
• Linuxでファイルを読み書きする場合には、まずバッファにデータが格納される。すでにバッファに載っていて、そのファイルに対する書き込みが行われていないならバッファだけにしかアクセスしない
• .envファイルを利用するアイデアは、Railsでの発明らしい
• OSが実行ファイルを読み込んで実行するには、そのためのリソースを用意しなければならない。そのようなリソースをまとめたプログラムの実行単位がプロセス
  • カーネルは新しいプロセスを作るたびに各プロセスでどういった入出力が行われるかの管理テーブルをつくる。そのインデックス値がファイルディスクリプタ
• プロセスを束ねたグループというものもある。プロセスグループ(別名ジョブ)。パイプを使うと同じプロセスグループになる
• シグナルはプロセスに対して送られる
• プロセス → OSカーネル
• OSカーネル → プロセス
• スレッドがCPUコアに対してマッピングされるのに対し、goroutineはOSのスレッドにマッピングされる
• goroutineはOSのスレッドと比較してタスク切り替えのコストが低い
  • スイッチには前の処理が使っていたレジスタの退避が必要になるが、退避が最小限が済むコード位置にスイッチのためのコードが埋め込める
  • 初期スタックメモリのサイズが小さい。メモリ確保は処理時間がかかるので、起動時間では小さいほうが有利
  • などによって、goroutineは起動時間、切り替え時間がOSのスレッドより1000倍のオーダーで高速
  • Goが提供する並行・並列処理の3要素
    • goroutine: 実行
    • チャネル・コミュニケーション
    • select: 調停
  • 並行・並列処理の実現手法
    • マルチプロセス
    • イベント駆動
    • マルチスレッド
    • ストリーミング・プロセッシング
  • スライスの裏には配列がある。実際には配列を参照するウィンドウ(対象の配列のスタート位置，終了位置、確保済みのサイズの3つの情報を持つ)で構成されている
  • バックエンドの配列に対し、使いやすいフロントエンドとして提供されているのがスライス
  • スライスの実態は3つの数値とポインタを持った24バイトのデータ
    • スライスの先頭の要素へのポインタ
    • スライスの長さ
    • スライスが確保している要素数

言語の仕様書。

• リテラルってなんだ
  • リテラル - Wikipedia
  • ソースコード内に値を直接表記したもの
    • int x = 7; だと7
    • double pi = 3.14; だと3.14
    • string s = "hello"; だと“hello”
  • トークンとは違うのかな。トークンは値だけでなく識別子や予約語も含む
  • リテラル（直値）とは - 意味をわかりやすく - IT用語辞典 e-Words
  • リテラルとは、コンピュータプログラムのソースコードなどの中に、特定のデータ型の値を直に記載したもの。また、そのように値をコードに書き入れるために定められている書式。
• セレクタってなんだ
  • x.f は値 x のフィールド f 、またはメソッド f を示す
• 定義型(defined type)ってなんだ
  • 事前定義された型か、独自に定義された型
  • type S []int の S
  • type T int の T と int
  • defined typeでない型は複合型
• 型リテラルってなんだ
  • Goの型同一性を理解する
  • 他の型を利用して構成される型
  • var a [5]int における[5]int
  • type B int (Bは型名)
  • var b []B における[]B
  • リテラル中に他の型が使われない、func()や、struct{}といった型リテラルも存在する
  • 型リテラルを使って示される型は、型定義が行われていないためdefined typeではない
  • 型リテラルの種類
    • 要素型を持つ
      • 配列型
      • スライス型
      • マップ型
      • チャンネル型
    • キー型を持つ
      • マップ型
    • フィールド型を持つ
      • 構造体型
    • ベースの型を持つ
      • ポインタ型
    • 仮引数型、結果型を持つ
      • 関数型
  • 型リテラルによって示される型同士が同一かどうかを判定するには、型リテラルの構造が同一かつ、型リテラル中に現れる型が同一であることを確認する必要がある
  • 型リテラルごとに、同一性の条件がある
  • インターフェース型は任意の型を使って構成されるわけではない。インターフェース型はメソッドを持ち、それぞれのメソッドは関数型を持つ
• underlying type(基底型)ってなんだ
  • すべての型はunderlying typeを持つ
  • 事前に定義された型や、型リテラルによって示される型のunderlying typeはその型自身
    • int -> 基底型: int
    • string -> 基底型: string
    • []int -> 基底型: []int
    • struct{} -> 基底型: struct{}
  • それ以外の型のunderlying typeは型宣言の対象によって決まる
  • 2つの型宣言
    • type A string -> 型宣言
      • type A string -> Aの基底型: string
      • type B A -> Bの基底型: string
      • type C []int -> Cの基底型: []int
    • type B = int -> エイリアス宣言
      • type A string -> defined type
      • type B = A -> Bの基底型: string
      • type C = []int -> Cの基底型: []int
  • 2つの型のいずれもdefined typeでない場合、それぞれの型のunderlying typeの型リテラルが構造的に等しい場合に同一となる
    • defined typeでない型とは、型リテラルと型エイリアス
    • 型リテラルのunderlying typeはその型リテラル自身
    • 型同一性においてunderlying typeの考慮が必要なのは型エイリアスのみ
    • type NamedMap = map[string][]int
      • NamedMapの基底型はmap[string][]int
      • m1とm2はunderlying typeの型リテラルの構造が同一なので同一
      • var m1 map[string][]int
      • var m2 NamedMap
• 参考になる用語 [Go] 言語仕様書に出てくる型関連の用語まとめ
• Go言語のdefined typeとは何か
• 修飾識別子
  • パッケージ名をつけて修飾された識別子
  • PackageName “.” identifier .
  • 修飾識別子は、インポートされなければならない
• runeの例で白鵬が出てきて笑う
  • https://github.com/golang/go/blob/20e9b7f1b53d49fd66e0344b1d0d42d3cf5e47b6/doc/go_spec.html#L5624
• 終端文
  • return, goto, panic…
• 式文(expression statements)
  • 関数呼び出しとメソッド呼び出しと受信演算は、文コンテキストに現れる。そのような文は、丸括弧で囲まれている必要がある
• アドレス演算子
• ポインター間接参照
• 誤字
  • 自薦宣言
  • 関数内え
  • キーを全く含まないは要素リスト
  • ある要素がキーをもつならば，すべて要素が
  • 関数はリテラルは
  • ようそが要素が
  • 定数インデック
  • インデックは
  • 次の関係を満足する
  • 連続した要素がその文字列のバイトたち
  • であるスライスを生成される
  • 結合性を上書して
  • fStmt =
  • 仕様できる
  • 文囲む親関数
  • じたがって
  • を満足する
  • を基準としたの

Go コンパイラについての公式ドキュメント。

いろんなWebアプリの紹介。

• sync.Once型を使うと関数が1回しか実行しないことを保証できる
• Newメソッド, Offメソッド, Tracerインターフェース

呼び出される時点ではまだ利用できない値に依存しているということがわかりました。そこで、何らかの対策が必要になります。例えば、必要なフィールドを個別に引数として渡すという変更が考えられます。しかし、こうするとインタフェースが不安定なものになってしまいます。いずれかのAvatarの実装で新しい種類の情報が必要になるたびに、メソッドのシグネチャーを変更しなければならなくなるためです。代わりに、Avatarの実装が必要とする情報をカプセル化した新しい型を定義することにします。

• メッセージが送信されるたびにアバター画像URLを生成するとスケールしない。アバターURLはクッキーの中にキャッシュすることにする

エンコードの解説。

• インメモリ表現
  • 何らかの構造を持つことを前提とした扱い方
    • リスト
    • 配列
    • 構造体
• バイト列表現
  • ただのバイト列として扱い。データそのものに何が書いてあるかを気にする必要がない
  • ファイルへの書き込み
  • ネットワークへの受信

エンコードはインメモリ表現からバイト列表現への変換のこと。

• Go構造体からjsonを生成する
• 平文から暗号文を生成する

デコーディングはバイト列表現からインメモリ表現への変換のこと。

• jsonからGo構造体を生成する
• 暗号文から平文を生成する

Unmarshalは、対応してないjsonのフィールドがあると取りこぼす。そしてゼロ値を入れる。この挙動を防ぎたいときは、Unmarshalで書き込む先の変数をinterface{}型にして入れ、それから型アサーションで確かめればよい。

Goの標準パッケージを詳解する本。

Goの解説集。

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/rt0_linux_amd64.s#L7-L8

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/asm_amd64.s#L15-L18

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/proc.go#L115

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/runtime2.go#L414

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/asm_amd64.s#L183-L187

TLS

Thread Local Storage

(no term)

runtimeまわりでは g はgoroutine、 m はワーカースレッドをさす

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/os_linux.go#L346-L368

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/proc.go#L694-L779

https://github.com/golang/go/blob/a031f4ef83edc132d5f49382bfef491161de2476/src/runtime/proc.go#L131-L132

• デバッガでステップインしたあとパブリックな関数を見つけて、それを呼び出すようにすると再度デバッガを実行するときに素早く目的の関数までたどり着きやすくなる。変数まわりを調べて同じ引数で渡せるようにする

Goを学んだ初期に書いた。わかりにくいコードになっているのを直す。

Goのサーバーの解説。

https://github.com/kd-collective/go/blob/2eca0b1e1663d826893b6b1fd8bd89da98e65d1e/src/net/http/server.go#L2503-L2515

前回途中でわからなくなったので、また読み始めた。