List of Openbd [text.Baldanders.info]

Go 製のツールとパッケージをまとめてアップデートした

2020-10-02T07:40:54+00:00

GitHub リポジトリにある Go 言語製のツールやパッケージについて GitHub Actions で CI (Continuous Integration) を回す目処が立ったので，設定を変更しリリースし直すことにした。今回リリースしたツール・パッケージのうち主なものは以下の通り。

若干 lint に叱られたり軽微なバグを指摘されたりしたものもあるが，機能上の追加・変更はない。

それじゃあ，次のステージに行きましょう♪

ブックマーク

参考図書

プログラミング言語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)

射手座☆午後九時Don't be late: シェリル・ノーム starring May'n (メインアーティスト); FlyingDog 2008-05-08 (Release 2017-01-16); MP3 ダウンロード; B01MZ8UA8O (ASIN); 評価

移動中に聴くとノリノリになれる（笑）

reviewed by Spiegel on 2020-10-02 (powered by PA-APIv5)

エラーハンドリング・パッケージ errs v1.0.0 他のリリース【Go 1.15 リリース記念】

2020-08-13T00:48:44+00:00

この前 v0.7.0 を出したばかりだが，予告したとおり， Go 1.15 リリースを記念して spiegel-im-spiegel/errs パッケージのメジャー・バージョンを上げることにした。

Release v1.0.0 · spiegel-im-spiegel/errs · GitHub

機能追加なし。不具合修正もなし。 go.mod と Travis CI の設定を変更して Go 1.15 に対応させただけの簡単なお仕事デス。

今後は後方互換性をきちんと考えて改修していく予定です m(_ _)m

ついでに spiegel-im-spiegel/errs パッケージを利用している主なパッケージやツールもバージョンを上げた。

基本的には spiegel-im-spiegel/errs パッケージのバージョンを上げただけ。まぁ v0.7.0 で後方互換性をぶっ壊しているので，手直しが多かったけど（笑）

32ビット・バイナリの提供を止めました

gpgpdump, books-data, gnkf, mklink の各ツールはバイナリでの提供も行っているが，今回から32ビット・バイナリの提供を止めることにした（ARM アーキテクチャを除く）。

きっかけは Go 1.15 で darwin/386 のサポートが終了したこと。

As announced in the Go 1.14 release notes, Go 1.15 drops support for 32-bit binaries on macOS, iOS, iPadOS, watchOS, and tvOS (the darwin/386 and darwin/arm ports). Go continues to support the 64-bit darwin/amd64 and darwin/arm64 ports.

via Go 1.15 Release Notes - The Go Programming Language

クロスコンパイルは GoReleaser を使ってるのでそんなに面倒ではないんだけど… もう32ビット流行らんべ。 Windows で古い32ビット機を（しかも拙作を）使ってる人は多分いないだろうし Ubuntu も最新 LTS では遂に32ビット・アーキテクチャのサポートを終了したしね。

まぁ Pure Go で書いてるのでダウンロード&ビルドは難しくないし，たいした問題ではないだろう，うんうん。

ブックマーク

参考図書

プログラミング言語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)

書籍データ取得ツール books-data

2019-09-08T06:22:41+00:00

【2026-05-15 追記】

このツールのリポジトリは PA-API v5 廃止に伴い Archive 化した。以降，このツールおよびリポジトリはメンテナンスされない。

goark/books-data: Search for Books Data

本ツールは PA-API, openBD および青空文庫 API より書籍情報を取得・加工するための CLI (Command-Line Interface) ツールである。

ダウンロードとビルド

books-data は以下の Go コマンドでビルドとインストールができる。

$ go install github.com/goark/books-data@latest

なおビルドには Go 1.16 以上が必要になる。ご注意を。

各プラットフォーム用のバイナリも用意している。最新バイナリはリリースページから取得できる。

簡単な使い方

-h オプションで簡単なヘルプを表示できる。

$ books-data -h
Search for books data

Usage:
  books-data [flags]
  books-data [command]

Available Commands:
  help        Help about any command
  history     Lookup review data from history log
  review      Make review data
  search      Search for books data
  version     Print the version number

Flags:
      --access-key string      Config: PA-API Access Key ID
  -c, --aozora-card string     Aozora-bunko card no.
  -a, --asin string            Amazon ASIN code
      --associate-tag string   Config: PA-API Associate Tag
      --config string          Config file (default /home/username/.config/books-data/config.yaml)
      --debug                  for debug
  -h, --help                   help for books-data
  -i, --isbn string            ISBN code
      --marketplace string     Config: PA-API Marketplace (default "www.amazon.co.jp")
  -l, --review-log string      Config: Review log file (JSON format)
      --secret-key string      Config: PA-API Secret Access Key
  -t, --template-file string   Template file for formatted output

Use "books-data [command] --help" for more information about a command.

設定ファイル

books-data のオプションの一部は設定ファイルであらかじめ指定しておくことができる。指定可能なオプションは以下の通り

オプション名	既定値	内容
`marketplace`	`www.amazon.co.jp`	PA-API サーバ名
`associate-tag`	なし	PA-API アソシエイト・タグ（アカウント名）
`access-key`	なし	PA-API アクセスキー
`secret-key`	なし	PA-API 秘密キー
`review-log`	なし	レビューデータ作成時の保存ログファイル名

設定ファイルの書式は YAML 形式で以下のような感じに記述する。

$ cat ~/.config/books-data/config.yaml
marketplace: www.amazon.co.jp
associate-tag: mytag-20
access-key: AKIAIOSFODNN7EXAMPLE
secret-key: 1234567890
review-log: /home/username/.local/share/books-data/review-log.json

設定ファイルは以下のパスに置いておけば books-data 起動時に自動的に読み込まれる。

Windows
- %AppData%\books-data\config.yaml
Darwin (macOS)
- $HOME/Library/Application Support/books-data/config.yaml
Plan 9
- $home/lib/books-data/config.yaml
UNIX 系 OS (Linux 他)
- $XDG_CONFIG_HOME/books-data/config.yaml （$XDG_CONFIG_HOME 環境変数が指定されている場合）
- $HOME/.config/books-data/config.yaml

また books-data 起動時に --config オプションで設定ファイルを直接指定することも可能だ。設定ファイルの内容には秘密情報が含まれる（PA-API を利用する場合）ためファイルのアクセス設定に注意すること。

書籍情報の検索

$ books-data search -h
Search for books data

Usage:
  books-data search [flags]

Flags:
  -h, --help   help for search
      --raw    Output raw data from API

Global Flags:
      --access-key string      Config: PA-API Access Key ID
  -c, --aozora-card string     Aozora-bunko card no.
  -a, --asin string            Amazon ASIN code
      --associate-tag string   Config: PA-API Associate Tag
      --config string          Config file (default /home/username/.config/books-data/config.yaml)
      --debug                  for debug
  -i, --isbn string            ISBN code
      --marketplace string     Config: PA-API Marketplace (default "www.amazon.co.jp")
  -l, --review-log string      Config: Review log file (JSON format)
      --secret-key string      Config: PA-API Secret Access Key
  -t, --template-file string   Template file for formatted output

たとえば ASIN コード B07TYKJQFK のアイテムの情報を取得する場合は以下のコマンドラインで起動する（PA-API を利用可能な場合）。

$ books-data search -a B07TYKJQFK
{"Type":"paapi","ID":"B07TYKJQFK","Title":"数学ガールの秘密ノート／ビットとバイナリー","URL":"https://www.amazon.co.jp/dp/B07TYKJQFK?tag=mytag-20\u0026linkCode=ogi\u0026th=1\u0026psc=1","Image":{"URL":"https://m.media-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg","Height":160,"Width":111},"ProductType":"Kindle版","Creators":[{"Name":"結城 浩","Role":"著"}],"Publisher":"SBクリエイティブ","Codes":[{"Name":"ASIN","Value":"B07TYKJQFK"}],"PublicationDate":"2019-07-19","LastRelease":"2019-07-20","Service":{"Name":"PA-APIv5","URL":"https://affiliate.amazon.co.jp/assoc_credentials/home"}}

実行結果は JSON 形式で出力される。

他に指定可能な検索オプションは以下の通り。

オプション	内容
`-a, --asin`	Amazon ASIN コード
`-i, --isbn`	ISBN 番号
`-c, --aozora-card`	青空文庫図書カード No.

これらは同時に指定可能だが Amazon ASIN コード → ISBN 番号 → 青空文庫図書カード No. の順で検索を行う。検索キーとして ISBN コードを指定した場合は openBD による検索を行う。

レビュー・データの作成

$ books-data review -h
Make review data

Usage:
  books-data review [flags] [description]

Flags:
      --bookpage-url string   URL of book page
  -h, --help                  help for review
      --image-url string      URL of book cover image
      --pipe                  Import description from Stdin
  -r, --rating int            Rating of product
      --review-date string    Date of review

Global Flags:
      --access-key string      Config: PA-API Access Key ID
  -c, --aozora-card string     Aozora-bunko card no.
  -a, --asin string            Amazon ASIN code
      --associate-tag string   Config: PA-API Associate Tag
      --config string          Config file (default /home/username/.config/books-data/config.yaml)
      --debug                  for debug
  -i, --isbn string            ISBN code
      --marketplace string     Config: PA-API Marketplace (default "www.amazon.co.jp")
  -l, --review-log string      Config: Review log file (JSON format)
      --secret-key string      Config: PA-API Secret Access Key
  -t, --template-file string   Template file for formatted output

ASIN, ISBN または青空文庫図書カード No. で指定した書籍情報に対してレビュー情報を作成する。レビュー情報として以下のオプションを指定できる。

オプション	内容
`--bookpage-url`	書籍ページへの URL
`--image-url`	書影（画像データ）への URL
`--rating`	評価ポイント (`0-5`) ※ `0`なら評価なし
`--review-date`	レビュー日

コマンドラインはこんな感じで記述する。

$ books-data review -a B07TYKJQFK -r 5 --review-date 2019-09-08 "面白かった！"
{"Book":{"Type":"paapi","ID":"B07TYKJQFK","Title":"数学ガールの秘密ノート／ビットとバイナリー","URL":"https://www.amazon.co.jp/dp/B07TYKJQFK?tag=mytag-20\u0026linkCode=ogi\u0026th=1\u0026psc=1","Image":{"URL":"https://m.media-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg","Height":160,"Width":111},"ProductType":"Kindle版","Creators":[{"Name":"結城 浩","Role":"著"}],"Publisher":"SBクリエイティブ","Codes":[{"Name":"ASIN","Value":"B07TYKJQFK"}],"PublicationDate":"2019-07-19","LastRelease":"2019-07-20","Service":{"Name":"PA-APIv5","URL":"https://affiliate.amazon.co.jp/assoc_credentials/home"}},"Date":"2019-09-08","Rating":5,"Star":[true,true,true,true,true],"Description":"面白かった！"}

実行結果は JSON 形式で出力される。また --pipe オプションを付けることで標準入力から description を入力できる。

$ echo "面白かった！" | books-data review -a B07TYKJQFK -r 5 --review-date 2019-09-08 --pipe
{"Book":{"Type":"paapi","ID":"B07TYKJQFK","Title":"数学ガールの秘密ノート／ビットとバイナリー","URL":"https://www.amazon.co.jp/dp/B07TYKJQFK?tag=mytag-20\u0026linkCode=ogi\u0026th=1\u0026psc=1","Image":{"URL":"https://m.media-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg","Height":160,"Width":111},"ProductType":"Kindle版","Creators":[{"Name":"結城 浩","Role":"著"}],"Publisher":"SBクリエイティブ","Codes":[{"Name":"ASIN","Value":"B07TYKJQFK"}],"PublicationDate":"2019-07-19","LastRelease":"2019-07-20","Service":{"Name":"PA-APIv5","URL":"https://affiliate.amazon.co.jp/assoc_credentials/home"}},"Date":"2019-09-08","Rating":5,"Star":[true,true,true,true,true],"Description":"面白かった！\n"}

レビュー履歴の参照

$ books-data history -h
Lookup review data from history log

Usage:
  books-data history [flags]

Flags:
  -h, --help   help for history

Global Flags:
      --access-key string      Config: PA-API Access Key ID
  -c, --aozora-card string     Aozora-bunko card no.
  -a, --asin string            Amazon ASIN code
      --associate-tag string   Config: PA-API Associate Tag
      --config string          Config file (default /home/spiegel/.config/books-data/config.yaml)
      --debug                  for debug
  -i, --isbn string            ISBN code
      --marketplace string     Config: PA-API Marketplace (default "www.amazon.co.jp")
  -l, --review-log string      Config: Review log file (JSON format)
      --secret-key string      Config: PA-API Secret Access Key
  -t, --template-file string   Template file for formatted output

--review-log オプションでレビュー結果を保存している場合は history コマンドで過去の履歴を呼び出せる。

$ books-data history -a B07TYKJQFK
{"Book":{"Type":"paapi","ID":"B07TYKJQFK","Title":"数学ガールの秘密ノート／ビットとバイナリー","URL":"https://www.amazon.co.jp/dp/B07TYKJQFK?tag=mytag-20\u0026linkCode=ogi\u0026th=1\u0026psc=1","Image":{"URL":"https://m.media-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg","Height":160,"Width":111},"ProductType":"Kindle版","Creators":[{"Name":"結城 浩","Role":"著"}],"Publisher":"SBクリエイティブ","Codes":[{"Name":"ASIN","Value":"B07TYKJQFK"}],"PublicationDate":"2019-07-19","LastRelease":"2019-07-20","Service":{"Name":"PA-APIv5","URL":"https://affiliate.amazon.co.jp/assoc_credentials/home"}},"Date":"2019-09-08","Rating":5,"Star":[true,true,true,true,true],"Description":"面白かった！\n"}

出力の整形

-t または --template-file オプションででテンプレートファイルを指定することにより search, review, history 各コマンドの実行結果の出力を整形できる。

たとえば以下のようなテンプレートファイルを用意すれば

$ cat reviews/template.bib.txt 
@BOOK{Book:{{ .Book.ID }},
    TITLE = "{{ .Book.Title }}",
    AUTHOR = "{{ with .Book.Creators }}{{ range $i, $v := . }}{{ if ne $i 0 }} and {{ end }}{{ . }}{{ end }}{{ end }}"{{ if .Book.Publisher }},
    PUBLISHER = {{ "{" }}{{ .Book.Publisher }}{{ "}" }}{{ end }}{{ if gt .Book.PublicationDate.Year 1 }},
    YEAR = {{ .Book.PublicationDate.Year }}{{ end }}
}

このような出力になる。

$ books-data history -a B07TYKJQFK -t reviews/template.bib.txt 
@BOOK{Book:B07TYKJQFK,
    TITLE = "数学ガールの秘密ノート／ビットとバイナリー",
    AUTHOR = "結城 浩 (著)",
    PUBLISHER = {SBクリエイティブ},
    YEAR = 2019
}

search コマンドで取得した書籍データのフォーマットは以下の通り。

//Book is entity class of information for book
type Book struct {
    Type            string
    ID              string
    Title           string
    SubTitle        string `json:",omitempty"`
    SeriesTitle     string `json:",omitempty"`
    OriginalTitle   string `json:",omitempty"`
    URL             string `json:",omitempty"`
    Image           BookCover
    ProductType     string    `json:",omitempty"`
    Creators        []Creator `json:",omitempty"`
    Publisher       string    `json:",omitempty"`
    Codes           []Code
    PublicationDate values.Date
    LastRelease     values.Date
    PublicDomain    bool   `json:",omitempty"`
    FirstAppearance string `json:",omitempty"`
    Service         Service
}

//Code is entity class of book code
type Code struct {
    Name  string
    Value string
}

//Creator is entity class of creator info.
type Creator struct {
    Name string
    Role string `json:",omitempty"`
}

//BookCover is entity class of book cover image info.
type BookCover struct {
    URL    string
    Height uint16 `json:",omitempty"`
    Width  uint16 `json:",omitempty"`
}

//Service is entity class of API service info.
type Service struct {
    Name string
    URL  string
}

また review, history コマンドで取得したレビュー・データのフォーマットは以下の通り。

//Review is entity class for review info.
type Review struct {
    Book        *entity.Book
    Date        values.Date
    Rating      int
    Star        [MAX_STAR]bool
    Description string `json:",omitempty"`
}

ちなみに，このブログにおけるレビューカードのテンプレートは以下の内容になっている。

<div class="hreview">{{ if .Book.Image.URL }}
  <div class="photo">{{ if .Book.URL }}<a class="item url" href="{{ .Book.URL }}">{{ end }}<img src="{{ .Book.Image.URL }}" width="{{ with .Book.Image.Width }}{{ . }}{{ else }}110{{ end }}" alt="photo">{{ if .Book.URL }}</a>{{ end }}</div>{{ end }}
  <dl class="fn">
    <dt>{{ if .Book.URL }}<a href="{{ .Book.URL }}">{{ end }}{{ .Book.Title }}{{ with .Book.SubTitle }} {{ . }}{{ end }}{{ with .Book.SeriesTitle }} ({{ . }}){{ end }}{{ if .Book.URL }}</a>{{ end }}</dt>{{ if .Book.OriginalTitle }}
    <dd>原題: {{ .Book.OriginalTitle }}</dd>{{ end }}{{ if .Book.FirstAppearance }}
    <dd>（初出: {{ .Book.FirstAppearance }}）</dd>{{ end }}{{ if .Book.Creators }}
    <dd>{{ range $i, $v := .Book.Creators }}{{ if ne $i 0 }}, {{ end }}{{ $v }}{{ end }}</dd>{{ end }}
    <dd>{{ .Book.Publisher }}{{ if not .Book.PublicationDate.IsZero }} {{ .Book.PublicationDate }}{{ end }}{{ if not .Book.LastRelease.IsZero }} (Release {{ .Book.LastRelease }}){{ end }}</dd>
    <dd>{{ .Book.ProductType }}{{ if .Book.PublicDomain }} (Public Domain){{ end }}</dd>{{ if .Book.Codes }}
    <dd>{{ range $i, $v := .Book.Codes }}{{ if ne $i 0 }}, {{ end }}{{ $v }}{{ end }}</dd>{{ end }}{{ if gt .Rating 0 }}
    <dd>評価<abbr class="rating fa-sm" title="{{ .Rating }}">{{ range .Star }}&nbsp;{{ if . }}<i class="fas fa-star"></i>{{ else }}<i class="far fa-star"></i>{{ end }}{{ end }}</abbr></dd>{{ end }}
  </dl>
  <p class="description">{{ .Description }}</p>
  <p class="powered-by">reviewed by <a href='#maker' class='reviewer'>Spiegel</a> on <abbr class="dtreviewed" title="{{ .Date }}">{{ .Date }}</abbr> (powered by {{ if .Book.Service.URL }}<a href="{{ .Book.Service.URL }}">{{ end }}{{ .Book.Service.Name }}{{ if .Book.Service.URL }}</a>{{ end }})</p>
</div>

テンプレート・ファイルを作成する際の参考にどうぞ。

参考情報

書籍データ取得ツール books-data v0.4.2 のリリース，他

2019-09-08T06:22:41+00:00

書籍データ取得ツール books-data v0.4.2 をリリースした。

Release v0.4.2 · spiegel-im-spiegel/books-data · GitHub

パッチバージョンが妙に進んでいるが気にしないように（笑）

機能的な変更は殆どないが Go 1.13 のリリースに併せて内部をいろいろ変更している。リファクタリングというやつである。

そうそう。設定ファイルの既定の置き場所を変更して XDG Base Directory に対応した。詳しくは以下の記事を参照のこと。

書籍データ取得ツール books-data

他には openBD クライアント側のハンドリング・パッケージを自前のもの spiegel-im-spiegel/openbd-api に換装した。 spiegel-im-spiegel/aozora-api もバージョンアップしている。

ブックマーク

Go 言語用 openBD クライアント・パッケージ

2019-09-07T13:10:02+00:00

goark/openbd-api: APIs for openBD by Golang

本パッケージは openBD へアクセスできる Go 言語用クライアント・パッケージだ。 openBD が提供する書籍情報を取得できる。

なお goark/openbd-api パッケージは Go 1.16 以上を要求する。ご注意を。

インポート

import "github.com/goark/openbd-api"

書籍情報の取得

openBD は ISBN をキーとして書籍情報の検索ができる。 goark/openbd-api パッケージでは以下のように記述する。

package main

import (
	"bytes"
	"fmt"
	"io"
	"os"

	"github.com/goark/openbd-api"
)

func main() {
	b, err := openbd.DefaultClient().LookupBooksRaw([]string{"9784274069321"})
	if err != nil {
		fmt.Println(err)
		return
	}
	io.Copy(os.Stdout, bytes.NewReader(b))
}

openbd.Client.LookupBooksRaw() 関数は，引数に複数の ISBN を指定することが可能で openBD から取得した結果（JSON 形式）をそのまま返す。

$ go run sample.go | jq .
[
  {
    "onix": {
      "RecordReference": "9784274069321",
      "NotificationType": "03",
      "ProductIdentifier": {
        "ProductIDType": "15",
        "IDValue": "9784274069321"
      },
      "DescriptiveDetail": {
        "ProductComposition": "00",
        "ProductForm": "BZ",
        "Measure": [
          {
            "MeasureType": "01",
            "Measurement": "210",
            "MeasureUnitCode": "mm"
          },
          {
            "MeasureType": "02",
            "Measurement": "0",
            "MeasureUnitCode": "mm"
          }
        ],
        "TitleDetail": {
          "TitleType": "01",
          "TitleElement": {
            "TitleElementLevel": "01",
            "TitleText": {
              "collationkey": "リーン カイハツ ノ ゲンバ : カンバン ニ ヨル ダイキボ プロジェクト ノ ウンエイ",
              "content": "リーン開発の現場 : カンバンによる大規模プロジェクトの運営"
            }
          }
        },
        "Contributor": [
          {
            "SequenceNumber": "1",
            "ContributorRole": [
              "A01"
            ],
            "PersonName": {
              "content": "Kniberg, Henrik"
            }
          },
          {
            "SequenceNumber": "2",
            "ContributorRole": [
              "A01"
            ],
            "PersonName": {
              "content": "オーム社"
            }
          },
          {
            "SequenceNumber": "3",
            "ContributorRole": [
              "A01"
            ],
            "PersonName": {
              "content": "オーム社開発局"
            }
          },
          {
            "SequenceNumber": "4",
            "ContributorRole": [
              "B06"
            ],
            "PersonName": {
              "content": "市谷 聡啓"
            }
          },
          {
            "SequenceNumber": "5",
            "ContributorRole": [
              "B06"
            ],
            "PersonName": {
              "content": "藤原 大"
            }
          },
          {
            "SequenceNumber": "6",
            "ContributorRole": [
              "B06"
            ],
            "PersonName": {
              "content": "角谷 信太郎"
            }
          },
          {
            "SequenceNumber": "7",
            "ContributorRole": [
              "A01"
            ],
            "PersonName": {
              "content": "クニバーグ ヘンリック"
            }
          }
        ],
        "Language": [
          {
            "LanguageRole": "01",
            "LanguageCode": "jpn",
            "CountryCode": "JP"
          }
        ],
        "Extent": [
          {
            "ExtentType": "11",
            "ExtentValue": "190",
            "ExtentUnit": "03"
          }
        ]
      },
      "CollateralDetail": {
        "TextContent": [
          {
            "TextType": "03",
            "ContentAudience": "00",
            "Text": "官公庁の大規模システム開発における、カンバンシステムを軸にしたプロジェクト進行の様子を、著者の経験に基づいて描写。「リーンソフトウェア開発」を現場でどのように適用するかを直裁的に解説しています。"
          },
          {
            "TextType": "04",
            "ContentAudience": "00",
            "Text": "第1部 僕らのやり方を伝えよう(プロジェクトについて\nチーム編成\nデイリーカクテルパーティーに参加しよう\nプロジェクトボード\nカンバンボードをスケールさせる ほか)\n第2部 テクニックを詳しく見る(アジャイルとリーンの概要\nテスト自動化の戦略\nプランニングポーカーによる見積り\n因果関係図\n最後に伝えたいこと)"
          }
        ],
        "SupportingResource": [
          {
            "ResourceContentType": "01",
            "ContentAudience": "01",
            "ResourceMode": "03",
            "ResourceVersion": [
              {
                "ResourceForm": "02",
                "ResourceVersionFeature": [
                  {
                    "ResourceVersionFeatureType": "01",
                    "FeatureValue": "D502"
                  },
                  {
                    "ResourceVersionFeatureType": "04",
                    "FeatureValue": "9784274069321.jpg"
                  }
                ],
                "ResourceLink": "https://cover.openbd.jp/9784274069321.jpg"
              }
            ]
          }
        ]
      },
      "PublishingDetail": {
        "Imprint": {
          "ImprintIdentifier": [
            {
              "ImprintIDType": "19",
              "IDValue": "274"
            }
          ],
          "ImprintName": "オーム社"
        },
        "PublishingDate": [
          {
            "PublishingDateRole": "01",
            "Date": ""
          }
        ]
      },
      "ProductSupply": {
        "SupplyDetail": {
          "ReturnsConditions": {
            "ReturnsCodeType": "04",
            "ReturnsCode": "02"
          },
          "ProductAvailability": "99"
        }
      }
    },
    "hanmoto": {
      "datecreated": "2016-08-24 22:49:25",
      "dateshuppan": "2013-10",
      "datemodified": "2016-08-24 22:49:25"
    },
    "summary": {
      "isbn": "9784274069321",
      "title": "リーン開発の現場 : カンバンによる大規模プロジェクトの運営",
      "volume": "",
      "series": "",
      "publisher": "オーム社",
      "pubdate": "2013-10",
      "cover": "https://cover.openbd.jp/9784274069321.jpg",
      "author": "Kniberg,Henrik／著 オーム社／著 オーム社開発局／著 市谷聡啓／翻訳 ほか"
    }
  }
]

openbd.Client.LookupBooks() 関数を使うと結果を openbd.Book 構造体の配列で返す。

books, err := openbd.DefaultClient().LookupBooks([]string{"9784274069321"})

openbd.Book 構造体の構成は以下の通り。

//Book is entity class of book info.
type Book struct {
	Onix    Onix    `json:"onix"`
	Hanmoto Hanmoto `json:"hanmoto"`
	Summary Summary `json:"summary"`
}

//Onix is entity class of JPRO-onix items
type Onix struct {
	RecordReference   string //ISBN code (key code)
	NotificationType  string
	ProductIdentifier struct {
		ProductIDType string
		IDValue       string //ISBN ?
	}
	DescriptiveDetail struct {
		ProductComposition string
		ProductForm        string
		Measure            []struct {
			MeasureType     string
			Measurement     string
			MeasureUnitCode string
		} `json:",omitempty"`
		Collection struct {
			CollectionType     string
			CollectionSequence *struct {
				CollectionSequenceType     string `json:",omitempty"`
				CollectionSequenceTypeName string `json:",omitempty"`
				CollectionSequenceNumber   string `json:",omitempty"`
			} `json:",omitempty"`
			TitleDetail *struct {
				TitleType    string `json:",omitempty"`
				TitleElement []struct {
					TitleElementLevel string
					TitleText         struct {
						Content      string `json:"content"`
						CollationKey string `json:"collationkey,omitempty"`
					}
				} `json:",omitempty"`
			} `json:",omitempty"`
		}
		TitleDetail struct {
			TitleType    string
			TitleElement struct {
				TitleElementLevel string
				TitleText         struct {
					Content      string `json:"content"`
					Collationkey string `json:"collationkey,omitempty"`
				}
			}
		}
		Contributor []struct {
			SequenceNumber  string
			ContributorRole []string `json:",omitempty"`
			PersonName      struct {
				Content      string `json:"content"`
				Collationkey string `json:"collationkey,omitempty"`
			}
			BiographicalNote string `json:",omitempty"`
		} `json:",omitempty"`
		Language []struct {
			LanguageRole string
			LanguageCode string
			CountryCode  string
		} `json:",omitempty"`
		Extent []struct {
			ExtentType  string
			ExtentValue string
			ExtentUnit  string
		} `json:",omitempty"`
		Subject []struct {
			SubjectSchemeIdentifier string
			SubjectCode             string
			SubjectHeadingText      string `json:",omitempty"`
		} `json:",omitempty"`
		Audience []struct {
			AudienceCodeType  string
			AudienceCodeValue string
		} `json:",omitempty"`
	}
	CollateralDetail *struct {
		TextContent []struct {
			TextType        string
			ContentAudience string
			Text            string
		} `json:",omitempty"`
		SupportingResource []struct {
			ResourceContentType string
			ContentAudience     string
			ResourceMode        string
			ResourceVersion     []struct {
				ResourceForm           string
				ResourceVersionFeature []struct {
					ResourceVersionFeatureType string
					FeatureValue               string
				} `json:",omitempty"`
				ResourceLink string
			} `json:",omitempty"`
		} `json:",omitempty"`
	} `json:",omitempty"`
	PublishingDetail struct {
		Imprint struct {
			ImprintIdentifier []struct {
				ImprintIDType string
				IDValue       string
			} `json:",omitempty"`
			ImprintName string
		}
		Publisher struct {
			PublisherIdentifier []struct {
				PublisherIDType string
				IDValue         string
			} `json:",omitempty"`
			PublishingRole string
			PublisherName  string
		}
		PublishingDate []struct {
			Date               Date
			PublishingDateRole string
		} `json:",omitempty"`
	}
	ProductSupply struct {
		SupplyDetail struct {
			ReturnsConditions struct {
				ReturnsCodeType string
				ReturnsCode     string
			}
			ProductAvailability string
			Price               []struct {
				PriceType    string
				CurrencyCode string
				PriceAmount  string
			} `json:",omitempty"`
		}
	}
}

//Hanmoto is entity class of Hanmoto dot com items
type Hanmoto struct {
	DatePublished Date `json:"dateshuppan"`
	DateModified  Date `json:"datemodified"`
	DateCreated   Date `json:"datecreated"`
	DateReleased  Date `json:"datekoukai"`
	IsLightNovel  bool `json:"lanove,omitempty"`
	HasReview     bool `json:"hasshohyo,omitempty"`
	Reviews       []struct {
		Reviewer       string `json:"reviewer"`
		Link           string `json:"link"`
		DateAppearance Date   `json:"appearance"`
		SourceKindID   int    `json:"kubun_id"`
		SourceID       int    `json:"source_id"`
		Source         string `json:"source"`
		PaperType      string `json:"choyukan"`
		PostUser       string `json:"post_user"`
		Han            string `json:"han"`
		Gou            string `json:"gou"`
	} `json:"reviews,omitempty"`
	HasSample bool `json:"hastameshiyomi,omitempty"`
}

//Summary is entity class of summary data
type Summary struct {
	ISBN      string `json:"isbn"`
	Title     string `json:"title"`
	Volume    string `json:"volume"`
	Series    string `json:"series"`
	Publisher string `json:"publisher"`
	PubDate   Date   `json:"pubdate"`
	Author    string `json:"author"`
	Cover     string `json:"cover"`
}

openbd.Book 構造体はこのままでは使い辛いので以下のヘルパ関数を用意した。引数がないのでテンプレートでは値のように扱うことができる。

openbd.Book.IsValid() bool
openbd.Book.Id() string
openbd.Book.ISBN() string
openbd.Book.Title() string
openbd.Book.SubTitle() string : 現在は空文字列のみ返す
openbd.Book.SeriesTitle() string
openbd.Book.Label() string
openbd.Book.ImageURL() string
openbd.Book.Authors() []string
openbd.Book.Publisher() string
openbd.Book.PublicationDate() openbd.Date
openbd.Book.Description() string

Server および Client インスタンスの生成

openbd.Client インスタンスの生成は openbd.DefaultClient() 関数で簡単に行えるが，もう少し細かい制御もできる。

openBD サーバを指定する

openbd.New() 関数で openbd.Server インスタンスを生成できるが，引数としてサーバを指定できる。

server := openbd.New(
    openbd.WithScheme("https"),
    openbd.WithServerName("api.example.com"),
)

これで openBD サーバとして https://api.example.com を指定できた（実在しない URL なので注意）。

http.Client を指定する

openbd.Server.CreateClient() 関数により openbd.Client インスタンスを生成できるが，引数として http.Client インスタンスを指定できる。

client := openbd.New(
    openbd.WithScheme("https"),
    openbd.WithServerName("api.example.com"),
).CreateClient(openbd.WithHttpClient(&http.Client{}))

ちなみに openbd.DefaultClient() 関数は以下の記述と同等である。

client := openbd.New(
    openbd.WithScheme("https"),
    openbd.WithServerName("api.openbd.jp"),
).CreateClient(openbd.WithHttpClient(&http.Client{}))

context.Context 付きのアクセス

openBD へのアクセスの際に context.Context を付けることができる。

rawjson, err := openbd.DefaultClient().
    LookupBooksRawContext(context.Background(), []string{"9784274069321"})

books, err := openbd.DefaultClient().
    LookupBooksContext(context.Background(), []string{"9784274069321"})

参考図書

プログラミング言語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)

書籍データ取得ツール books-data v0.3.0 をリリースした

2019-08-12T06:10:56+00:00

書籍データ取得ツール books-data v0.3.0 をリリースした。

Release v0.3.0 · spiegel-im-spiegel/books-data · GitHub

ようやく青空文庫 API に対応したですよ。

$ books-data -h
Search for books data

Usage:
  books-data [flags]
  books-data [command]

Available Commands:
  help        Help about any command
  history     Lookup review data from history log
  review      Make review data
  search      Search for books data
  version     Print the version number

Flags:
      --access-key string      Config: PA-API Access Key ID
  -c, --aozora-card string     Aozora-bunko card no.
  -a, --asin string            Amazon ASIN code
      --associate-tag string   Config: PA-API Associate Tag
      --config string          Config file (default $HOME/.books-data.yaml)
      --debug                  for debug
  -h, --help                   help for books-data
  -i, --isbn string            ISBN code
      --marketplace string     Config: PA-API Marketplace (default "webservices.amazon.co.jp")
  -l, --review-log string      Config: Review log file (JSON format)
      --secret-key string      Config: PA-API Secret Access Key
  -t, --template-file string   Template file for formatted output

Use "books-data [command] --help" for more information about a command.

これに伴い aozora-api パッケージも公開し books-data に組み込んでいる。ちなみに aozora-api パッケージは青空文庫 API をフルサポートしている。

たとえば谷崎潤一郎さんの「陰翳礼讃」の図書カードNo.は 56642 なので

$ books-data search -c 56642 | jq .
{
  "Type": "aozora",
  "ID": "56642",
  "Title": "陰翳礼讃",
  "URL": "https://www.aozora.gr.jp/cards/001383/card56642.html",
  "Image": {
    "URL": ""
  },
  "ProductType": "青空文庫",
  "Authors": [
    "谷崎 潤一郎"
  ],
  "Codes": [
    {
      "Name": "図書カードNo.",
      "Value": "56642"
    }
  ],
  "PublicationDate": "2016-08-23",
  "LastRelease": "2016-06-10",
  "PublicDomain": true,
  "FirstAppearance": "「経済往来」1933（昭和8）年12月号、1934（昭和9）年1月号",
  "Service": {
    "Name": "aozorahack",
    "URL": "https://aozorahack.org/"
  }
}

てな感じで情報が取れる。翻訳作品も対応している。たとえば「ニャルラトホテプ」なら

$ books-data search -c 56839 | jq .
{
  "Type": "aozora",
  "ID": "56839",
  "Title": "ニャルラトホテプ",
  "OriginalTitle": "NYARLATHOTEP",
  "URL": "https://www.aozora.gr.jp/cards/001699/card56839.html",
  "Image": {
    "URL": ""
  },
  "ProductType": "青空文庫",
  "Authors": [
    "ラヴクラフト ハワード・フィリップス"
  ],
  "Creators": [
    {
      "Name": "大久保 ゆう",
      "Role": "翻訳"
    }
  ],
  "Codes": [
    {
      "Name": "図書カードNo.",
      "Value": "56839"
    }
  ],
  "PublicationDate": "2014-04-04",
  "LastRelease": "2015-08-19",
  "Service": {
    "Name": "aozorahack",
    "URL": "https://aozorahack.org/"
  }
}

という感じ。

青空文庫は書影データを持ってないのが寂しい限りだが，自前で用意できるならレビューデータ作成時に --image-url オプションを使って

$ books-data review -c 56642 --image-url https://text.baldanders.info/images/aozora/card56839.svg -r 4 "SAN 値が下がる。" | jq .
{
  "Book": {
    "Type": "aozora",
    "ID": "56642",
    "Title": "陰翳礼讃",
    "URL": "https://www.aozora.gr.jp/cards/001383/card56642.html",
    "Image": {
      "URL": "https://text.baldanders.info/images/aozora/card56839.svg"
    },
    "ProductType": "青空文庫",
    "Authors": [
      "谷崎 潤一郎"
    ],
    "Codes": [
      {
        "Name": "図書カードNo.",
        "Value": "56642"
      }
    ],
    "PublicationDate": "2016-08-23",
    "LastRelease": "2016-06-10",
    "PublicDomain": true,
    "FirstAppearance": "「経済往来」1933（昭和8）年12月号、1934（昭和9）年1月号",
    "Service": {
      "Name": "aozorahack",
      "URL": "https://aozorahack.org/"
    }
  },
  "Date": "2019-08-12",
  "Rating": 4,
  "Star": [
    true,
    true,
    true,
    true,
    false
  ],
  "Description": "SAN 値が下がる。"
}

などとすれば書影データを補完できる。これで適当なテンプレートを噛ませれば

ニャルラトホテプ: 原題: NYARLATHOTEP; ラヴクラフトハワード・フィリップス, 大久保ゆう (翻訳); 2014-04-04 (Release 2015-08-19); 青空文庫; 56839 (図書カードNo.); 評価

SAN 値が下がる。

reviewed by Spiegel on 2019-03-28 (powered by aozorahack)

てな感じに仕上げることができる。

これで個人的に欲しい機能は一通り揃ったかな。

ブックマーク

書籍データ取得ツール books-data v0.2.0 をリリースした

2019-08-04T10:48:15+00:00

書籍データ取得ツール books-data v0.2.0 をリリースした。

Release v0.2.0 · spiegel-im-spiegel/books-data · GitHub

v0.1.0 の使い勝手が微妙に悪かったのでコマンド構成を変えた。

$ books-data -h
Search for books data

Usage:
  books-data [flags]
  books-data [command]

Available Commands:
  help        Help about any command
  history     Lookup review data from history log
  review      Make review data
  search      Search for books data
  version     Print the version number

Flags:
      --access-key string      Config: PA-API Access Key ID
  -a, --asin string            Amazon ASIN code
      --associate-tag string   Config: PA-API Associate Tag
      --config string          Config file (default $HOME/.books-data.yaml)
      --debug                  for debug
  -h, --help                   help for books-data
  -i, --isbn string            ISBN code
      --marketplace string     Config: PA-API Marketplace (default "webservices.amazon.co.jp")
  -l, --review-log string      Config: Review log file (JSON format)
      --secret-key string      Config: PA-API Secret Access Key
  -t, --template-file string   Template file for formatted output

Use "books-data [command] --help" for more information about a command.

search コマンドで PA-API または openBD から書籍情報を検索する。 ASIN コードを指定する場合はこんな感じ（Web ページへのリンク URL は長ったらしいので省略している，あしからず）。

$ books-data search -a B07TYKJQFK | jq .
{
  "Type": "paapi",
  "ID": "B07TYKJQFK",
  "Title": "数学ガールの秘密ノート／ビットとバイナリー",
  "URL": "https://www.amazon.co.jp/exec/obidos/ASIN/B07TYKJQFK/mytag-20/",
  "Image": {
    "URL": "https://images-fe.ssl-images-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg",
    "Height": 160,
    "Width": 111
  },
  "ProductType": "Kindle版",
  "Authors": [
    "結城 浩"
  ],
  "Publisher": "SBクリエイティブ",
  "Codes": [
    {
      "Name": "ASIN",
      "Value": "B07TYKJQFK"
    }
  ],
  "PublicationDate": "2019-07-19",
  "LastRelease": "2019-07-20",
  "Service": {
    "Name": "PA-API",
    "URL": "https://affiliate.amazon.co.jp/assoc_credentials/home"
  }
}

PA-API へアクセスするためのアクセスキー等の情報は設定ファイル（既定は $HOME/.books-data.yaml）で指定できる。

marketplace: webservices.amazon.co.jp
associate-tag: mytag-20
access-key: AKIAIOSFODNN7EXAMPLE
secret-key: 1234567890

PA-API のアクセスキーがない場合は -i オプションで ISBN を指定して openBD から検索できる。

$ books-data search -i 9784797391398 | jq .
{
  "Type": "openbd",
  "ID": "9784797391398",
  "Title": "数学ガールの秘密ノート／ビットとバイナリー",
  "Image": {
    "URL": "https://cover.openbd.jp/9784797391398.jpg",
    "Height": 0,
    "Width": 0
  },
  "ProductType": "Book",
  "Authors": [
    "結城浩／著"
  ],
  "Publisher": "ＳＢクリエイティブ",
  "Codes": [
    {
      "Name": "ISBN",
      "Value": "9784797391398"
    }
  ],
  "PublicationDate": "2019-07-22",
  "LastRelease": "0001-01-01",
  "Service": {
    "Name": "openBD",
    "URL": "https://openbd.jp/"
  }
}

前回書いたとおり，まるでやる気の感じられない情報量だけど（笑）

レビュー情報を作成する場合は review コマンドを使う。

$ books-data review -a B07TYKJQFK -r 5 "この本はオススメ" | jq .
{
  "Book": {
    "Type": "paapi",
    "ID": "B07TYKJQFK",
    "Title": "数学ガールの秘密ノート／ビットとバイナリー",
    "URL": "https://www.amazon.co.jp/exec/obidos/ASIN/B07TYKJQFK/mytag-20/",
    "Image": {
      "URL": "https://images-fe.ssl-images-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg",
      "Height": 160,
      "Width": 111
    },
    "ProductType": "Kindle版",
    "Authors": [
      "結城 浩"
    ],
    "Publisher": "SBクリエイティブ",
    "Codes": [
      {
        "Name": "ASIN",
        "Value": "B07TYKJQFK"
      }
    ],
    "PublicationDate": "2019-07-19",
    "LastRelease": "2019-07-20",
    "Service": {
      "Name": "PA-API",
      "URL": "https://affiliate.amazon.co.jp/assoc_credentials/home"
    }
  },
  "Date": "2019-08-04",
  "Rating": 5,
  "Star": [
    true,
    true,
    true,
    true,
    true
  ],
  "Description": "この本はオススメ"
}

作成したデータ（JSON 形式）はログファイルにも蓄積される。ログファイルは review-log オプションで設定ファイルまたはコマンドラインで指定する。

review-log: /home/username/review-log.json

ログファイルが設定されていれば history コマンドでレビュー情報を取り出すことができる。

$ books-data history -a B07TYKJQFK | jq .
{
  "Book": {
    "Type": "paapi",
    "ID": "B07TYKJQFK",
    "Title": "数学ガールの秘密ノート／ビットとバイナリー",
    "URL": "https://www.amazon.co.jp/exec/obidos/ASIN/B07TYKJQFK/mytag-20/",
    "Image": {
      "URL": "https://images-fe.ssl-images-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg",
      "Height": 160,
      "Width": 111
    },
    "ProductType": "Kindle版",
    "Authors": [
      "結城 浩"
    ],
    "Publisher": "SBクリエイティブ",
    "Codes": [
      {
        "Name": "ASIN",
        "Value": "B07TYKJQFK"
      }
    ],
    "PublicationDate": "2019-07-19",
    "LastRelease": "2019-07-20",
    "Service": {
      "Name": "PA-API",
      "URL": "https://affiliate.amazon.co.jp/assoc_credentials/home"
    }
  },
  "Date": "2019-08-04",
  "Rating": 5,
  "Star": [
    true,
    true,
    true,
    true,
    true
  ],
  "Description": "この本はオススメ"
}

ログファイルの中身は以下のような JSON 形式の配列として格納されているので，ぶっちゃけテキスト・エディタ等で編集できる（笑）

[
  {
    "Book": {
      "Type": "paapi",
      "ID": "B07TYKJQFK",
      "Title": "数学ガールの秘密ノート／ビットとバイナリー",
      "URL": "https://www.amazon.co.jp/exec/obidos/ASIN/B07TYKJQFK/mytag-20/",
      "Image": {
        "URL": "https://images-fe.ssl-images-amazon.com/images/I/41Q0Hyr8g3L._SL160_.jpg",
        "Height": 160,
        "Width": 111
      },
      "ProductType": "Kindle版",
      "Authors": [
        "結城 浩"
      ],
      "Publisher": "SBクリエイティブ",
      "Codes": [
        {
          "Name": "ASIN",
          "Value": "B07TYKJQFK"
        }
      ],
      "PublicationDate": "2019-07-19",
      "LastRelease": "2019-07-20",
      "Service": {
        "Name": "PA-API",
        "URL": "https://affiliate.amazon.co.jp/assoc_credentials/home"
      }
    },
    "Date": "2019-08-04",
    "Rating": 5,
    "Star": [
      true,
      true,
      true,
      true,
      true
    ],
    "Description": "この本はオススメ"
  }
]

いや，最初は SQLite とか使おうと思ったのよ。でも途中までテーブル設計してたら思ったより面倒な感じがしたのでしばらく先送りすることにした。他に追加したい機能もあったりするし，データ構造が固まるまでは JSON 形式のままアドホックな運用でもいいかな，と。

以上，いいわけでした。

なお search および review, history コマンドではテンプレートファイルを指定して出力を整形できる。こんな感じ。

$ books-data search -a B07TYKJQFK -t testdata/book-template/template.bib.txt 
@BOOK{Book:B07TYKJQFK,
    TITLE = "数学ガールの秘密ノート／ビットとバイナリー",
    AUTHOR = "結城 浩",
    PUBLISHER = {SBクリエイティブ},
    YEAR = 2019
}

よし。次はいよいよ青空文庫APIサーバへの対応に取り掛かるぞ。

今回紹介した書籍

数学ガールの秘密ノート／ビットとバイナリー: 結城浩 (著); SBクリエイティブ 2019-07-19 (Release 2019-07-20); Kindle版; B07TYKJQFK (ASIN); 評価

サブタイトルから期待はしてたけど，今回はリサちゃんが大盛りだ！（《ちゃん》は不要）

reviewed by Spiegel on 2019-08-13 (powered by PA-APIv5)

書籍データ取得ツール books-data の最初のリリース

2019-07-27T12:46:19+00:00

いやね。以前公開した PA-API を使った書籍情報検索ツール amazon-item が一時的に使えなくなったのよ。理由は30日以上売り上げがなかったため。

まぁ，ここはアフィリエイトが目的のブログじゃないし，いつかはこんなことになるだろうとは思っていたけど，やっぱ PA-API に依存するのは拙いと思い代わりになるものを探してたんだけど，現状では openBD くらいしか選択肢がないらしい。

ちうわけで PA-API にも openBD にも対応する書籍情報取得ツールを作ったですよ。

例によって CLI のツール。

$ books-data -h
Search for books data

Usage:
  books-data [flags]
  books-data [command]

Available Commands:
  help        Help about any command
  openbd      Search for books data by openBD
  paapi       Search for books data by PA-API
  version     Print the version number

Flags:
      --debug   for debug
  -h, --help    help for books-data
      --pipe    Import description from Stdin
      --raw     Output raw data from openBD

Use "books-data [command] --help" for more information about a command.

openbd および paapi コマンドで取得先を切り換える。

PA-API による書籍情報の取得

PA-API による書籍情報の取得は以下のコマンドラインで行う。

$ books-data paapi -h
Search for books data by PA-API

Usage:
  books-data paapi [flags] [description]

Flags:
      --access-key string      PA-API: Access Key ID
  -a, --asin string            Amazon ASIN code
      --associate-tag string   PA-API: Associate Tag
      --config string          config file (default $HOME/.paapi.yaml)
  -h, --help                   help for paapi
      --marketplace string     PA-API: Marketplace (default "webservices.amazon.co.jp")
  -r, --rating int             Rating of product
      --review-date string     Date of review
      --secret-key string      PA-API: Secret Access Key
  -t, --template string        Template file

Global Flags:
      --debug   for debug
      --pipe    Import description from Stdin
      --raw     Output raw data from openBD

PA-API に必要な設定はホーム・ディレクトリの .paapi.yaml ファイルに記述する。こんな感じ。

$ cat ~/.paapi.yaml
associate-tag: mytag-20
access-key: AKIAIOSFODNN7EXAMPLE
secret-key: 1234567890

これをセットした上で ASIN コードを指定して書籍情報を取得する。結果は JSON フォーマットで出力される。こんな感じ（一部データを端折っているのであしからず）。

$ books-data paapi -a 427406932X | jq .
{
  "Book": {
    "ID": "427406932X",
    "Title": "リーン開発の現場 カンバンによる大規模プロジェクトの運営",
    "URL": "https://www.amazon.co.jp/exec/obidos/ASIN/427406932X/mytag-20",
    "Image": {
      "URL": "https://images-fe.ssl-images-amazon.com/images/I/51llL1uygcL._SL160_.jpg",
      "Height": 160,
      "Width": 116
    },
    "ProductType": "単行本（ソフトカバー）",
    "Authors": [
      "Henrik Kniberg"
    ],
    "Creators": [
      {
        "Name": "角谷 信太郎",
        "Role": "翻訳"
      },
      {
        "Name": "市谷 聡啓",
        "Role": "翻訳"
      },
      {
        "Name": "藤原 大",
        "Role": "翻訳"
      }
    ],
    "Publisher": "オーム社",
    "Codes": [
      {
        "Name": "ASIN",
        "Value": "427406932X"
      },
      {
        "Name": "EAN",
        "Value": "9784274069321"
      }
    ],
    "PublicationDate": "2013-10-26",
    "LastRelease": "0001-01-01",
    "Service": {
      "Name": "PA-API",
      "URL": "https://affiliate.amazon.co.jp/assoc_credentials/home"
    }
  },
  "Date": "2019-07-27",
  "Rating": 0,
  "Star": [
    false,
    false,
    false,
    false,
    false
  ]
}

また適当なテンプレートファイルを指定することで任意のフォーマットで指定することも可能。たとえば

$ cat template/template.html 
<div class="hreview">{{ if .Book.Image.URL }}
  <div class="photo">{{ if .Book.URL }}<a class="item url" href="{{ .Book.URL }}">{{ end }}<img src="{{ .Book.Image.URL }}"{{ with .Book.Image.Width }} width="{{ . }}"{{ end }} alt="photo">{{ if .Book.URL }}</a>{{ end }}</div>{{ end }}
  <dl class="fn">
    <dt>{{ if .Book.URL }}<a href="{{ .Book.URL }}">{{ end }}{{ .Book.Title }}{{ if .Book.URL }}</a>{{ end }}</dt>{{ if .Book.Authors }}
    <dd>{{ range $i, $v := .Book.Authors }}{{ if ne $i 0 }}, {{ end }}{{ $v }}{{ end }}</dd>{{ end }}{{ if .Book.Creators }}
    <dd>{{ range $i, $v := .Book.Creators }}{{ if ne $i 0 }}, {{ end }}{{ $v }}{{ end }}</dd>{{ end }}
    <dd>{{ .Book.Publisher }}{{ if gt .Book.PublicationDate.Year 1 }} {{ .Book.PublicationDate }}{{ end }}{{ if gt .Book.LastRelease.Year 1 }} (Release {{ .Book.LastRelease }}){{ end }}</dd>
    <dd>{{ .Book.ProductType }}</dd>{{ if .Book.Codes }}
    <dd>{{ range $i, $v := .Book.Codes }}{{ if ne $i 0 }}, {{ end }}{{ $v }}{{ end }}</dd>{{ end }}{{ if gt .Rating 0 }}
    <dd>Rating<abbr class="rating fa-sm" title="{{ .Rating }}">{{ range .Star }}&nbsp;{{ if . }}<i class="fas fa-star"></i>{{ else }}<i class="far fa-star"></i>{{ end }}{{ end }}</abbr></dd>{{ end }}
  </dl>
  <p class="description">{{ .Description }}</p>
  <p class="powered-by" >reviewed by <a href='#maker' class='reviewer'>Spiegel</a> on <abbr class="dtreviewed" title="{{ .Date }}">{{ .Date }}</abbr> (powered by {{ if .Book.Service.URL }}<a href="{{ .Book.Service.URL }}" >{{ end }}{{ .Book.Service.Name }}{{ if .Book.Service.URL }}</a>{{ end }})</p>
</div>

というテンプレートファイルを使えば

$ books-data paapi -a 427406932X -r 4 -t template/template.html 
<div class="hreview">
  <div class="photo"><a class="item url" href="https://www.amazon.co.jp/exec/obidos/ASIN/427406932X/mytag-20"><img src="https://images-fe.ssl-images-amazon.com/images/I/51llL1uygcL._SL160_.jpg" width="116" alt="photo"></a></div>
  <dl class="fn">
    <dt><a href="https://www.amazon.co.jp/exec/obidos/ASIN/427406932X/mytag-20">リーン開発の現場 カンバンによる大規模プロジェクトの運営</a></dt>
    <dd>Henrik Kniberg</dd>
    <dd>角谷 信太郎 (翻訳), 市谷 聡啓 (翻訳), 藤原 大 (翻訳)</dd>
    <dd>オーム社 2013-10-26</dd>
    <dd>単行本（ソフトカバー）</dd>
    <dd>427406932X (ASIN), 9784274069321 (EAN)</dd>
    <dd>Rating<abbr class="rating fa-sm" title="4">&nbsp;<i class="fas fa-star"></i>&nbsp;<i class="fas fa-star"></i>&nbsp;<i class="fas fa-star"></i>&nbsp;<i class="fas fa-star"></i>&nbsp;<i class="far fa-star"></i></abbr></dd>
  </dl>
  <p class="description"></p>
  <p class="powered-by" >reviewed by <a href='#maker' class='reviewer'>Spiegel</a> on <abbr class="dtreviewed" title="2019-07-27">2019-07-27</abbr> (powered by <a href="https://affiliate.amazon.co.jp/assoc_credentials/home" >PA-API</a>)</p>
</div>

ってな感じに整形してくれる。

openBD による書籍情報の取得

openBD による書籍情報の取得は以下のコマンドラインで行う。

$ books-data openbd -h
Search for books data by openBD

Usage:
  books-data openbd [flags] [description]

Flags:
  -h, --help                 help for openbd
  -i, --isbn string          ISBN code
  -r, --rating int           Rating of product
      --review-date string   Date of review
  -t, --template string      Template file

Global Flags:
      --debug   for debug
      --pipe    Import description from Stdin
      --raw     Output raw data from openBD

使い方は paapi コマンドとほぼ同じ。微妙にオプション名が違うのは仕様である。

$ books-data openbd -i 427406932X | jq .
{
  "Book": {
    "ID": "9784274069321",
    "Title": "リーン開発の現場 : カンバンによる大規模プロジェクトの運営",
    "Image": {
      "URL": "https://cover.openbd.jp/9784274069321.jpg",
      "Height": 0,
      "Width": 0
    },
    "ProductType": "Book",
    "Authors": [
      "Kniberg,Henrik／著 オーム社／著 オーム社開発局／著 市谷聡啓／翻訳 ほか"
    ],
    "Publisher": "オーム社",
    "Codes": [
      {
        "Name": "ISBN",
        "Value": "9784274069321"
      }
    ],
    "PublicationDate": "2013-10-01",
    "LastRelease": "0001-01-01",
    "Service": {
      "Name": "openBD",
      "URL": "https://openbd.jp/"
    }
  },
  "Date": "2019-07-27",
  "Rating": 0,
  "Star": [
    false,
    false,
    false,
    false,
    false
  ]
}

ご覧の通り，圧倒的に情報量が少ない。書籍を紹介する Web ページへのリンクもないとか，やる気のないことこの上ない。

たとえばテンプレートファイルを

$ cat template/template.bib.txt 
@BOOK{Book:{{ .Book.ID }},
    TITLE = "{{ .Book.Title }}"{{ if .Book.Authors }},
    AUTHOR = "{{ range $i, $v := .Book.Authors }}{{ if ne $i 0 }} and {{ end }}{{ $v }}{{ end }}{{ if .Book.Creators }}{{ range .Book.Creators }} and {{ . }}{{ end }}{{ end }}"{{ end }}{{ if .Book.Publisher }},
    PUBLISHER = {{ "{" }}{{ .Book.Publisher }}{{ "}" }}{{ end }}{{ if gt .Book.PublicationDate.Year 1 }},
    YEAR = {{ .Book.PublicationDate.Year }}{{ end }}
}

みたいにすれば

$ books-data openbd -i 427406932X -t template/template.bib.txt 
@BOOK{Book:9784274069321,
    TITLE = "リーン開発の現場 : カンバンによる大規模プロジェクトの運営",
    AUTHOR = "Kniberg,Henrik／著 オーム社／著 オーム社開発局／著 市谷聡啓／翻訳 ほか",
    PUBLISHER = {オーム社},
    YEAR = 2013
}

てな感じに BiBTeX 風の出力にもできるので，全く使えないこともない？

今後の予定

青空文庫APIサーバとかあるらしいので，こちらも対応していきたい。でも青空文庫は書影がないんだよなぁ。