List of Module [text.Baldanders.info]

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); 評価

著者のひとりは（あの「バイブル」とも呼ばれる）通称 “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); 評価

版元で 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); 評価

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

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

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

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); 評価

第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); 評価

第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元から切り離して管理する」を参考にした。ありがたや 🙇 ↩︎

github.com/goark/mt/v2 をリリースした

2024-03-09T11:45:42+00:00

Go 1.22 で math/rand/v2 パッケージが登場したため， Mersenne Twister 疑似乱数生成器を実装した拙作の github.com/goark/mt パッケージも math/rand/v2 に対応することにした。

まずはバージョンを v2 に上げて，以下のインポート・パスに変更した。

import "github.com/goark/mt/v2"

また go.mod も同様に

require github.com/goark/mt/v2 v2.0.1

とする。

例として github.com/goark/mt/v2 パッケージと math/rand/v2 パッケージを組み合わせて標準正規分布する値を1万個生成してみる。こんな感じ。

package main

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

    "github.com/goark/mt/v2/mt19937"
)

func main() {
    rnd := rand.New(mt19937.New(rand.Int64()))
    points := []float64{}
    max := 0.0
    min := 1.0
    sum := 0.0
    for range 10000 {
        point := rnd.NormFloat64()
        points = append(points, point)
        min = math.Min(min, point)
        max = math.Max(max, point)
        sum += point
    }
    n := float64(len(points))
    ave := sum / n
    d2 := 0.0
    for _, p := range points {
        d2 += (p - ave) * (p - ave)
    }
    fmt.Println("           minimum: ", min)
    fmt.Println("           maximum: ", max)
    fmt.Println("           average: ", ave)
    fmt.Println("standard deviation: ", math.Sqrt(d2/n))
}

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

$ go run sample.go
           minimum:  -4.465497509270884
           maximum:  4.409945906326592
           average:  0.010399867661332784
standard deviation:  1.0027323703801945

まぁまぁ妥当な感じ？

math/rand および math/rand/v2 パッケージのトップレベル関数群の疑似乱数生成器が ChaCha8 になったおかげで seed を与えるのがめっちゃ楽になった。これだけでもありがたい。ともかくこれで，乱数生成周りの調査と対応は一通り完了かな。

ブックマーク

参考図書

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

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

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

暗号技術入門第3版　秘密の国のアリス: 結城浩 (著); SBクリエイティブ 2015-08-25 (Release 2015-09-17); Kindle版; B015643CPE (ASIN); 評価

SHA-3 や Bitcoin/Blockchain など新しい知見や技術要素を大幅追加。暗号技術を使うだけならこれ1冊でとりあえず無問題。

reviewed by Spiegel on 2015-09-20 (powered by PA-APIv5)

数学ガール／乱択アルゴリズム: 結城浩 (著); SBクリエイティブ 2011-02-25 (Release 2014-03-12); Kindle版; B00I8AT1FO (ASIN); 評価

工学ガール，リサちゃん登場！

reviewed by Spiegel on 2015-04-19 (powered by PA-APIv5)

goark/errs パッケージ v1.3.2 をリリースした

2023-06-26T12:22:20+00:00

この前書いた記事で，最後の方に「そうそう errors.Join 互換の関数ってあったほうがいいのかなぁ」と漠然と書いたのだが，その後，複数の goroutine を跨いでエラーハンドリングを行う必要ができたので， concurrency-safe なマルチエラー型 errs.Errors を作ってリリースした。

Release v1.3.2 · goark/errs · GitHub

いやぁ，並行処理書くの久しぶりで，色々とバグを潰してたら v1.3.2 まで上がってしまった（笑）

たとえば，こんな感じに使える。

package main

import (
    "fmt"
    "sync"

    "github.com/goark/errs"
)

func generateMultiError() error {
    errlist := &errs.Errors{}
    var wg sync.WaitGroup
    for i := 1; i <= 2; i++ {
        i := i
        wg.Add(1)
        go func() {
            defer wg.Done()
            errlist.Add(fmt.Errorf("error %d", i))
        }()
    }
    wg.Wait()
    return errlist.ErrorOrNil()
}

func main() {
    err := generateMultiError()
    fmt.Printf("%+v\n", err) // {"Type":"*errs.Errors","Errs":[{"Type":"*errors.errorString","Msg":"error 2"},{"Type":"*errors.errorString","Msg":"error 1"}]}
}

また errors.Join() 互換の関数も用意してみた。こんな感じ。

package main

import (
    "errors"
    "fmt"
    "io"
    "os"

    "github.com/goark/errs"
)

func generateMultiError() error {
    return errs.Join(os.ErrInvalid, io.EOF)
}

func main() {
    err := generateMultiError()
    fmt.Printf("%+v\n", err)            // {"Type":"*errs.Errors","Errs":[{"Type":"*errors.errorString","Msg":"invalid argument"},{"Type":"*errors.errorString","Msg":"EOF"}]}
    fmt.Println(errors.Is(err, io.EOF)) // true
}

今回新たに作った errs.Errors 型は Unwrap() []error メソッドを持っているため， Go 1.20 以降であれば errors.Is() および errors.As() 関数を使って評価することができる。

これで errors 標準パッケージと互換性ありと言えるようになったかな？

ブックマーク

参考図書

プログラミング言語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言語による並行処理: Katherine Cox-Buday (著), 山口能迪 (翻訳); オライリージャパン 2018-10-26; 単行本（ソフトカバー）; 4873118468 (ASIN), 9784873118468 (EAN), 4873118468 (ISBN); 評価

Eブック版もある。感想はこちら。 Go 言語で並行処理を書くならこの本は必読書になるだろう。

reviewed by Spiegel on 2020-01-13 (powered by PA-APIv5)

goark/errs パッケージ v1.2.1 をリリースした

2023-02-08T03:45:17+00:00

おそらく私しか使ってないであろう，エラーハンドリング用の /github.com/goark/errs パッケージ v1.2.1 をリリースした。

実は v1.2.0 でチョンボして v1.2.1 として出し直している。ごめんペコン。

Go 1.20 で Unwrap() []error メソッドを持つマルチエラーをサポートするようになったため，その対応。たとえば，複数の原因エラーがある場合に，標準の errors.Join() 関数などと組み合わせて

package main

import (
    "errors"
    "fmt"
    "io"
    "os"

    "github.com/goark/errs"
)

func generateMultiError() error {
    return errs.New("error with multiple causes", errs.WithCause(errors.Join(os.ErrInvalid, io.EOF)))
}

func main() {
    err := generateMultiError()
    fmt.Println(errors.Is(err, io.EOF)) // true
}

てな感じに書くことができる。ちなみに

func main() {
    err := generateMultiError()
    fmt.Printf("%+v\n",  err)
}

と書き換えて実行すると

$ go run sample4.go | jq .
{
  "Type": "*errs.Error",
  "Err": {
    "Type": "*errors.errorString",
    "Msg": "error with multiple causes"
  },
  "Context": {
    "function": "main.generateMultiError"
  },
  "Cause": {
    "Type": "*errors.joinError",
    "Msg": "invalid argument\nEOF",
    "Cause": [
      {
        "Type": "*errors.errorString",
        "Msg": "invalid argument"
      },
      {
        "Type": "*errors.errorString",
        "Msg": "EOF"
      }
    ]
  }
}

マルチエラー部分もいい感じに JSON 出力できる。

以前の errs.Cause() 関数には Deprecated マークを付けた（マルチエラーに対応できないため）。

// Deprecated: should not be used
func Cause(err error) error {
    for err != nil {
        unwraped := errors.Unwrap(err)
        if unwraped == nil {
            return err
        }
        err = unwraped
    }
    return err
}

Deprecated マークを付けた型や関数を使用すると lint などで注意喚起してくれる。便利。

errs.Cause() 関数の代わりと言ってはナニだが errs.Unwraps() 関数を用意した。

func Unwraps(err error) []error {
    if err != nil {
        if es, ok := err.(interface {
            Unwrap() []error
        }); ok {
            return es.Unwrap()
        }
    }
    e := errors.Unwrap(err)
    if e != nil {
        return []error{e}
    }
    return nil
}

この関数を使えば原因エラーを []error で返してくれる（原因エラーが単一の場合もスライスで返すので注意）。

マルチエラーを格納する独自の型を作ることも一瞬考えたが，標準の errors.Join() 関数などで作れば必要十分だと思うし，足りなければ改めて考えるか。ということで今回はここまで。

ブックマーク

【Go 1.20 の予習】複数 error を返す Unwrap メソッドについて
Go 言語用エラーハンドリング・パッケージ
Go のエラーハンドリング : Zenn 本書きました

参考図書

プログラミング言語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実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリージャパン 2022-09-26; 単行本（ソフトカバー）; 4814400047 (ASIN), 9784814400041 (EAN), 4814400047 (ISBN); 評価

2021年に出た “Learning Go” の邦訳版。私は版元で PDF 版を購入。 Go 特有の語法（idiom）を切り口として Go の機能やパッケージを解説している。 Go 1.19 対応。

reviewed by Spiegel on 2022-10-11 (powered by PA-APIv5)

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス: 渋川よしき (著), 辻大志郎 (著), 真野隼記 (著); オライリージャパン 2022-04-22; 単行本（ソフトカバー）; 4873119693 (ASIN), 9784873119694 (EAN), 4873119693 (ISBN); 評価

版元のデジタル版を購入。 Go で躓きやすい点を解説していくのが最初の動機らしい。「◯◯するには」を調べる際にこの本を調べるといいかも。

reviewed by Spiegel on 2022-10-26 (powered by PA-APIv5)

go-cvss パッケージ v1.5.0 をリリースした

2023-01-31T07:36:54+00:00

バグ報告が止まらない。ごめんなさいごめんなさいごめんなさい…

ということで github.com/goark/go-cvss パッケージの v1.5.0 をリリースした。

Release v1.5.0 · goark/go-cvss · GitHub

このバージョンで CVSSv2 のデコードを行うサブパッケージを v2/base から v2/metric に移行した。こんな感じ。

//go:build run
// +build run

package main

import (
    "fmt"
    "os"

    "github.com/goark/go-cvss/v2/metric"
)

func main() {
    bm, err := metric.NewBase().Decode("AV:N/AC:L/Au:N/C:N/I:N/A:C") //CVE-2002-0392
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    fmt.Printf("Severity: %v (%v)\n", bm.Severity(), bm.Score())
    // Output:
    // Severity: Severity: High (7.8)
}

これに伴い v2/base パッケージ以下の型定義およびメソッドには Deprecated マークを付けている。一連の変更でようやく CVSSv2 処理系は v3/metric パッケージと互換になった。まぁ今どき CVSSv2 を使うことはないと思うけどね。

そもそも github.com/goark/go-cvss パッケージ自体がかなり試行錯誤していて，随分とカオスな状態になっていたので，この機会に整理できてよかった。もうバグはないよなぁ。ないと思いたい。

2022-01-31 追記

その後のバグ報告で，上述の Deprecated マークを付けた v2/base パッケージはデータ構造上 CVSSv2 の仕様を満たせないことが分かったので v1.6.0 で drop した。

Release v1.6.0 · goark/go-cvss · GitHub

とほほ orz

ブックマーク

CVSS v2 Complete Documentation

参考図書

プログラミング言語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実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリージャパン 2022-09-26; 単行本（ソフトカバー）; 4814400047 (ASIN), 9784814400041 (EAN), 4814400047 (ISBN); 評価

reviewed by Spiegel on 2022-10-11 (powered by PA-APIv5)

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス: 渋川よしき (著), 辻大志郎 (著), 真野隼記 (著); オライリージャパン 2022-04-22; 単行本（ソフトカバー）; 4873119693 (ASIN), 9784873119694 (EAN), 4873119693 (ISBN); 評価

版元のデジタル版を購入。 Go で躓きやすい点を解説していくのが最初の動機らしい。「◯◯するには」を調べる際にこの本を調べるといいかも。

reviewed by Spiegel on 2022-10-26 (powered by PA-APIv5)

go-cvss パッケージ v1.4.2 をリリースした

2023-01-28T03:47:48+00:00

CVSS ベクタ文字列を可視化したいという軽い動機で作った，拙作の github.com/goark/go-cvss パッケージだが，微妙に使って頂いてるようで，バグ報告をいくつか頂いたため，修正版をリリースした。

Release v1.4.2 · goark/go-cvss · GitHub

CVSS のベクタ文字列（CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H¹ など）のバリデーションを厳密に行うようにした。今までベクタ文字列の parse はかなり緩くしていて， metric 名が重複してても（後勝ちで）有効にしてたし，大文字小文字も関係なく有効にしていたが，仕様的にあかんやろ，ということで。これに伴い，古いコードは drop した（コード管理が煩雑になるので）。

使い方は今までと変わらず

package main

import (
	"flag"
	"fmt"
	"io"
	"os"

	"github.com/goark/go-cvss/v3/metric"
	"github.com/goark/go-cvss/v3/report"
	"golang.org/x/text/language"
)

var template = "- `{{ .Vector }}`" + `
- {{ .SeverityName }}: {{ .SeverityValue }} (Score: {{ .BaseScore }})

| {{ .BaseMetrics }} | {{ .BaseMetricValue }} |
|--------|-------|
| {{ .AVName }} | {{ .AVValue }} |
| {{ .ACName }} | {{ .ACValue }} |
| {{ .PRName }} | {{ .PRValue }} |
| {{ .UIName }} | {{ .UIValue }} |
| {{ .SName }} | {{ .SValue }} |
| {{ .CName }} | {{ .CValue }} |
| {{ .IName }} | {{ .IValue }} |
| {{ .AName }} | {{ .AValue }} |
`

func main() {
	flag.Parse()
	if flag.NArg() < 1 {
		fmt.Fprintln(os.Stderr, "Set CVSS vector")
		return
	}
	bm, err := metric.NewBase().Decode(flag.Arg(0))
	if err != nil {
		fmt.Fprintf(os.Stderr, "%+v\n", err)
		return
	}
	r, err := report.NewBase(bm, report.WithOptionsLanguage(language.Japanese)).ExportWithString(template)
	if err != nil {
		fmt.Fprintf(os.Stderr, "%+v\n", err)
		return
	}
	if _, err := io.Copy(os.Stdout, r); err != nil {
		fmt.Fprintf(os.Stderr, "%+v\n", err)
	}
}

などとしておけば

$ go run main.go "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H"
- `CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H`
- 深刻度: 緊急 (Score: 9.8)

| 基本評価基準 | 評価値 |
|--------|-------|
| 攻撃元区分 | ネットワーク |
| 攻撃条件の複雑さ | 低 |
| 必要な特権レベル | 不要 |
| ユーザ関与レベル | 不要 |
| スコープ | 変更なし |
| 機密性への影響 | 高 |
| 完全性への影響 | 高 |
| 可用性への影響 | 高 |

と出力される。

この github.com/goark/go-cvss パッケージってコードの半分くらい貰いものだし，さらに今回は fuzzing テストまでしてもらって，ホンマに「マジすんません」って感じである。ありがたや 🙇

でも CVSS ってあくまでもリスクの「評価基準」のひとつであって，そこから「どうする」ってのはまた別の話なんだよね。個人なら CVSS の Base metrics 情報を見て都度判断すればいいけど，組織では SSVC (Stakeholder-Specific Vulnerability Categorization) なんかと組み合わせる必要があるかもしれない。

道具は適材適所で使いましょう，ということで。

【2022-01-29 追記】 v1.4.4 をリリースした

またバグ報告があったので修正版をリリースした。とほほ…

Release v1.4.4 · goark/go-cvss · GitHub

今回のついでにスコアの計算周りのリファクタリングを行った。ちょっとスッキリ！

ブックマーク

参考図書

プログラミング言語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実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリージャパン 2022-09-26; 単行本（ソフトカバー）; 4814400047 (ASIN), 9784814400041 (EAN), 4814400047 (ISBN); 評価

reviewed by Spiegel on 2022-10-11 (powered by PA-APIv5)

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス: 渋川よしき (著), 辻大志郎 (著), 真野隼記 (著); オライリージャパン 2022-04-22; 単行本（ソフトカバー）; 4873119693 (ASIN), 9784873119694 (EAN), 4873119693 (ISBN); 評価

版元のデジタル版を購入。 Go で躓きやすい点を解説していくのが最初の動機らしい。「◯◯するには」を調べる際にこの本を調べるといいかも。

reviewed by Spiegel on 2022-10-26 (powered by PA-APIv5)

CVE-2022-3515 より ↩︎

今年の恵方を取得する

2023-01-14T07:21:26+00:00

正月気分も終わり，近所のスーパーとかで節分グッズが並ぶようになって「そういや今年の恵方はどっちだっけ？」と思って調べてみた。

どうやら，その年の十干で恵方が決定するらしい。

via File:Ehou-direction.png - Wikimedia Commons

って，4方向を十干で分けるのか。中途半端やなぁ。

まぁ，でも，その年の十干が分かれば恵方も分かるわけだ。拙作の github.com/goark/koyomi パッケージにオマケで十干十二支を数え上げる機能を付けているのだが，これに恵方を取得する機能を追加してみた。

こんな感じ。

package main

import (
    "fmt"

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

func main() {
    year := 2023
    干, 支 := zodiac.ZodiacYearNumber(year)
    fmt.Printf("%d年は%v%v，恵方は%v (%v°)", year, 干, 支, 干.DirectionJp(), 干.Direction())
}

これを実行すると

2023年は癸卯，恵方は南南東微南 (165°)

と出力される。

というわけで，2023年はだいたい南南東を向いてモグモグすればいいらしい。

この「恵方」というのはその年の歳神様のおられる方位で，居住地から見て恵方にあたる社寺に詣ることを「恵方詣り」と言うらしいのだが，明治以降の鉄道の発達で長距離移動が容易になり，方位に依存する「恵方詣り」が廃れ，代わりに「初詣」が主流になっていったとのこと。その一方で，節分の「恵方巻き」みたいな文化が平成以降に台頭してくるのは面白い。

ブックマーク

参考図書

鉄道が変えた社寺参詣 (交通新聞社新書): 平山昇 (著); 交通新聞社 2012-10-15 (Release 2015-12-07); Kindle版; B0191845R0 (ASIN)

面白そうなのでポチってみた。これから読む。

reviewed by Spiegel on 2023-01-14 (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言語 ―他言語プログラマーのためのイディオマティックGo実践ガイド: Jon Bodner (著), 武舎広幸 (翻訳); オライリージャパン 2022-09-26; 単行本（ソフトカバー）; 4814400047 (ASIN), 9784814400041 (EAN), 4814400047 (ISBN); 評価

reviewed by Spiegel on 2022-10-11 (powered by PA-APIv5)

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス: 渋川よしき (著), 辻大志郎 (著), 真野隼記 (著); オライリージャパン 2022-04-22; 単行本（ソフトカバー）; 4873119693 (ASIN), 9784873119694 (EAN), 4873119693 (ISBN); 評価

版元のデジタル版を購入。 Go で躓きやすい点を解説していくのが最初の動機らしい。「◯◯するには」を調べる際にこの本を調べるといいかも。

reviewed by Spiegel on 2022-10-26 (powered by PA-APIv5)

sshql — SSH 越しに RDBMS にアクセスする

2022-09-30T12:17:13+00:00

拙作 github.com/goark/sshql は SSH 経由で MySQL や PostgreSQL といった RDBMS に接続するための Go パッケージである。

GitHub - goark/sshql: Go SQL drivers over SSH

github.com/goark/sshql パッケージでは以下の Dialer 型の構造体を用意し，これを使って SSH に接続する¹。

// Dialer is authentication provider information.
type Dialer struct {
    Hostname      string `json:"hostname"`
    Port          int    `json:"port"`
    Username      string `json:"username"`
    Password      string `json:"password"`
    PrivateKey    string `json:"privateKey"`
    IgnoreHostKey bool   `json:"IgnoreHostKey"`
    client        *ssh.Client
}

パスワード認証の場合は Username と Password にそれぞれ値をセットする。 PrivateKey に認証用の秘密鍵へのパスを指定する場合は Password に秘密鍵のパスフレーズをセットする。また ssh-agent 等を使って $SSH_AUTH_SOCK ソケットから秘密鍵を取得できる場合は，こちらを優先するようになっている。

IgnoreHostKey に true をセットするとホスト認証を無視するようになっているが，セキュリティ上お勧めできないのでご注意を。ホスト認証は $HOME/.ssh/known_hosts ファイルにホスト鍵が登録されていることが前提で， known_hosts ファイルがない，または known_hosts にホスト鍵がない場合は

$ go run main.go
ssh: handshake failed: knownhosts: key is unknown

という感じにエラーになる。

では，これを使って実際にコードを書いてみる。

github.com/lib/pq + github.com/goark/sshql

まずは PostgreSQL 用ドライバ github.com/lib/pq と github.com/goark/sshql を組み合わせるところから。こんな感じに書ける。

package main

import (
    "database/sql"
    "fmt"
    "os"

    "github.com/goark/sshql"
    "github.com/goark/sshql/pgdrv"
)

func main() {
    dialer := &sshql.Dialer{
        Hostname:   "sshserver",
        Port:       22,
        Username:   "remoteuser",
        Password:   "passphraseforauthkey",
        PrivateKey: "/home/username/.ssh/id_eddsa",
    }
    pgdrv.New(dialer).Register("postgres+ssh")

    db, err := sql.Open("postgres+ssh", "postgres://dbuser:dbpassword@localhost:5432/example?sslmode=disable")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    defer dialer.Close()
    defer db.Close()

    rows, err := db.Query("SELECT id, name FROM example ORDER BY id")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    for rows.Next() {
        var id int64
        var name string
        if err := rows.Scan(&id, &name); err != nil {
            fmt.Fprintln(os.Stderr, err)
            break
        }
        fmt.Printf("ID: %d  Name: %s\n", id, name)
    }
    rows.Close()
}

"postgres+ssh" としてドライバを登録し（名前は何でもOK），この名前を sql.Open() 関数で指定しているのがポイントである。あとは database/sql の機能をそのまま使うことができる。

github.com/goark/sshql/pgdrv パッケージ内部で github.com/lib/pq パッケージを呼び出しているため

import _ "github.com/lib/pq"

のようなインポートは不要である。

github.com/jackc/pgx + github.com/goark/sshql

github.com/jackc/pgx は github.com/lib/pq の後継とも言えるパッケージである。標準 database/sql パッケージと組み合わせて使うことも可能だが，自身が database/sql 互換のインタフェースを持っていて更に独自の機能も搭載している。 PostgreSQL にアクセスするなら，個人的にはこちらのほうがお勧めである。

拙作 github.com/goark/sshql と組み合わせて使うにはちょっと変則的な初期化コードを書く。こんな感じ。

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/goark/sshql"
    "github.com/jackc/pgx/v4/pgxpool"
)

func main() {
    dialer := &sshql.Dialer{
        Hostname:   "sshserver",
        Port:       22,
        Username:   "remoteuser",
        Password:   "passphraseforauthkey",
        PrivateKey: "/home/username/.ssh/id_eddsa",
    }

    cfg, err := pgxpool.ParseConfig("postgres://dbuser:dbpassword@localhost:5432/example?sslmode=disable")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    cfg.ConnConfig.DialFunc = dialer.DialContext

    if err := dialer.Connect(); err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    defer dialer.Close()

    pool, err := pgxpool.ConnectConfig(context.TODO(), cfg)
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    defer pool.Close()

    rows, err := pool.Query(context.TODO(), "SELECT id, name FROM example ORDER BY id")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    rows.Close()

    for rows.Next() {
        var id int64
        var name string
        if err := rows.Scan(&id, &name); err != nil {
            fmt.Fprintln(os.Stderr, err)
            break
        }
        fmt.Printf("ID: %d  Name: %s\n", id, name)
    }
}

まず pgx.ConnConfig を含む pgx/pgxpool.Config 構造体を作って，そこに dialer.DialContext() メソッドを登録するイメージ。 pgx ドライバーをオープンする前に dialer.Connect() つまり SSH 接続を明示的に記述する必要がある。

一見まどろこしく見えるが， pgx/pgxpool.Config 構造体を使って logger 登録を含むカスタマイズができるので，実用上はそれほど迂遠なコードではなかったりする。接続ごとにインスタンスを作れるので，グローバルに名前をつけてドライバーを登録するより合理的かもしれない。

github.com/go-sql-driver/mysql + github.com/goark/sshql

MySQL 用ドライバ github.com/go-sql-driver/mysql と github.com/goark/sshql との組み合わせはこんな感じ。

package main

import (
    "database/sql"
    "fmt"
    "os"

    "github.com/goark/sshql"
    "github.com/goark/sshql/mysqldrv"
)

func main() {
    dialer := &sshql.Dialer{
        Hostname:   "sshserver",
        Port:       22,
        Username:   "remoteuser",
        Password:   "passphraseforauthkey",
        PrivateKey: "/home/username/.ssh/id_eddsa",
    }
    mysqldrv.New(dialer).RegisterDial("ssh+tcp")

    db, err := sql.Open("mysql", "dbuser:dbpassword@ssh+tcp(localhost:3306)/dbname")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    defer dialer.Close()
    defer db.Close()

    rows, err := db.Query("SELECT id, name FROM example ORDER BY id")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    for rows.Next() {
        var id int64
        var name string
        if err := rows.Scan(&id, &name); err != nil {
            fmt.Fprintln(os.Stderr, err)
            break
        }
        fmt.Printf("ID: %d  Name: %s\n", id, name)
    }
    rows.Close()
}

github.com/lib/pq のときとは違いドライバー名ではなくプロトコル名（通常は "tcp" など）として登録し DSN に登録したプロトコル名（ここでは ssh+tcp）を含める。あとは database/sql の機能をそのまま使うことができる。

github.com/goark/sshql/mysqldrv パッケージ内部で github.com/go-sql-driver/mysql パッケージを呼び出しているため

import _ "github.com/go-sql-driver/mysql"

のようなインポートは不要である。

参考図書

プログラミング言語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.com/mattn/pqssh の事実上の fork である。同パッケージに敬意を表して拙作の方も MIT ライセンスで提供している。感謝！ ↩︎