List of Golang [text.Baldanders.info]

バージョンの埋め込みと表示

2026-07-17T09:15:52+00:00

まずは，こんな感じにバージョン情報を表示するコードを考える。

package main

var Version = "v1.2.3"

func main() {
    println(Version)
}

これを実行すれば v1.2.3 と表示される。

実際の運用としてバージョンが上がるたびに変数 Version の内容を書き換える必要がある。また Git でソースコード管理する場合はリリースバージョンに対してバージョンタグを付けることが多いので，それとの整合を保つ必要がある。実はこれが割と煩雑な作業なのである。

そこで Go でビルドしたツールのバージョン表記について，以下の2つの方法を記しておく。

ビルド時にバージョン文字列を埋め込む

これは割と昔からある方法で， go build コマンドの -ldflags オプションを使って変数に値を埋め込む。

$ go build -ldflags="-X main.Version=v9.9.9" -o a.out

$ ./a.out
v9.9.9

Git でバージョンタグを打っている場合は

$ go build -ldflags="-X main.Version=`git describe --tags`" -o a.out

などと Git コマンドの出力を埋め込む手もある（bash シェルの場合）。

もしビルドに GoReleaser を使っているのであれば .goreleaser.yml の中で

builds:
-
  ldflags: -X main.Version=v{{ .Version }}

のように書くことで対応できる。

GoReleaser はマルチプラットフォームのコマンドラインツールで，複数プラットフォーム向けの実行バイナリを一度に作ってくれるので重宝している。また GitHub Actions にも対応していて，ビルドしたバイナリを GitHub Release に自動でアップロードし，リリースノートまで書いてくれる。ホンマ助かる。

ただし，この方法は go install では使えないし，そもそもユーザに「go build 時に -ldflags でバージョンを埋め込んでね」とお願いするのもおかしな話である¹。

ビルド情報を表示する

これは Go 1.18 から追加されたらしいのだが runtime/debug パッケージの ReadBuildInfo() 関数を使うと，ビルド時の情報を取得できる。たとえば，こんな感じ。

package main

import "runtime/debug"

var Version = ""

func replaceVersion(v string) string {
    if v != "" {
        return v
    }
    if info, ok := debug.ReadBuildInfo(); ok {
        if info.Main.Version != "" {
            return info.Main.Version
        }
        var revision, dirty string
        for _, v := range info.Settings {
            switch v.Key {
            case "vcs.revision":
                revision = v.Value
            case "vcs.modified":
                if v.Value == "true" {
                    dirty = "+dirty"
                }
            }
        }
        if revision != "" {
            return revision + dirty
        }
    }
    return "(version not set)"
}

func main() {
    println(replaceVersion(Version))
}

debug.ReadBuildInfo() 関数の返り値である BuildInfo 構造体の内容は以下の通り。

type BuildInfo struct {
    // GoVersion is the version of the Go toolchain that built the binary
    // (for example, "go1.19.2").
    GoVersion string `json:",omitempty"`

    // Path is the package path of the main package for the binary
    // (for example, "golang.org/x/tools/cmd/stringer").
    Path string `json:",omitempty"`

    // Main describes the module that contains the main package for the binary.
    Main Module `json:""`

    // Deps describes all the dependency modules, both direct and indirect,
    // that contributed packages to the build of this binary.
    Deps []*Module `json:",omitempty"`

    // Settings describes the build settings used to build the binary.
    Settings []BuildSetting `json:",omitempty"`
}

Module 構造体はこんな感じかな。

type Module struct {
    Path    string  `json:",omitempty"` // module path
    Version string  `json:",omitempty"` // module version
    Sum     string  `json:",omitempty"` // checksum
    Replace *Module `json:",omitempty"` // replaced by this module
}

つまり go.mod でモジュールとして定義・管理されている場合は BuildInfo.Main.Version にバージョンが入っている。

作成した replaceVersion() 関数を含むコードを Git で commit し v0.1.0 のバージョンタグを打った状態でビルド&実行すると以下のように表示された。

$ go build -o a.out && ./a.out
v0.1.0

ちなみに go.mod でモジュールとして定義されている場合でも，バージョン管理されていない場合は (devel) という文字列が返ってくるようだ。

$ go build -o a.out && ./a.out
(devel)

replaceVersion() 関数では BuildInfo.Main.Version で値を取れない場合には BuildInfo.Settings 配列から情報を取得している。 BuildSetting 構造体は以下の通り key-value 形式になっている。

type BuildSetting struct {
    // Key and Value describe the build setting.
    // Key must not contain an equals sign, space, tab, or newline.
    Key string `json:",omitempty"`
    // Value must not contain newlines ('\n').
    Value string `json:",omitempty"`
}

このうち Key には以下の値が入ってるらしい。

Key の値	Value の内容
`-buildmode`	the buildmode flag used (typically `"exe"`)
`-compiler`	the compiler toolchain flag used (typically `"gc"`)
`CGO_ENABLED`	the effective `CGO_ENABLED` environment variable
`CGO_CFLAGS`	the effective `CGO_CFLAGS` environment variable
`CGO_CPPFLAGS`	the effective `CGO_CPPFLAGS` environment variable
`CGO_CXXFLAGS`	the effective `CGO_CXXFLAGS` environment variable
`CGO_LDFLAGS`	the effective `CGO_LDFLAGS` environment variable
`DefaultGODEBUG`	the effective `GODEBUG` settings
`GOARCH`	the architecture target
`GOAMD64/GOARM/GO386/etc`	the architecture feature level for `GOARCH`
`GOOS`	the operating system target
`GOFIPS140`	the frozen FIPS 140-3 module version, if any
`vcs`	the version control system for the source tree where the build ran
`vcs.revision`	the revision identifier for the current commit or checkout
`vcs.time`	the modification time associated with `vcs.revision`, in RFC3339 format
`vcs.modified`	`"true"` or `"false"` indicating whether the source tree had local modifications

replaceVersion() 関数では VCS (Version Control System) のリビジョン情報（vcs.revision および vcs.modified）を使ってバージョンを表示している。ここまで至れり尽くせりなら，大抵のパターンで使えるだろう。

go run ではビルド情報がセットされない

以上は go build あるいは go install でビルドした場合の話だが go run で即時実行した場合はビルド情報がセットされないようだ。先程のコード例の場合は

$ go run main.go
(version not set)

と表示されビルド情報からバージョンを取得できなかったことが分かる。まぁ go run による実行でバージョンを気にする人はいないと思うので，これはこれで問題ないだろう。

ブックマーク

参考図書

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

[Comment] 著者のひとりは（あの「バイブル」とも呼ばれる）通称 “K&R” の K のほうである。この本は Go 言語の教科書と言ってもいいだろう。と思ったら絶版状態らしい（2025-01 現在）。復刊を望む！

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

[Comment] 版元で PDF 版を購入可能。事実上の Effective Go とも言える充実の内容。オリジナルは敢えてタイトルに “tips” という単語を入れるのを避けたのに邦題が「100 Tips」とかなっていて，原作者がお怒りとの噂（あくまで噂）

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

Go言語で学ぶ並行プログラミング　他言語にも適用できる原則とベストプラクティス impress top gearシリーズ: James Cutajar (著), 柴田芳樹 (著); インプレス 2024-12-04 (Release 2024-12-04); Kindle版; B0DNYMMBBQ (ASIN); 評価

[Comment] 読書会のために購入。インプレス社の本は Kindle 版より版元で PDF 版を買うのがオススメ。「並行処理」について原理的な解説から丁寧に書かれている。 Go で解説されているが Go 以外の言語でも応用できる。

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)

実用 Go言語第2版: 文法はシンプルで学びやすいという特徴を持つGo言語。システム開発の現場でも使われる機会が増えていますが、複雑な要件を実現するにはプログラミング言語が提供するシンプルな構成要素（文法やライブラリ）を、さまざまに組み合わせます。本書は「よりGoらしく書くには」「実用的なアプリケーションを書くには」といった観点からGoを使うポイントを紹介します。構造体やインタフェース、またJSON、CSVファイル、Excel、固定長ファイルの扱い方、ログやテスト、環境構築など、また初版の発行後、Goに追加されたジェネリクスについても紹介。現場に即した幅広いトピックについて、「Goらしいプログラムの書き方」を、その背景と共に教えてくれる先輩のような書籍です。

プロダクトによっては Makefile やビルド用のスクリプトを用意してるものもある。まぁ，大抵はそれなりの環境を用意しないとビルドできないことが多いのだが。 ↩︎

任意のイテレータを作る

2026-07-06T13:53:06+00:00

Go でイテレータを組む機会があったので，思い出しつつ，簡単なメモを残しておく。なお Go のイテレータは 1.23 から導入されている。

たとえば配列（または slice）や連想配列（map）であれば for-range 構文で以下のように書ける。

package main

func main() {
	nums := []int{1, 2, 3}
	for _, num := range nums {
		println(num)
	}

	planets := map[string]float64{
		"Mercury": 0.055,
		"Venus":   0.815,
		"Earth":   1.0,
	}
	for planet, mass := range planets {
		println(planet, ":", mass)
	}
}

配列や連想配列以外でも for-range 構文が使えれば何かと便利だろう。 Go ではこれを range over function という仕組みで実現している。

Range Over Function Types - The Go Programming Language

Range Over Functions

具体的には以下の3つの関数型を使う。

The improved for/range statement doesn’t support arbitrary function types. As of Go 1.23 it now supports ranging over functions that take a single argument. The single argument must itself be a function that takes zero to two arguments and returns a bool; by convention, we call it the yield function.
func(yield func() bool)
func(yield func(V) bool)
func(yield func(K, V) bool)

via Range Over Function Types

例として，3つの乱数を返すイテレータを作ってみよう。こんな感じかな。

package main

import "math/rand/v2"

func randoms(count int) func(func(int) bool) {
	return func(yield func(int) bool) {
		for range count { // range over int (from 0 to count-1)
			if !yield(rand.Int()) {
				return
			}
		}
	}
}

func main() {
	for n := range randoms(3) {
		println(n)
	}
}

強調部分がイテレータの本体である。これを実行すると，以下のような出力になる。

$ go run sample1a.go
27723168966634698
2343875658410196265
4739277610031835691

このように yield() 関数を呼び出した回数だけ for-range ループが回っていることが分かる。 yield() 関数は何をしているかというと，引数の値をループに push して，処理を継続する場合は true を返している。

ちなみに yield() 関数の返り値のチェックをサボるとどうなるかというと，たとえば

package main

import "math/rand/v2"

func randoms2(count int) func(func(int, int) bool) {
	return func(yield func(int, int) bool) {
		for i := range count { // range over int (from 0 to count-1)
			yield(i+1, rand.Int())
		}
	}
}

func main() {
	for i, n := range randoms2(3) {
		println(i, n)
		if i >= 2 {
			break
		}
	}
}

のように，3回出力するイテレータに対して何らかの理由で2回で中断したとすると

$ go run sample1b.go
1 5146054532611686492
2 7588979459646265126
panic: runtime error: range function continued iteration after function for loop body returned false

goroutine 1 [running]:
main.main-range1(...)
	/path/to/sample1b.go:16
main.main.randoms2.func1(...)
	/path/to/sample1b.go:10
main.main()
	/path/to/sample1b.go:16 +0xcd
exit status 2

などと panic を吐く。怖いですねぇ（笑）

試しに上のコードの randoms2() 関数を

func randoms2(count int) func(func(int, int) bool) {
	return func(yield func(int, int) bool) {
		for i := range count { // range over int (from 0 to count-1)
			println("calling", i+1)
			if !yield(i+1, rand.Int()) {
				println("return false from yield")
				return
			}
		}
	}
}

などとデバッグ文を入れて書き直すと

$ go run sample1c.go
calling 1
1 682324887426579321
calling 2
2 5758210549060056534
return false from yield

のように出力される。 yield() 関数の呼び出しは2回までで，2回目に false を返していることが分かるだろう。

iter パッケージ

イテレータを比較的簡単に取り扱えるようにするため iter パッケージが用意されていて，イテレータを以下のように定義している。

type Seq[V any] func(yield func(V) bool)

type Seq2[K, V any] func(yield func(K, V) bool)

前節の randoms() 関数であれば

import (
	"iter"
	"math/rand/v2"
)

func randoms(count int) iter.Seq[int] {
	return func(yield func(int) bool) {
		for range count { // range over int (from 0 to count-1)
			if !yield(rand.Int()) {
				return
			}
		}
	}
}

のように書き直せる。ん？大して変わらんな（笑）

もうひとつ。 iter パッケージには iter.Pull() および iter.Pull2() 関数が用意されていて，たとえば先程の randoms() 関数の呼び出し側で，以下のように，push-style から pull-style に変形できる。

func main() {
	next, stop := iter.Pull(randoms(3))
	defer stop()
	for {
		n, ok := next()
		if !ok {
			break
		}
		println(n)
	}
}

これはアリだろう。

slices パッケージ

slices パッケージにもイテレータ関連の関数が追加された。たとえば All() 関数を使って

package main

import "slices"

func main() {
	nums := []int{1, 2, 3}
	for i, num := range slices.All(nums) {
		println(i, ":", num)
	}
}

のように slice をイテレータに変換する。記述が増えただけで見た目は変わらんやんけ！と思うかも知れないが

package main

import (
	"iter"
	"slices"
)

func main() {
	nums := []int{1, 2, 3}
	next, stop := iter.Pull(slices.Values(nums))
	defer stop()
	for {
		num, ok := next()
		if !ok {
			break
		}
		println(num)
	}
}

のように pull-style に変形できるのはいいかもしれない。また，イテレータに変換する際に Backward() 関数で逆順に並び替えたり Chunk() 関数で slice を分割することもできる。

Collect() 関数を使ってイテレータを slice に変換することもできる。前節の randoms() 関数であれば

func main() {
	randlist := slices.Collect(randoms(3))
	fmt.Println("randlist:", randlist)
}

のように書く。また AppendSeq() 関数で既にある slice インスタンスにイテレータの出力を追加したり，Sorted() 関数等を使った並び替えもできる。

maps パッケージ

maps パッケージにもイテレータ関連の関数が追加された。ここでは簡単に関数名だけ紹介する。

All : map 型を iter.Seq2 型に変換する
Keys : map 型のキーを iter.Seq 型に変換する
Values : map 型の値を iter.Seq 型に変換する
Collect : iter.Seq2 型を map 型に変換する
Insert : 既にある map インスタンスに iter.Seq2 型の出力を追加する

改訂版：土用期間中の干支を数え上げる

以前書いた「第五の季節：土用」という記事で，拙作の goark/koyomi パッケージを使って，土用期間中の干支を数え上げるコードを紹介した。こんな感じ。

package main

import (
	"fmt"
	"time"

	"github.com/goark/koyomi/value"
	"github.com/goark/koyomi/zodiac"
)

func main() {
	start := value.NewDateYMD(2026, time.July, 20)   //土用の入り
	end := value.NewDateYMD(2026, time.August, 7)    //立秋
	for d := start; d.Before(end); d = d.AddDay(1) { //1日単位で立秋の前日まで出力する
		干, 支 := zodiac.ZodiacDayNumber(d)
		fmt.Printf("Day %v is %v%v\n", d, 干, 支)
	}
}

実行結果は以下の通り。

$ go run sample6a.go
Day 2026-07-20 is 乙未
Day 2026-07-21 is 丙申
Day 2026-07-22 is 丁酉
Day 2026-07-23 is 戊戌
Day 2026-07-24 is 己亥
Day 2026-07-25 is 庚子
Day 2026-07-26 is 辛丑
Day 2026-07-27 is 壬寅
Day 2026-07-28 is 癸卯
Day 2026-07-29 is 甲辰
Day 2026-07-30 is 乙巳
Day 2026-07-31 is 丙午
Day 2026-08-01 is 丁未
Day 2026-08-02 is 戊申
Day 2026-08-03 is 己酉
Day 2026-08-04 is 庚戌
Day 2026-08-05 is 辛亥
Day 2026-08-06 is 壬子

次の土用の丑の日は7月26日か。

それはともかく，コード中の for 文がカッコ悪いなぁと以前から思ってたので，今回の勉強ついでに，指定期間の日付を出力するイテレータを実装してみた。これを使うと，こんな感じに書き直せる。

package main

import (
	"fmt"
	"time"

	"github.com/goark/koyomi/value"
	"github.com/goark/koyomi/zodiac"
)

func main() {
	seq, err := value.NewDateYMD(2026, time.July, 20).IterDay( //土用の入りから
		1, //1日単位で
		value.NewDateYMD(2026, time.August, 7).AddDay(-1), //立秋の前日まで出力する
	)
	if err != nil {
		fmt.Println(err)
		return
	}
	for d := range seq {
		干, 支 := zodiac.ZodiacDayNumber(d)
		fmt.Printf("Day %v is %v%v\n", d, 干, 支)
	}
}

どうよ。こっちのほうが少し見やすいべ。 Before() とか After() とか直感的に分かりにくいメソッドが隠蔽できるだけでもだいぶありがたい。

ブックマーク

参考図書

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

効率的なGo ―データ指向によるGoアプリケーションの性能最適化: Bartłomiej Płotka (著), 山口能迪 (翻訳); オライリー・ジャパン 2024-02-24; 単行本（ソフトカバー）; 4814400535 (ASIN), 9784814400539 (EAN), 4814400535 (ISBN); 評価

[Comment] 版元で Ebook を買える。Go言語のリファレンス本ではない。フトウェア工学，プログラミング（の考え方）を学ぶ教科書的な位置づけかなぁ。

reviewed by Spiegel on 2024-04-21 (powered by PA-APIv5)

Go言語で学ぶ並行プログラミング　他言語にも適用できる原則とベストプラクティス impress top gearシリーズ: James Cutajar (著), 柴田芳樹 (著); インプレス 2024-12-04 (Release 2024-12-04); Kindle版; B0DNYMMBBQ (ASIN); 評価

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)

Struct2pflag v0.2.0 をリリースした

2026-05-29T09:13:56+00:00

昨年 goark/struct2pflag の最初のリリースを行ったが，その後，骨折やら何やらでずうっと止まっていた。最近ようやくこれを使う機会があったが，いくつか機能が足りなかったので，それらを追加して v0.2.0 としてリリースした。

Release v0.2.0 · goark/struct2pflag

追加機能のひとつは環境変数をバインドする BindEnv() 関数である。こんな感じに使う。

type Env struct {
    TopN int           `env:"TOP_N" pflag:"top-n,n,number of top tags"`
    Wait time.Duration `env:"WAIT"  pflag:"wait,w,wait duration"`
}

func main() {
    env := Env{TopN: 10, Wait: time.Second}

    if err := struct2pflag.BindEnv(&env); err != nil {
        _ = fmt.Fprintln(os.Stderr, err)
        return
    }
    struct2pflag.BindDefault(&env)
    pflag.Parse()
}

本当は hymkor/struct2env を使いたかったのだが， string 型しかサポートしてないため泣く泣く自作した。コードを書いたのは AI だけど（笑）

もうひとつは Bind() および BindEnv() 関数で対応する型を増やしたこと。今のところ，対応状況は以下のようになっている。

Type	`Bind`	`BindEnv`
`bool`	✓	✓
`int`	✓	✓
`int8` / `int16` / `int32` / `int64`		✓
`uint`	✓	✓
`uint8` / `uint16` / `uint32` / `uint64`		✓
`float32`	✓	✓
`float64`	✓	✓
`string`	✓	✓
`time.Duration`	✓	✓

本当は []string もサポートしたかったが，キリがないので見送った。必要にかられれば対応する。 spf13/pflag がサポートしている型って物凄くあるので，全部カバーするのは面倒なのだ。いや，どうせコードを書くのは AI なんだけど。

参考図書

初めてのGo言語第2版 ―他言語プログラマーのためのイディオマティックGo実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリー・ジャパン 2025-08-05 (Release 2025-08-05); 単行本（ソフトカバー）; 4814401191 (ASIN), 9784814401192 (EAN), 4814401191 (ISBN); 評価

[Comment] 第2版。 Generics の説明が大幅に改訂されたらしい。練習問題も追加されている。

reviewed by Spiegel on 2025-11-02 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

Go 公式のモジュール照会 API を試す

2026-05-22T03:37:48+00:00

公開された Go パッケージやモジュールのメタデータを照会する API が公開されたそうだ。

Built for stability and efficient caching, the API uses a stateless, GET-only architecture. Primary endpoints are currently hosted under the /v1beta path. Following a period of community feedback and confirmed stability, we intend to transition toward a formal v1 release.

via Introducing the pkg.go.dev API

というわけで現時点では v1beta として提供されている。エンドポイントは以下の通り：

Endpoint Description

/v1beta/package/{path} Information about the package at {path}.

/v1beta/module/{path} Information about the module at {path}.

/v1beta/versions/{path} Versions of the module at {path}.

/v1beta/packages/{path} Information about packages of the module at {path}.

/v1beta/search?q={query} Search results for a given query.

/v1beta/symbols/{path} List of symbols declared by the package at {path}.

/v1beta/imported-by/{path} Paths of packages importing the package at {path}.

/v1beta/vulns/{path} Vulnerabilities of the module or package at {path}.

Endpoint	Description
`/v1beta/package/{path}`	Information about the package at `{path}`.
`/v1beta/module/{path}`	Information about the module at `{path}`.
`/v1beta/versions/{path}`	Versions of the module at `{path}`.
`/v1beta/packages/{path}`	Information about packages of the module at `{path}`.
`/v1beta/search?q={query}`	Search results for a given query.
`/v1beta/symbols/{path}`	List of symbols declared by the package at `{path}`.
`/v1beta/imported-by/{path}`	Paths of packages importing the package at `{path}`.
`/v1beta/vulns/{path}`	Vulnerabilities of the module or package at `{path}`.

via Introducing the pkg.go.dev API

たとえば標準の errors パッケージの情報を取得するには，以下の URL を指定すればいい。

$ curl -s https://pkg.go.dev/v1beta/package/errors | jq .
{
  "modulePath": "std",
  "version": "v1.26.3",
  "isLatest": true,
  "isStandardLibrary": true,
  "goos": "all",
  "goarch": "all",
  "path": "errors",
  "name": "errors",
  "synopsis": "Package errors implements functions to manipulate errors.",
  "isRedistributable": true
}

もちろん標準以外の公開パッケージも取得できる。

$ curl -s https://pkg.go.dev/v1beta/package/github.com/goark/errs | jq .
{
  "modulePath": "github.com/goark/errs",
  "version": "v1.3.4",
  "isLatest": true,
  "isStandardLibrary": false,
  "goos": "all",
  "goarch": "all",
  "path": "github.com/goark/errs",
  "name": "errs",
  "synopsis": "Package errs implements functions to manipulate error instances.",
  "isRedistributable": true
}

モジュールの情報も取れる。

$ curl -s https://pkg.go.dev/v1beta/module/github.com/goark/errs | jq .
{
  "path": "github.com/goark/errs",
  "version": "v1.3.4",
  "commitTime": "2026-05-09T04:07:47Z",
  "isLatest": true,
  "isRedistributable": true,
  "isStandardLibrary": false,
  "hasGoMod": true,
  "repoUrl": "https://github.com/goark/errs"
}

面白いところでは脆弱性情報も取得できるようだ。たとえば昨年の golang.org/x/crypto v0.45.0 における脆弱性情報であれば

$ curl -s https://pkg.go.dev/v1beta/vulns/golang.org/x/crypto?version=v0.45.0 | jq .
{
  "items": [
    {
      "id": "GO-2026-5005",
      "summary": "",
      "details": "Invoking key constraints not enforced in golang.org/x/crypto/ssh/agent",
      "fixedVersion": ""
    },
    {
      "id": "GO-2026-5006",
      "summary": "",
      "details": "Invoking agent constraints dropped when forwarding keys in golang.org/x/crypto/ssh/agent",
      "fixedVersion": ""
    },

    ...

    {
      "id": "GO-2026-5033",
      "summary": "",
      "details": "Invoking pathological inputs can lead to client panic in golang.org/x/crypto/ssh/agent",
      "fixedVersion": ""
    }
  ],
  "total": 13
}

という感じに取得できる（数が多いので途中を端折ってる。あしからず）。 CVE ID ベースじゃないんだな。

CLI ツールも提供されているようだ。 Go のビルド環境があれば以下のコマンドでインストールできる。

$ go install golang.org/x/pkgsite/cmd/internal/pkgsite-cli@latest

ただ，パッケージのパスを見れば分かるように，あくまで API 利用のリファレンス実装という位置づけっぽい。

自作ツールで依存関係を可視化する goark/depm があるのだが，こいつは内部で go コマンドを呼んでいる。これを API ベースに書き換えたら面白いかな。いや，ますます遅くなりそうだな。ちょっと考えるところだ。

参考図書

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

効率的なGo ―データ指向によるGoアプリケーションの性能最適化: Bartłomiej Płotka (著), 山口能迪 (翻訳); オライリー・ジャパン 2024-02-24; 単行本（ソフトカバー）; 4814400535 (ASIN), 9784814400539 (EAN), 4814400535 (ISBN); 評価

reviewed by Spiegel on 2024-04-21 (powered by PA-APIv5)

Go言語で学ぶ並行プログラミング　他言語にも適用できる原則とベストプラクティス impress top gearシリーズ: James Cutajar (著), 柴田芳樹 (著); インプレス 2024-12-04 (Release 2024-12-04); Kindle版; B0DNYMMBBQ (ASIN); 評価

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)

Amazon PA-API 改め Creators API v0.16.0 をリリース

2026-05-06T03:39:52+00:00

現行の Amazon Product Advertising API (PA-API) v5 が 2026-05-15 で廃止になるのに伴い Creators API への移行が必要なのだが，拙作の goark/pa-api パッケージのユーザの方に素晴らしい pull request をいただいた。これをマージして v0.16.0 としてリリースした。

Release v0.16.0 · goark/pa-api · GitHub

v1.x ならメジャーバージョンを上げなきゃいけないところだったけど v0 系なのでマイナーバージョンを上げるだけにした。まだ v1 に上げる勇気がない（笑）

パッケージ名がアレなのだが，パッケージ名を変えようとすると別リポジトリになってしまうので，README のサンプルコードに

import creatorsapi "github.com/goark/pa-api"

と書いてお茶を濁している。

完全に言い訳なのだが，私は今 Amazon Associate の API が使えないのよ。なんか月間で10アイテム以上売り上げないと API が使えないそうで，うちみたいにネットの端っこで細々と運営しているブログサイトじゃ無理だっての。 Amazon Associate の利用目的だって，単に書影を合法的に使いたいからという，超消極的なものだし。

というわけで Creators API の対応はほとんど諦めてたんだけど，まさか PR を貰えるとは。今回は貰った PR をそのままマージして GitHub Copilot にレビュー&修正を指示して¹， README とかのドキュメントも Copilot に直させて。私は1行もコードを書いてない。

ホンマこのパッケージは，文字通り皆さんの貢献（contributions）のおかげで成り立ってると実感できる。今後ともよろしくお願いします 🙇

利用者向けメモ

README にも書いてるけど，移行に関するメモを記しておく。

既存の PA-API v5 呼び出し箇所を移行する際は，この手順に従う:

インポートパスは github.com/goark/pa-api のままにする（必要であれば，例では creatorsapi としてエイリアス可）

クライアント認証情報を置き換える: AWS Access Key / Secret Key → Creators API Credential ID / Credential Secret

マーケットプレイスはサーバー／クライアント側で設定する（WithMarketplace）。クエリごとのマーケットプレイス引数には依存しないこと

V1 の offers 利用を OffersV2 に置き換える（EnableOffersV2。EnableOffers は互換エイリアスとして残している）

Merchant，OfferCount，PartnerType が効くという前提は外すこと。これらは無視される

Credential Version（2.1/2.2/2.3）が呼び出すマーケットプレイスグループと一致していることを確認する

429 および一時的な 5xx 応答に対して再試行とレート制御を追加する

PR を作成する前に，プロジェクトの標準的なテスト／リントのワークフローでローカル検証を実行すること

移行チェックリストより

ブックマーク

参考図書

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

Go言語で学ぶ並行プログラミング　他言語にも適用できる原則とベストプラクティス impress top gearシリーズ: James Cutajar (著), 柴田芳樹 (著); インプレス 2024-12-04 (Release 2024-12-04); Kindle版; B0DNYMMBBQ (ASIN); 評価

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)

ちなみに PR に対して Copilot にレビューさせてみたんだけど，どうにも「分かってない」感じがして丸無視してしまった。今後もあるから copilot-instructions.md ファイルを作った。これで次回以降はもう少しまともなレビューにならないかなぁ。 ↩︎

『カーニハンのUNIX回顧録』オンライン読書会第4回目

2026-04-25T08:36:44+00:00

『カーニハンのUNIX回顧録』オンライン読書会の第4回目に参加してきた。

第4回『カーニハンのUNIX回顧録』オンライン読書会 - connpass

今回は第5章の後半から第6章まで。年代的には1970年代から1980年代ときどき1990年代という感じ。

栞がないなら付箋にすればいいぢゃない

前回，紙の本に挟む栞がなくて難儀した話をしたが，あのあと近所の百均（といってもだいぶ遠いが）へ栞を買いに行ってみた。が，いまどきは栞って売ってないのな。いや，色気のない紙ペラの栞はあったんだけど，紙の栞はすぐに傷むからなぁ…

というわけで代替品として付箋を買ってみた。

本に挟む栞がなかったので付箋を買った | Flickr

フィルム素材で傷みにくいし，あちこちペタペタ貼れるのでそれなりに便利である。これで110円（税込み）。今どきの学生さんはこういうのを使うのだろうか。恵まれてるねぇ。

並行処理言語の歩み

今回は中身をつまみ食いしながら感想を述べていこう。まずはここ。

1980年代の初め，ロブ・パイク（Rob Pike）とルカ・カーデリ（Luca Cardelli）は，特にマウスやキーボードなどの入力装置とのやり取りのような，並行処理向け言語を実験していた．それが Squeak と Newsqueak という名前のもとになった． Newsqueak のアイデアは，やがて Plan 9 で使われた並行処理言語の Limbo と Alef に取り入れられ，さらに10年後，2008年に Google でロブ・パイク，ケン・トンプソン，ロバート・グリースマによって作られた Go プログラミング言語に取り入れられた．

『カーニハンのUNIX回顧録』 p.133より

おおっ。ここで Go が出てくるのか（ちなみに原著者の Brian W. Kernighan は『プログラミング言語 C』および『プログラミング言語 Go』の原著者のひとりでもある）。

もちろん，並行処理言語はここに挙がっているものだけではない。が，きっかけなんてそんなもんだよなぁ，と思う。そこからちゃんと後継言語に受け継がれていく様子も面白い。こういう流れが起きる環境を整えることも大事。

プロセッサとプログラミング言語

この話も面白かった。

CRISP 自体は商業的には成功しなかったものの， Unix と C は1980年代から1990年代にかけてのコンピューティングハードウェアに大きな影響を与えた。成功した命令セットアーキテクチャのほとんどは， C と Unix に調和していた。 Unix と C の可搬性は，大学や，特に企業が新しいアーキテクチャを開発してソフトウェアをすぐに移植することを可能にしただけではなかった。それは，命令セットが C のコードに適していることを要求すると同時に， C プログラムからコンパイルするのが難しい機能は排除されるよう傾くという影響もあった。

『カーニハンのUNIX回顧録』 p.143より

あー，やっぱそうなんだ，という感想。大昔に，某 DSP 用開発ツールに C 言語に似せたアセンブラ言語というのがあって「へー」と思ったものだ（別に書きやすくなったわけじゃないが。所詮はアセンブラだしw）。

私は1990年代以降の業界しか知らないが，1990年代は UNIX 環境でソースコード互換性からバイナリ互換性が議論されていた頃で，その流れで Java 処理系も登場してくるのだが，そもそもソースコードレベルで互換性があるのは凄いと思っていたのだ，当時。

年長者が賢いとは限らない

このエピソードはクスってなった。

私がその時にエディタ自体に対して何を言ったのかは思い出せない（にもかかわらず， vi は今現在私が最も利用する二つのエディタのうちの一つである）が，私がビルにエディタをいじくり回すのはやめて，博士号を終わらせるべきだと言ったことは覚えている。彼自身や他の多くの人にとって幸いなことに，彼は私の助言を無視した。 […] 学生が進路について助言を求めてきたら，私はしばしばこの話を持ち出す。年長者が常に賢明というわけではない。

『カーニハンのUNIX回顧録』 p.151より

そういえば，春は進学・就職・異動の季節だが，若い人はこのエピソードは心に刻んだほうがいい。ホンマ，年長者が若年者より賢いなんてのは幻想なのよ（笑）日本の宗教って神道とか仏教とか言われるけど，近代以降の日本人が（意識的・無意識的に）影響を受けてるのは儒教だったりする（明治維新で神道と儒教が一気に結びついちゃったしね）。家族関係を特別視したり，無条件に年配者を敬ってしまう（あるいは歳を食ってるというだけで権威的に振る舞う）姿勢も儒教的メンタリティだよ。まぁ，今ではそういうのもだいぶ薄れてるとは思うけど，年寄りほど儒教的な刷り込みが深いから，その辺を割り引いて見ていただけると有り難い。

ちなみに vi の作者であるビル・ジョイ（Bill Joy）は，後に大学院を中退して Sun Microsystems の共同設立者となった。まぁ，当時は日本でもガレージハウスやソフトウェアハウスがボコボコと湧いて出たが，成功したものはほんのひと握りだろう。スタートアップビジネス（当時はベンチャービジネス）なんてのはそういうもんだけど。

「それがぼくには楽しかったから」は動機ではない？

前回も思ったが『カーニハンのUNIX回顧録』を読むと「また自分でツールを作りたい」って気分になる。

そういえば，以下の記事で久しぶりに有名なあのフレーズを見かけた。

「Just for Fun」は Linux の創始者である Linus Torvalds による有名なフレーズ「それがぼくには楽しかったから」のことである。でも「それがぼくには楽しかったから」はコードを書く理由あるいは動機にはならないよね。似たような話で登山家が「なぜ山に登るのか」と問われて曰くの「そこに山があるから」は理由でも動機でもない。何故みんなこれで納得してしまうんだ（笑）

私は上のフレーズの背後に「○○せずにはいられない」という強烈な動機があると思う。これは昨年の「出雲神話フォーラム2025」に参加した感想でもある。

画家は「描かずにはいられない」。もの書きは「書かずにはいられない」。登山家は「（そこに山があるから）登らずにはいられない」。同じようにプログラマは「（それがぼくには楽しかったから）コードを書かずにはいられない」じゃないだろうか（職業プログラマは別だが）。少なくとも私はそうだ。眼前に（プログラムで解けそうな）課題があって，それを（コードを使って）解かずにいられようか（いやない）。

「○○せずにはいられない」という気持ちを駆動するもののひとつは好奇心だろう。好奇心は「内発的動機付け」である。

外発的動機付けだけでは知性たり得ない。それは機械と同じである。いや AI ですら「好奇心」を獲得しようと研究されている昨今なのに，人間の側がそれを放棄（または否定）してどうする。

やはり『はじめて学ぶビデオゲームの心理学』の最後のあのフレーズは至言だなぁ，と思うのである。

年齢に関わらず、遊びは私たちの精神を鋭敏に保つために重要です。 […] 遊ぶことは学ぶことです。

『はじめて学ぶビデオゲームの心理学』p.71より

ブックマーク

「「Just for Fun」から遠く離れて」に含められなかった文章など - YAMDAS現更新履歴

参考図書

日経サイエンス2025年6月号 [雑誌]: 日経サイエンス (編集); 日経サイエンス 2025-04-25 (Release 2025-04-25); Kindle版; B0F64YN7KQ (ASIN); 評価

[Comment] 2025年6月号の特集は「好奇心に好奇心」。他には「1秒の定義を変える原子時計のいま」「仲間はずれを作らない教室」など。固定レイアウトなのでブラウザで読める。

reviewed by Spiegel on 2025-05-05 (powered by PA-APIv5)

はじめて学ぶビデオゲームの心理学脳のはたらきとユーザー体験（UX）: セリアホデント (著), 山根信二（監修） (著), 山根信二 (翻訳), 成田啓行 (翻訳); 福村出版 2022-12-15 (Release 2023-07-03); Kindle版; B0C9Z7KGRN (ASIN); 評価

[Comment] Kindle 版が出ている。ゲームデザイナやゲームエンジニアだけでなく，ソフトウェア・エンジニアは全員読むべき。あと，ゲーマーな人も読むといいよ。感想はこちら。

reviewed by Spiegel on 2023-11-21 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

それがぼくには楽しかったから全世界を巻き込んだリナックス革命の真実 (小プロ・ブックス): リーナストーバルズ (著), デビッドダイヤモンド (著), 風見潤 (翻訳), 中島洋 (監修); 小学館プロダクション 2001-05-10; 単行本; 4796880011 (ASIN), 9784796880015 (EAN), 4796880011 (ISBN)

[Comment] Linux の作者 Linus Torvalds の自伝的作品。

reviewed by Spiegel on 2017-01-23 (powered by PA-APIv5)

プログラミング言語C 第2版 ANSI規格準拠: B.W. カーニハン (著), D.M. リッチー (著), 石田晴久 (翻訳); 共立出版 1989-06-15; 単行本; 4320026926 (ASIN), 9784320026926 (EAN), 4320026926 (ISBN); 評価

[Comment] 通称 “K&R”。その筋の人々には「バイブル」と呼ばれる名著（当時は）。

reviewed by Spiegel on 2018-12-07 (powered by PA-APIv5)

Web ページのメタデータを取得する goark/webinfo をリリースした

2025-11-28T10:26:26+00:00

私は自分が作ってる各プロダクトの中で特定の機能が3つ以上重複した場合は別パッケージとして切り出すことにしている。というわけで Web ページのメタデータを取得する機能をパッケージとして切り出した。

goark/webinfo: Extract metadata and structured information from web pages

要するに，完全に自分用のパッケージなので汎用性はあまり考慮していない。

使い方はこんな感じ。

package main

import (
    "bytes"
    "context"
    "encoding/json"
    "fmt"
    "io"
    "os"

    "github.com/goark/webinfo"
)

func errorOut(err error) {
    fmt.Fprintf(os.Stderr, "%+v\n", err)
}

func main() {
    ctx := context.Background()
    // Fetch metadata for a page
    info, err := webinfo.Fetch(ctx, "https://text.baldanders.info/", "") // empty UA uses default
    if err != nil {
        errorOut(err)
        return
    }
    // output metadata as pretty JSON
    b, err := json.MarshalIndent(info, "", "  ")
    if err != nil {
        errorOut(err)
        return
    }
    if _, err := io.Copy(os.Stdout, bytes.NewBuffer(b)); err != nil {
        errorOut(err)
        return
    }
    fmt.Println()
    fmt.Println()

    // Download main image to permanent file in current directory
    imgPath, err := info.DownloadImage(ctx, ".", false)
    if err != nil {
        errorOut(err)
        return
    }
    fmt.Println("image saved:", imgPath)

    // Download thumbnail to permanent file in current directory
    thumbPath, err := info.DownloadThumbnail(ctx, ".", 150, false) // 150px width
    if err != nil {
        errorOut(err)
        return
    }
    fmt.Println("thumbnail saved:", thumbPath)
}

encoding/json/v2 パッケージを使えば MarshalWrite() 関数で直接標準出力に出せるんだけど，まだ実験的実装なので，今回は従来の encoding/json パッケージを使っている。

これを実行するとこんな感じ。

$ go run sample.go
{
  "url": "https://text.baldanders.info/",
  "location": "https://text.baldanders.info/",
  "canonical": "https://text.baldanders.info/",
  "title": "text.Baldanders.info",
  "description": "帰ってきた「しっぽのさきっちょ」",
  "image_url": "https://text.baldanders.info/images/attention/site.jpg",
  "user_agent": "Mozilla/5.0 (Windows NT 6.1; rv:11.0) Gecko/20100101 Firefox/11.0"
}

image saved: site.jpg
thumbnail saved: site-thumb.jpg

ダウンロードした site.jpg がこれ。

site.jpg

site-thumb.jpg はこれ。

site-thumb.jpg

site-thumb.jpg は site.jpg を幅150ピクセルにリサイズして保存している。

README.md ファイルや godoc ページを見ると分かるけど，私にしてはドキュメントが煩い（笑）実はこれ，ほぼ GitHub Copilot (model: GPT-5 mini を選択) に書かせたものなのよね。今回，新規に書いたメソッドとテストおよびドキュメントは Copilot に丸投げしてみた。

閑話休題 (それはさておき)

前にも書いたけど，プロンプトさえ上手くハマれば7割以上は使えるコードを書いてくれる。でも結局のところ，残りの3割なり2割なり1割なりがインパクトの大きい部分だったりするのだ。案の定 lint にかけると，特に gosec あたりにがっつり怒られた。そんでチマチマ直したりする。

あとこれは感覚的なもの言いで申し訳ないんだけど，記述に一貫性がないんだよね。なんというか，面識のない複数の他人がバラバラに書き込んだような感じ。だからコードがちょっと読みにくいし，全体で見て合理的ではない記述もある。でも，記述が間違ってないか確認するためにはきちんと精査しないといけないわけで，そこも微妙なんだよな。

テストコードについては最初「動けばいいや」ということで，大きく間違ってない限り Copilot が書いたコードをそのまま採用していた。 Copilot に「○○のケースを追加して」って書くと，記述が面倒くさいケースでも律儀に書いてくれるんだけど（これは有り難い），書いてる様子を VSCode 上で眺めてると「あぁ，これは正しく動かんだろうな」みたいなテストコードを最初書いて，実際にテストを動かしたらやっぱりエラーになって，そんでまた修正を入れて… ってのを何度か繰り返してて「ずいぶん人間臭いことするなぁ」と思ったりした。

だいたい収束したところで PR を出して Copilot にレビューさせたのだが，テストコードをけちょんけちょんに貶された（笑）いや，同じ Copilot が書いたコードやろがい。で，やっぱり人間である私が改めてテストコードを精査し指摘部分を書き直す作業をチマチマと。

コメントやドキュメントについてはかなり助かった。最初に書いたように「ここまで要るか？」ってくらい詳細に書いてくれるので，逆に Copilot が書いたコメントやドキュメントが設計書代わりになっている。特に .github/copilot-instructions.md を Copilot が書き出してくれたのは助かった。私はそれを見て実装の過不足を確認できるし Copilot も作業の精度を上げることができる。仕様・設計上の変更についても，人間がコードを修正して Copilot に言えば実装に合わせてドキュメントも直してくれるので，実装とドキュメントが乖離するといった「あるある」なことは，ある程度緩和できるのだ。

Copilot の使い方も少しずつ分かってきたし，今回作ったパッケージを既存のプロダクトに組み込んだら，いよいよ新しいツールの制作に入るか。

参考図書

初めてのGo言語第2版 ―他言語プログラマーのためのイディオマティックGo実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリー・ジャパン 2025-08-05 (Release 2025-08-05); 単行本（ソフトカバー）; 4814401191 (ASIN), 9784814401192 (EAN), 4814401191 (ISBN); 評価

[Comment] 第2版。 Generics の説明が大幅に改訂されたらしい。練習問題も追加されている。

reviewed by Spiegel on 2025-11-02 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

hymkor/struct2flag から fork した goark/struct2pflag をリリースした

2025-11-23T09:33:12+00:00

以前 golang セクションで紹介した hymkor/struct2flag だが，これは標準の flag パッケージを使っている。他の類似の flag パッケージついては

オプション体系が GNU っぽくなってしまったり、"flag" の機能まで内包していて、そこまで要らないということで選定候補から外した

Goの構造体タグによるコマンドラインオプション・設定ファイル・環境変数の一元管理 - 標準愚痴出力より

とのことで，それはそれで妥当な選択だと思う。

ただ，私は GNU 拡張シンタックスに対応した spf13/pflag が使いたかったのよ。

というわけで，オリジナルの hymkor/struct2flag から fork して spf13/pflag を使うよう改造した goark/struct2pflag をリリースした¹。使い方は hymkor/struct2flag とほぼ同じ。以前書いた「struct2flag でコマンドライン解析」のコードを goark/struct2pflag を使って書き換えてみる。

package main

import (
	"fmt"
	"strings"

	"github.com/goark/struct2pflag"
	"github.com/spf13/pflag"
)

type Flags struct {
	N    bool   `pflag:"no-newline,n,omit trailing newline"`
	Sep  string `pflag:"sep,s,separator"`
	Strs []string
}

func NewFlags() *Flags {
	return &Flags{N: false, Sep: " ", Strs: []string{}}
}

func Echo(f *Flags) {
	fmt.Print(strings.Join(f.Strs, f.Sep))
	if !f.N {
		fmt.Println()
	}
}

func main() {
	f := NewFlags()
	struct2pflag.BindDefault(f)
	pflag.Parse()
	f.Strs = pflag.Args()

	Echo(f)
}

flag が spf13/pflag に hymkor/struct2flag が goark/struct2pflag に置き換わったほか，構造体タグのプレフィックスが flag: から pflag: に変わっている点に注目。ヘルプを表示させると

$ go run echo4a.go -h
Usage of /tmp/go-build2259633867/b001/exe/echo4a:
  -n, --no-newline   omit trailing newline
  -s, --sep string   separator (default " ")

てな感じに長いオプション名と一文字の短いオプション名が併記されているのが分かる。実際に動かしてみると

$ go run echo4a.go --sep / May the Force be with you
May/the/Force/be/with/you

$ go run echo4a.go -s / May the Force be with you
May/the/Force/be/with/you

と長いオプション名でも短いオプション名でも同じ動作になることが分かる。 spf13/pflag の挙動については拙文「標準 flag パッケージを pflag パッケージに置き換える」で簡単に紹介しているので，そちらも参考にどうぞ。

hymkor/struct2flag で使う構造体タグ flag: も受け入れるようにした（flag: と pflag: は混在可能）。

type Flags struct {
	N    bool   `flag:"n,omit trailing newline"`
	Sep  string `flag:"s,separator"`
	Strs []string
}

ただし，この場合は長いオプション名のみ定義されるため

$ go run echo4b.go -h
Usage of /tmp/go-build1365887832/b001/exe/echo4b:
      --n          omit trailing newline
      --s string   separator (default " ")

という感じに，あくまでも spf13/pflag のルールで構成されるのでご注意を。

一応 hymkor/struct2flag と同程度の機能は持たせている。今後は浮動小数点数や時間を指定できたらいいな，と思っている。他に spf13/pflag ではオプション値を格納する変数側を slice にすることで同じオプションを複数回指定できる機能もあるので，それもサポートしたいところ。まぁ，あくまでも私が使う際に必要に応じて拡張するということで。リクエスト等ありましたら PR いただけると助かります。

参考図書

初めてのGo言語第2版 ―他言語プログラマーのためのイディオマティックGo実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリー・ジャパン 2025-08-05 (Release 2025-08-05); 単行本（ソフトカバー）; 4814401191 (ASIN), 9784814401192 (EAN), 4814401191 (ISBN); 評価

[Comment] 第2版。 Generics の説明が大幅に改訂されたらしい。練習問題も追加されている。

reviewed by Spiegel on 2025-11-02 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

最初は GitHub の fork 機能をそのまま使っていたが自己 pull request の際に，うっかりオリジナルの hymkor/struct2flag の方に PR しそうになったため fork 関係を切り離した。やり方は「GithubでForkしたリポジトリをFork元から切り離して管理する」を参考にした。ありがたや 🙇 ↩︎

Close 関数のエラーを無視しない（『効率的なGo』読書会より）

2025-11-15T11:04:13+00:00

『効率的なGo』の読書会は無事に最終回を迎えた。今回は，読書会最終回の範囲（11章最適化パターン）から個人的に気になった部分を取り上げる。

Close 関数のエラーを無視しない

以下のサンプルコードを起点にする。

package main

import (
	"fmt"
	"os"
)

func doWithFile(filename string) error {
	f, err := os.Open(filename)
	if err != nil {
		return err
	}
	defer f.Close()

	// Perform file operations here...

	return nil
}

func main() {
	err := doWithFile("example.txt")
	if err != nil {
		fmt.Fprintln(os.Stderr, err)
		panic(err)
	}
}

注目するのは defer f.Close() の部分。 f.Close() メソッドはエラーを返す可能性があるが，このコードではエラーを捨てている。この手のサンプルコードはよく見るし私も過去記事で書いたような気がするが，エラーハンドリングの観点からは悪いコードということになる。

ファイルアクセスではクローズ処理の際にバッファに残ってるデータをフラッシュする場合がある。特に zip ファイルの書き込み処理とかでは終端レコードをクローズ時に書き込んだりするので，絶対にエラーを無視してはいけない。

一般的にクロージング・メソッドを含むパッケージや構造体ではクローズ処理時のエラーを適切に処理する必要がある。だからといって defer を使わないのはもったいない。今回の場合は以下のように書き換える。

func doWithFile(filename string) (err error) {
	f, err := os.Open(filename)
	if err != nil {
		return err
	}
	defer func() {
		if cerr := f.Close(); cerr != nil && cerr != os.ErrClosed {
			err = errors.Join(err, cerr)
		}
	}()

	// Perform file operations here...

	return err
}

ポイントは2つ。

返り値を err error と名前付きにすること
defer 処理を無名関数 func() { ... }() で囲み，内部で適切にエラー処理を行うこと

最近の Go は（errors.Join() など）複数エラーを記述できるようになったのでハンドリングが簡潔になった¹。よしよし。

最後まで読み切ってからクローズする

次のサンプルコードはこれ。 HTTP レスポンスデータを処理する関数である。

func doWithResp(resp *http.Response) (err error) {
	defer func() {
		if cerr := resp.Body.Close(); cerr != nil && cerr != os.ErrClosed {
			err = errors.Join(err, cerr)
		}
	}()

	if resp.StatusCode != http.StatusOK {
		return fmt.Errorf("bad status: %s", resp.Status)
	}

	// Perform operations with the response

	return err
}

net/http パッケージのドキュメントには冒頭に

The caller must close the response body when finished with it:

resp, err := http.Get("http://example.com/")
if err != nil {
	// handle error
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
// ...

via http package - net/http - Go Packages

と書かれていて，必ず http.Response.Body.Close() メソッドを呼び出すよう指示されている。クローズ処理を行わないと内部でゴルーチン・リークが発生するらしい。

ただ http.Response.Body に関しては，ただクローズするだけでは駄目で，クローズする前にデータを最後まで読み切ることが推奨されている。

If the Body is not both read to EOF and closed, the Client’s underlying RoundTripper (typically Transport) may not be able to re-use a persistent TCP connection to the server for a subsequent “keep-alive” request.

via http package - net/http - Go Packages

これについては『Go言語 100Tips』にも解説がある。

もう 1 つ覚えておくべき重要なことは、ボディをクローズするときの動作は、そのボディから読み込んだかどうかによって異なることです。

読み込まずにボディをクローズすると、デフォルトの HTTP トランスポートがコネクションをクローズするかもしれません。

読み込んだ後にボディをクローズしても、デフォルトの HTTP トランスポートはコネクションをクローズしないので、再利用できる可能性があります。

したがって、getStatusCode が繰り返し呼ばれ、キープアライブ（keep-alive）のコネクションを使いたい場合、必要がないと思ってもボディを読み込むべきです。

『Go言語 100Tips』 10. No.79：一時的な資源をクローズしないより

これを踏まえて，最初のサンプルコードを書き換えると以下のようになる。

func doWithResp(resp *http.Response) (err error) {
	defer func() {
		_, rerr := io.Copy(io.Discard, resp.Body)
		if cerr := resp.Body.Close(); cerr != nil && cerr != os.ErrClosed {
			err = errors.Join(err, rerr, cerr)
		}
		err = errors.Join(err, rerr)
	}()

	if resp.StatusCode != http.StatusOK {
		return fmt.Errorf("bad status: %s", resp.Status)
	}

	// Perform operations with the response

	return err
}

余談

『効率的なGo』は，ちぃっと難しかった。何が難しいって書籍内参照が前の章や後の章に飛びまくって「何だっけこれ？」ってなることが多くて。まるで longjump だらけのスパゲッティコードを読んでる気分だった。これを曲がりなりにも理解するにはあと2,3回は周回する必要があるかな。

『効率的なGo』では標準パッケージの中身にも踏み込んでカスタマイズしたパッケージ置き換えるといったことも行っている。今回挙げた例についても，エラーハンドリングに関しては独自のパッケージが用意されている。参考になるだろう。

今回の読書会の最後の方で話題になったのだが，2025年12月に『実用 Go言語第2版』が出るそうで。買わなきゃ。先日買った『初めてのGo言語第2版』もまだ読み終わってないんだけど。

参考図書

効率的なGo ―データ指向によるGoアプリケーションの性能最適化: Bartłomiej Płotka (著), 山口能迪 (翻訳); オライリー・ジャパン 2024-02-24; 単行本（ソフトカバー）; 4814400535 (ASIN), 9784814400539 (EAN), 4814400535 (ISBN); 評価

reviewed by Spiegel on 2024-04-21 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

初めてのGo言語第2版 ―他言語プログラマーのためのイディオマティックGo実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリー・ジャパン 2025-08-05 (Release 2025-08-05); 単行本（ソフトカバー）; 4814401191 (ASIN), 9784814401192 (EAN), 4814401191 (ISBN); 評価

[Comment] 第2版。 Generics の説明が大幅に改訂されたらしい。練習問題も追加されている。

reviewed by Spiegel on 2025-11-02 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

拙作の goark/errs パッケージもよろしく（宣伝）。こちらも複数エラーに対応している他，エラーの出力を JSON 形式に出来る。 ↩︎

並行処理を待ち合わせる（WaitGroup と Barrier パターン）

2025-11-09T10:39:03+00:00

Go の goroutine は起動すると外側から直接制御する方法がない。とはいっても goroutine 間で同期を取ることは多く，そのための仕組みがいくつか提供されている。この記事では比較的簡単な実装である，複数の goroutine を待ち合わせる方法を紹介する。

タスクの完了を待ち合わせる

まずは5つの goroutine を起動し，それぞれ某かのタスクを実行するプログラムを考える。まずは素朴に以下のコードで¹。

package main
package main

import (
	"fmt"
	"math/rand/v2"
	"time"
)

func main() {
	tasks := 5 // Number of tasks
	for t := range tasks {
		go func() {
			fmt.Println("Start Task:", t+1)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t+1)
		}()
	}
	fmt.Println("All Complete")
}

（Go の関数は全て関数閉包（closure）として機能するため goroutine として定義した関数はループ変数 t を close over している。この for-range ブロックのループ変数 t は，ループするごとに新たにインスタンスが生成されている点に注意）

実際には，このコードはうまく動かない。実行するとこんな感じ：

$ go run sample1.go
All Complete

実はメイン goroutine が終了する際に他の goroutine も強制終了されてしまうため，このような結果になる。これを安直に解決する手段として，メイン goroutine を適当な時間スリープさせる方法がある。たとえばこんな感じ¹：

package main

import (
	"fmt"
	"math/rand/v2"
	"time"
)

func main() {
	tasks := 5 // Number of tasks
	for t := range tasks {
		go func() {
			fmt.Println("Start Task:", t+1)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t+1)
		}()
	}
	time.Sleep(10 * time.Second)
	fmt.Println("All Complete")
}

これを実行すると確かに

$ go run sample1b.go
Start Task: 5
Start Task: 4
Start Task: 2
Start Task: 1
Start Task: 3
End Task: 3
End Task: 5
End Task: 4
End Task: 1
End Task: 2
All Complete

などと一見うまく動いているようだが，このスリープ時間には根拠がないため（10秒もあれば全タスク完了してるやろ？），条件が変わればうまく動かなくなる可能性がある。

複数のタスクの完了を待ち合わせるために，標準パッケージには sync.WaitGroup が用意されている。使い方はこんな感じ：

package main

import (
	"fmt"
	"math/rand/v2"
	"sync"
	"time"
)

func main() {
	tasks := 5             // Number of tasks
	wg := sync.WaitGroup{} // WaitGroup to synchronize goroutines
	wg.Add(tasks)          // Add the number of tasks to the WaitGroup
	for t := range tasks {
		go func() {
			defer wg.Done() // Ensure Done is called when the goroutine completes
			fmt.Println("Start Task:", t+1)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t+1)
		}()
	}
	wg.Wait() // Wait for all goroutines to finish
	fmt.Println("All Complete")
}

これは goroutine の総数があらかじめ分かっている場合だが goroutine 数が動的に変化する場合でも使える。

package main

import (
	"fmt"
	"math/rand/v2"
	"sync"
	"time"
)

func main() {
	wg := sync.WaitGroup{} // WaitGroup to synchronize goroutines
	for t := 1; ; t++ {
		wg.Add(1) // Add a task to the WaitGroup
		go func() {
			defer wg.Done() // Ensure Done is called when the goroutine completes
			fmt.Println("Start Task:", t)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t)
		}()
		if rand.IntN(6) > 4 { // Randomly decide to stop adding tasks
			break
		}
	}
	wg.Wait() // Wait for all goroutines to finish
	fmt.Println("All Complete")
}

ポイントは goroutine を起動する直前に wg.Add(1) を呼び出すことである。実行結果はこんな感じ。

$ go run sample1d.go
Start Task: 3
Start Task: 1
Start Task: 2
End Task: 2
End Task: 1
End Task: 3
All Complete

for ブロックのループ変数について

先ほどのサンプルコードでは for ブロック

for t := 1; ; t++ {
    ...
}

で宣言したループ変数 t をそのまま goroutine 内で参照しているが，古いバージョンの Go では意図しない出力になる。これはループ変数 t が for ブロック内で単一のインスタンスになっていて，ループするごとに値が上書きされるためである。この問題を回避するために以下のように t を shadowing する方法が推奨されていた。

for t := 1; ; t++ {
    t := t // Shadowing to capture the current value of t
    ...
}

最近のバージョン（1.22 以降）では for ブロック内でループ変数が内部の関数（閉包）から直接参照されている場合は暗黙的に shadowing が行われる。上述のような記述は不要になったわけだ。

WaitGroup.Go メソッド

Go 1.25 で sync.WaitGroup に Go() メソッドが追加された。実装はこんな感じ。

// Go calls f in a new goroutine and adds that task to the [WaitGroup].
// When f returns, the task is removed from the WaitGroup.
//
// The function f must not panic.
//
// If the WaitGroup is empty, Go must happen before a [WaitGroup.Wait].
// Typically, this simply means Go is called to start tasks before Wait is called.
// If the WaitGroup is not empty, Go may happen at any time.
// This means a goroutine started by Go may itself call Go.
// If a WaitGroup is reused to wait for several independent sets of tasks,
// new Go calls must happen after all previous Wait calls have returned.
//
// In the terminology of [the Go memory model], the return from f
// "synchronizes before" the return of any Wait call that it unblocks.
//
// [the Go memory model]: https://go.dev/ref/mem
func (wg *WaitGroup) Go(f func()) {
	wg.Add(1)
	go func() {
		defer wg.Done()
		f()
	}()
}

つまり，Go() メソッド内部で Add(1) と Done() が呼び出され，かつ引数の関数 f を goroutine として起動する。これを使うと，以下のようにコードが簡潔になる。

package main

import (
	"fmt"
	"math/rand/v2"
	"sync"
	"time"
)

func main() {
	tasks := 5             // Number of tasks
	wg := sync.WaitGroup{} // WaitGroup to synchronize goroutines
	for t := range tasks {
		wg.Go(func() {
			fmt.Println("Start Task:", t+1)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t+1)
		})
	}
	wg.Wait() // Wait for all goroutines to finish
	fmt.Println("All Complete")
}

この辺も定番の慣用句（idiom）だったので，Go() メソッドの追加は嬉しい改善点と言えるだろう。

タスクの開始を待ち合わせる

前節とは異なり，特定の条件が成立するまで各 goroutine を停止し，条件が成立したら一斉に実行を再開したい場合がある。条件が成立するまでタスクを止めるため，この実装パターンをバリア（Barrier）と呼ぶ。

Go の標準パッケージにはバリア・パターンを直接提供する仕組みはないが，条件変数を制御する sync.Cond を用いて比較的簡単に実装できる。

前節のコードを元に，指定した数の goroutine の起動が揃うまで待機し，揃った時点で一斉にタスクを開始するコードを実装してみよう。まずはバリアパターンを駆動する構造体 Barrier を定義する。

type Barrier struct {
	total int // Number of goroutines to wait for
	count int // Current count of arrived goroutines
	cond  *sync.Cond // Condition variable to manage waiting and signaling
}

この構造体の初期化関数を以下のように定義する。

func NewBarrier(total int) *Barrier {
	return &Barrier{
		total: total,
		count: 0,
		cond:  sync.NewCond(&sync.Mutex{}),
	}
}

さらに Barrier に対して Wait() メソッドを定義する。

func (b *Barrier) Wait() {
	b.cond.L.Lock()         // Acquire the lock before modifying count
	defer b.cond.L.Unlock() // Ensure the lock is released when done
	b.count++               // Increment the count of arrived goroutines
	if b.count >= b.total {
		b.count = 0
		b.cond.Broadcast() // Wake up all waiting goroutines
	} else {
		b.cond.Wait() // Wait until the barrier is released
	}
}

Wait() メソッドが呼ばれるたびに count がインクリメントされ，count が total に達したら cond.Broadcast() メソッドで全ての待機中 goroutine を起こす。

Barrier を使った main() 関数はこんな感じ：

func main() {
	tasks := 5                   // Number of tasks
	barrier := NewBarrier(tasks) // Create a barrier for the tasks
	for t := range tasks {
		go func() {
			time.Sleep(time.Duration(rand.IntN(3)+1) * time.Second) // Simulate preparation time
			fmt.Println("Ready Task:", t+1)
			barrier.Wait() // Wait at the barrier
			fmt.Println("Start Task:", t+1)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t+1)
		}()
	}
	time.Sleep(10 * time.Second)
	fmt.Println("All Complete")
}

これを実行するとこんな感じになる。

$ go run sample2.go
Ready Task: 2
Ready Task: 3
Ready Task: 1
Ready Task: 4
Ready Task: 5
Start Task: 5
Start Task: 4
Start Task: 3
Start Task: 2
Start Task: 1
End Task: 2
End Task: 1
End Task: 3
End Task: 4
End Task: 5
All Complete

各 goroutine とも Ready 状態が揃ってからタスクを開始しているのが分かる²。

さらにこれに前節の完了待ち合わせ機能を入れたコード全体は以下の通り：

package main

import (
	"fmt"
	"math/rand/v2"
	"sync"
	"time"
)

type Barrier struct {
	total int        // Number of goroutines to wait for
	count int        // Current count of arrived goroutines
	cond  *sync.Cond // Condition variable to manage waiting and signaling
}

func NewBarrier(total int) *Barrier {
	return &Barrier{
		total: total,
		count: 0,
		cond:  sync.NewCond(&sync.Mutex{}),
	}
}

func (b *Barrier) Wait() {
	b.cond.L.Lock()         // Acquire the lock before modifying count
	defer b.cond.L.Unlock() // Ensure the lock is released when done
	b.count++               // Increment the count of arrived goroutines
	if b.count >= b.total {
		b.count = 0
		b.cond.Broadcast() // Wake up all waiting goroutines
	} else {
		b.cond.Wait() // Wait until the barrier is released
	}
}

func main() {
	tasks := 5                   // Number of tasks
	barrier := NewBarrier(tasks) // Create a barrier for the tasks
	wg := sync.WaitGroup{}       // WaitGroup to synchronize goroutines
	wg.Add(tasks)                // Add the number of tasks to the WaitGroup
	for t := range tasks {
		go func() {
			defer wg.Done()                                         // Ensure Done is called when the goroutine completes
			time.Sleep(time.Duration(rand.IntN(3)+1) * time.Second) // Simulate preparation time
			fmt.Println("Ready Task:", t+1)
			barrier.Wait() // Wait at the barrier
			fmt.Println("Start Task:", t+1)
			time.Sleep(time.Duration(rand.IntN(5)+1) * time.Second) // Random duration between 1 and 5 seconds
			fmt.Println("End Task:", t+1)
		}()
	}
	wg.Wait() // Wait for all goroutines to finish
	fmt.Println("All Complete")
}

起動条件は何でもいい。今回のように決められた数の goroutine が揃ったら即起動でもいいし，特定の時刻が来たら待機中の goroutine を起こすでもいいだろう。 Channel と組み合わせる方法もあるかも知れない。

ブックマーク

参考図書

Go言語で学ぶ並行プログラミング　他言語にも適用できる原則とベストプラクティス impress top gearシリーズ: James Cutajar (著), 柴田芳樹 (著); インプレス 2024-12-04 (Release 2024-12-04); Kindle版; B0DNYMMBBQ (ASIN); 評価

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ: Teiva Harsanyi (著), 柴田芳樹 (著); インプレス 2023-08-18 (Release 2023-08-18); Kindle版; B0CFL1DK8Q (ASIN); 評価

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

初めてのGo言語第2版 ―他言語プログラマーのためのイディオマティックGo実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリー・ジャパン 2025-08-05 (Release 2025-08-05); 単行本（ソフトカバー）; 4814401191 (ASIN), 9784814401192 (EAN), 4814401191 (ISBN); 評価

[Comment] 第2版。 Generics の説明が大幅に改訂されたらしい。練習問題も追加されている。

reviewed by Spiegel on 2025-11-02 (powered by PA-APIv5)

for i := range n { ... } は Go 1.22 で導入された range over int と呼ばれる構文で，for i := 0; i < n; i++ { ... } と同じ意味になる。糖衣構文（syntactic sugar）の一種ですな。 ↩︎ ↩︎
今回の記事は『Go言語で学ぶ並行プログラミング』を参考にしている。 sync.Cond の Broadcast() メソッドは待機中の全ての goroutine を起こすため，実際には起こされたタイミングで本当に条件を満たしているかどうか確認する処理が必要かもしれない。もし条件を満たしていなければ再び Wait() する。 ↩︎

List of Golang [text.Baldanders.info]

バージョンの埋め込みと表示

ビルド時にバージョン文字列を埋め込む

ビルド情報を表示する

go run ではビルド情報がセットされない

ブックマーク

参考図書

任意のイテレータを作る

Range Over Functions

iter パッケージ

slices パッケージ

maps パッケージ

改訂版： 土用期間中の干支を数え上げる

ブックマーク

参考図書

Struct2pflag v0.2.0 をリリースした

参考図書

Go 公式のモジュール照会 API を試す

参考図書

Amazon PA-API 改め Creators API v0.16.0 をリリース

利用者向けメモ

ブックマーク

参考図書

『カーニハンのUNIX回顧録』オンライン読書会第4回目

栞がないなら付箋にすればいいぢゃない

並行処理言語の歩み

プロセッサとプログラミング言語

年長者が賢いとは限らない

「それがぼくには楽しかったから」は動機ではない？

ブックマーク

参考図書

Web ページのメタデータを取得する goark/webinfo をリリースした

参考図書

hymkor/struct2flag から fork した goark/struct2pflag をリリースした

参考図書

Close 関数のエラーを無視しない（『効率的なGo』読書会より）

Close 関数のエラーを無視しない

最後まで読み切ってからクローズする

余談

参考図書

並行処理を待ち合わせる（WaitGroup と Barrier パターン）

タスクの完了を待ち合わせる

for ブロックのループ変数について

WaitGroup.Go メソッド

タスクの開始を待ち合わせる

ブックマーク

参考図書

改訂版：土用期間中の干支を数え上げる