List of Aozorahack [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 言語用青空文庫 API クライアント・パッケージ

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

goark/aozora-api: APIs for Aozora-bunko RESTful Service by Golang

本パッケージは青空文庫 API へアクセスできる Go 言語用クライアント・パッケージだ。 API を通じて青空文庫に収録されている作品情報等を取得できる。

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

インポート

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

簡単な使い方

作品情報の取得

たとえばタイトル名「天に積む宝」著者名「富田倫生」を検索キーとして青空文庫 API から作品情報を取得してみる。

package main

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

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

func main() {
    b, err := aozora.DefaultClient().SearchBooksRaw(
        aozora.WithBookTitle("/天に積む宝/"),
        aozora.WithBookAuthor("富田倫生"),
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(b))
}

検索オプションは以下の関数と連動している。これらの関数をaozora.Client.SearchBooksRaw() 関数の引数に指定する。

オプション名	対応する関数
`title`	`aozora.WithBookTitle(string)`
`author`	`aozora.WithBookAuthor(string)`
`fields`	`aozora.WithBookFields(string)`¹
`limit`	`aozora.WithBookLimit(int)`
`skip`	`aozora.WithBookSkip(int)`
`after`	`aozora.WithBookAfter(time.Time)`

aozora.Client.SearchBooksRaw() 関数は API を通じて取得した結果（JSON 形式）をそのまま返す。

$ go run sample.go | jq .
[
  {
    "book_id": 59489,
    "title": "「天に積む宝」のふやし方、へらし方",
    "title_yomi": "「てんにつむたから」のふやしかた、へらしかた",
    "title_sort": "てんにつむたからのふやしかたへらしかた",
    "subtitle": "著作権保護期間延長が青空文庫にもたらすもの",
    "subtitle_yomi": "ちょさくけんほごきかんえんちょうがあおぞらぶんこにもたらすもの",
    "original_title": "",
    "first_appearance": "",
    "ndc_code": "",
    "font_kana_type": "新字新仮名",
    "copyright": true,
    "release_date": "2019-01-01T00:00:00.000Z",
    "last_modified": "2018-12-24T00:00:00.000Z",
    "card_url": "https://www.aozora.gr.jp/cards/000055/card59489.html",
    "base_book_1": "インターネット図書館　青空文庫",
    "base_book_1_publisher": "はる書房",
    "base_book_1_1st_edition": "2005（平成17）年11月15日",
    "base_book_1_edition_input": "2005（平成17）年11月15日初版第1刷",
    "base_book_1_edition_proofing": "2005（平成17）年11月15日初版第1刷",
    "base_book_1_parent": "",
    "base_book_1_parent_publisher": "",
    "base_book_1_parent_1st_edition": "",
    "base_book_2": "",
    "base_book_2_publisher": "",
    "base_book_2_1st_edition": "",
    "base_book_2_edition_input": "",
    "base_book_2_edition_proofing": "",
    "base_book_2_parent": "",
    "base_book_2_parent_publisher": "",
    "base_book_2_parent_1st_edition": "",
    "input": "富田晶子",
    "proofing": "雪森",
    "text_url": "https://www.aozora.gr.jp/cards/000055/files/59489_txt_66663.zip",
    "text_last_modified": "2018-12-24T00:00:00.000Z",
    "text_encoding": "ShiftJIS",
    "text_charset": "JIS X 0208",
    "text_updated": 0,
    "html_url": "https://www.aozora.gr.jp/cards/000055/files/59489_66714.html",
    "html_last_modified": "2018-12-24T00:00:00.000Z",
    "html_encoding": "ShiftJIS",
    "html_charset": "JIS X 0208",
    "html_updated": 0,
    "authors": [
      {
        "person_id": 55,
        "last_name": "富田",
        "first_name": "倫生"
      }
    ]
  }
]

図書カード No. が分かっている場合は aozora.Client.LookupBookRaw() 関数で作品情報を取得できる。

func main() {
    b, err := aozora.DefaultClient().LookupBookRaw(59489)
    if err != nil {
        fmt.Println(err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(b))
}

aozora.Client.SearchBooks() または aozora.Client.LookupBook() 関数を使うと結果を aozora.Book 構造体で返す。

book, err := aozora.DefaultClient().LookupBook(59489)

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

//Author is entity class of author and translator info.
type Author struct {
    PersonID  int    `json:"person_id"`
    LastName  string `json:"last_name"`
    FirstName string `json:"first_name"`
}

//Book is entity class of book info.
type Book struct {
    BookID                      int      `json:"book_id"`
    Title                       string   `json:"title"`
    TitleYomi                   string   `json:"title_yomi"`
    TitleSort                   string   `json:"title_sort"`
    Subtitle                    string   `json:"subtitle"`
    SubtitleYomi                string   `json:"subtitle_yomi"`
    OriginalTitle               string   `json:"original_title"`
    FirstAppearance             string   `json:"first_appearance"`
    NDCCode                     string   `json:"ndc_code"`
    FontKanaType                string   `json:"font_kana_type"`
    Copyright                   bool     `json:"copyright"`
    ReleaseDate                 Date     `json:"release_date"`
    LastModified                Date     `json:"last_modified"`
    CardURL                     string   `json:"card_url"`
    BaseBook1                   string   `json:"base_book_1"`
    BaseBookPublisher1          string   `json:"base_book_1_publisher"`
    BaseBookFirstEdition1       string   `json:"base_book_1_1st_edition"`
    BaseBookEditionInput1       string   `json:"base_book_1_edition_input"`
    BaseBookEditionProofing1    string   `json:"base_book_1_edition_proofing"`
    BaseBookParent1             string   `json:"base_book_1_parent"`
    BaseBookParentPublisher1    string   `json:"base_book_1_parent_publisher"`
    BaseBookParentFirstEdition1 string   `json:"base_book_1_parent_1st_edition"`
    BaseBook2                   string   `json:"base_book_2"`
    BaseBookPublisher2          string   `json:"base_book_2_publisher"`
    BaseBookFirstEdition2       string   `json:"base_book_2_1st_edition"`
    BaseBookEditionInput2       string   `json:"base_book_2_edition_input"`
    BaseBookEditionProofing2    string   `json:"base_book_2_edition_proofing"`
    BaseBookParent2             string   `json:"base_book_2_parent"`
    BaseBookParentPublisher2    string   `json:"base_book_2_parent_publisher"`
    BaseBookParentFirstEdition2 string   `json:"base_book_2_parent_1st_edition"`
    Input                       string   `json:"input"`
    Proofing                    string   `json:"proofing"`
    TextURL                     string   `json:"text_url"`
    TextLastModified            Date     `json:"text_last_modified"`
    TextEncoding                string   `json:"text_encoding"`
    TextCharset                 string   `json:"text_charset"`
    TextUpdated                 int      `json:"text_updated"`
    HTMLURL                     string   `json:"html_url"`
    HTMLLastModified            Date     `json:"html_last_modified"`
    HTMLEncoding                string   `json:"html_encoding"`
    HTMLCharset                 string   `json:"html_charset"`
    HTMLUpdated                 int      `json:"html_updated"`
    Translators                 []Author `json:"translators"`
    Authors                     []Author `json:"authors"`
}

作家情報の取得

今度は作家名「富田倫生」を検索キーとして青空文庫 API から作家情報を取得してみる。

func main() {
    b, err := aozora.DefaultClient().SearchPersonsRaw(
        aozora.WithPersonName("富田倫生"),
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(b))
}

実行結果は以下の通り。

$ go run sample.go | jq .
[
  {
    "person_id": 55,
    "last_name": "富田",
    "first_name": "倫生",
    "last_name_yomi": "とみた",
    "first_name_yomi": "みちお",
    "last_name_sort": "とみた",
    "first_name_sort": "みちお",
    "last_name_roman": "Tomita",
    "first_name_roman": "Michio",
    "date_of_birth": "1952-04-20",
    "date_of_death": "2013-08-16",
    "author_copyright": true
  }
]

作家 No. が分かっている場合は aozora.Client.LookupPersonRaw() 関数で作品情報を取得できる。

func main() {
    b, err := aozora.DefaultClient().LookupPersonRaw(55)
    if err != nil {
        fmt.Println(err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(b))
}

aozora.Client.SearchPersons() または aozora.Client.LookupPerson() 関数を使うと結果を aozora.Person 構造体で返す。

person, err := aozora.DefaultClient().LookupPerson(55)

aozora.Person 構造体の構成は以下の通り。

//Person is entity class of person info.
type Person struct {
    PersonID        int    `json:"person_id"`
    LastName        string `json:"last_name"`
    FirstName       string `json:"first_name"`
    LastNameYomi    string `json:"last_name_yomi"`
    FirstNameYomi   string `json:"first_name_yomi"`
    LastNameSort    string `json:"last_name_sort"`
    FirstNameSort   string `json:"first_name_sort"`
    LastNameRoman   string `json:"last_name_roman"`
    FirstNameRoman  string `json:"first_name_roman"`
    DateOfBirth     Date   `json:"date_of_birth"`
    DateOfDeath     Date   `json:"date_of_death"`
    AuthorCopyright bool   `json:"author_copyright"`
}

工作員情報の取得

更に更に工作員名「雪森」を検索キーとして青空文庫 API から工作員情報を取得してみる。

func main() {
    b, err := aozora.DefaultClient().SearchWorkersRaw(
        aozora.WithWorkerName("é›ªæ£®"),
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(b))
}

実行結果は以下の通り。

$ go run sample.go | jq .
[
  {
    "id": 845,
    "name": "雪森"
  }
]

工作員 No. が分かっている場合は aozora.Client.LookupWorkerRaw() 関数で作品情報を取得できる。

func main() {
    b, err := aozora.DefaultClient().LookupWorkerRaw(845)
    if err != nil {
        fmt.Println(err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(b))
}

aozora.Client.SearchWorkers() または aozora.Client.LookupWorker() 関数を使うと結果を aozora.Worker 構造体で返す。

worker, err := aozora.DefaultClient().LookupWorker(845)

aozora.Worker 構造体の構成は以下の通り。

//Worker is entity class of worker info.
type Worker struct {
    WorkerID int    `json:"id"`
    Name     string `json:"name"`
}

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

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

青空文庫 API サーバを指定する

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

server := aozora.New(
    aozora.WithScheme("http"),
    aozora.WithServerName("pubserver2.herokuapp.com"),
)

これで青空文庫 API サーバとして http://pubserver2.herokuapp.com を指定できた。

http.Client を指定する

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

client := aozora.New(
    aozora.WithScheme("http"),
    aozora.WithServerName("pubserver2.herokuapp.com"),
).CreateClient(aozora.WithHttpClient(&http.Client{}))

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

client := aozora.New(
    aozora.WithScheme("http"),
    aozora.WithServerName("www.aozorahack.net"),
).CreateClient(aozora.WithHttpClient(&http.Client{}))

context.Context 付きのアクセス

青空文庫 API アクセスの際に context.Context を付けることができる。

作品情報の取得

rawjson, err := aozora.DefaultClient().SearchBooksRawContext(
    context.Background(),
    aozora.WithBookTitle("/天に積む宝/"),
    aozora.WithBookAuthor("富田倫生"),
)

books, err := aozora.DefaultClient().SearchBooksContext(
    context.Background(),
    aozora.WithBookTitle("/天に積む宝/"),
    aozora.WithBookAuthor("富田倫生"),
)

rawjson, err := aozora.DefaultClient().LookupBookRawContext(context.Background(), 59489)

book, err := aozora.DefaultClient().LookupBookContext(context.Background(), 59489)

作家情報の取得

rawjson, err := aozora.DefaultClient().SearchPersonsRawContext(
    context.Background(),
    aozora.WithPersonName("富田倫生"),
)

persons, err := aozora.DefaultClient().SearchPersonsContext(
    context.Background(),
    aozora.WithPersonName("富田倫生"),
)

rawjson, err := aozora.DefaultClient().LookupPersonRawContext(context.Background(), 55)

person, err := aozora.DefaultClient().LookupPersonContext(context.Background(), 55)

工作員情報の取得

rawjson, err := aozora.DefaultClient().SearchWorkersRawContext(
    context.Background(),
    aozora.WithWorkerName("é›ªæ£®"),
)

workers, err := aozora.DefaultClient().SearchWorkersContext(
    context.Background(),
    aozora.WithWorkerName("é›ªæ£®"),
)

rawjson, err := aozora.DefaultClient().LookupWorkerRawContext(context.Background(), 845)

worker, err := aozora.DefaultClient().LookupWorkerContext(context.Background(), 845)

ブックマーク

#aozorahack に関する覚え書き

参考図書

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

インターネット図書館青空文庫: 野口英司 (著); はる書房 2005-11-01; 単行本; 4899840721 (ASIN), 9784899840725 (EAN), 4899840721 (ISBN); 評価

青空文庫の活動について紹介。作品を収録した DVD も付いてる！巻末に載っている富田倫生さんの文章は青空文庫に収録されている。

reviewed by Spiegel on 2019-01-02 (powered by PA-APIv5)

本の未来 (Ascii books): 富田倫生 (著); アスキー 1997-02-01; 単行本; 4756117074 (ASIN), 9784756117076 (EAN), 4756117074 (ISBN); 評価

e-book の未来を予見する試みの書。あるいは本とコンピュータの関係について。青空文庫にも収録されている。

reviewed by Spiegel on 2019-01-02 (powered by PA-APIv5)

fields オプションは効いてない感じ？ ↩︎

書籍データ取得ツール 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)

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

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

ブックマーク

#aozorahack に関する覚え書き

2019-08-07T14:22:53+00:00

自作の books-data に青空文庫の書籍情報を取得する機能を組み込もうと思っているのだが，その前に #aozorahack について情報をまとめておく。

なお，この記事は覚え書きとして随時更新する予定である。

青空文庫と #aozorahack

#aozorahack は2015年の「Code for 青空文庫」の成果とも言える活動で，青空文庫そのものではないが協働関係にある。基本的にボランティア活動だが「本の未来基金」による支援を受けているらしい。 2016年からは「本の未来基金」が aozorahack.org ドメインを取得し #aozorahack に提供している。

「著作権切れのテキストを中心に、今や1万3000作品の自由な電子本を収蔵する日本最大級のインターネット電子図書館「青空文庫」。青空文庫の運営はボランティアによって受け継がれてきました。1997年のスタートから着実に蔵書数を増やしてきましたが、だんだんとそのシステムは古くなってきてしまいました。

そこで青空文庫を技術の力で支えようとスタートしたのが #aozorahack です。青空文庫とは協業関係にあり、本の未来基金の支援を受けています。当面の目標はサーバの安定運用とシステムの分散ですが、それ以外にも青空文庫が今後も続いていけるようなしくみをみなさんと一緒に考えて、動かしていければと考えています。」

aozorahackより

当面の活動としては，青空文庫活動の worlflow を変えることなくシステム周りの強化・運用を支援し，更に青空文庫周辺のツールやサービスを充実させていくことを目標としているようだ。

青空文庫 API

こうした活動の成果のひとつが「青空文庫 API」で，サーバ・サイドの aozorahack/pubserver2 とクライアント・サイドの aozorahack/aozora-cli で構成される。 aozorahack/aozora-cli は Python で組まれていて中のコードも素朴な作りなので理解は容易だろう。

「青空文庫 API」では作品（books）および作家（persons）に関する情報の検索および参照機能を提供する。 API は RESTful な構成になっているため他サービスからも利用しやすい。

API サーバ

aozorahack/aozora-cli の中身を見ると API を提供するサーバのドメインは www.aozorahack.net になっていた。この記事では www.aozorahack.net を青空文庫 API サーバとして解説していく。

作品情報の照会

以下の URI で青空文庫に収録されている全作品の情報が取れる。

$ http://www.aozorahack.net/api/v0.1/books

URI には以下のオプションを付加できる。

オプション名	機能	既定値
`title`	タイトル名で絞り込む	なし
`author`	著者名で絞り込む	なし
`fields`	出力するデータ項目を指定する¹	全項目
`limit`	出力するデータ数を指定する	100
`skip`	データ出力をスキップする	0
`after`	指定した日付（`YYYY-MM-DD`）以降のデータのみ出力する	なし

たとえば「天に積む宝」というワードを含むタイトルを探す場合には

$ curl http://www.aozorahack.net/api/v0.1/books?title=/%E5%A4%A9%E3%81%AB%E7%A9%8D%E3%82%80%E5%AE%9D/ | jq .
[
  {
    "book_id": 59489,
    "title": "「天に積む宝」のふやし方、へらし方",
    "title_yomi": "「てんにつむたから」のふやしかた、へらしかた",
    "title_sort": "てんにつむたからのふやしかたへらしかた",
    "subtitle": "著作権保護期間延長が青空文庫にもたらすもの",
    "subtitle_yomi": "ちょさくけんほごきかんえんちょうがあおぞらぶんこにもたらすもの",
    "original_title": "",
    "first_appearance": "",
    "ndc_code": "",
    "font_kana_type": "新字新仮名",
    "copyright": true,
    "release_date": "2019-01-01T00:00:00.000Z",
    "last_modified": "2018-12-24T00:00:00.000Z",
    "card_url": "https://www.aozora.gr.jp/cards/000055/card59489.html",
    "base_book_1": "インターネット図書館　青空文庫",
    "base_book_1_publisher": "はる書房",
    "base_book_1_1st_edition": "2005（平成17）年11月15日",
    "base_book_1_edition_input": "2005（平成17）年11月15日初版第1刷",
    "base_book_1_edition_proofing": "2005（平成17）年11月15日初版第1刷",
    "base_book_1_parent": "",
    "base_book_1_parent_publisher": "",
    "base_book_1_parent_1st_edition": "",
    "base_book_2": "",
    "base_book_2_publisher": "",
    "base_book_2_1st_edition": "",
    "base_book_2_edition_input": "",
    "base_book_2_edition_proofing": "",
    "base_book_2_parent": "",
    "base_book_2_parent_publisher": "",
    "base_book_2_parent_1st_edition": "",
    "input": "富田晶子",
    "proofing": "雪森",
    "text_url": "https://www.aozora.gr.jp/cards/000055/files/59489_txt_66663.zip",
    "text_last_modified": "2018-12-24T00:00:00.000Z",
    "text_encoding": "ShiftJIS",
    "text_charset": "JIS X 0208",
    "text_updated": 0,
    "html_url": "https://www.aozora.gr.jp/cards/000055/files/59489_66714.html",
    "html_last_modified": "2018-12-24T00:00:00.000Z",
    "html_encoding": "ShiftJIS",
    "html_charset": "JIS X 0208",
    "html_updated": 0,
    "authors": [
      {
        "person_id": 55,
        "last_name": "富田",
        "first_name": "倫生"
      }
    ]
  }
]

などとする。検索キーワードを /.../ で囲むことで正規表現に対応するようだ。

図書カードNo.（book_id）が分かっている場合は

$ curl http://www.aozorahack.net/api/v0.1/books/59489 | jq .
{
  "book_id": 59489,
  "title": "「天に積む宝」のふやし方、へらし方",
  "title_yomi": "「てんにつむたから」のふやしかた、へらしかた",
  "title_sort": "てんにつむたからのふやしかたへらしかた",
  "subtitle": "著作権保護期間延長が青空文庫にもたらすもの",
  "subtitle_yomi": "ちょさくけんほごきかんえんちょうがあおぞらぶんこにもたらすもの",
  "original_title": "",
  "first_appearance": "",
  "ndc_code": "",
  "font_kana_type": "新字新仮名",
  "copyright": true,
  "release_date": "2019-01-01T00:00:00.000Z",
  "last_modified": "2018-12-24T00:00:00.000Z",
  "card_url": "https://www.aozora.gr.jp/cards/000055/card59489.html",
  "base_book_1": "インターネット図書館　青空文庫",
  "base_book_1_publisher": "はる書房",
  "base_book_1_1st_edition": "2005（平成17）年11月15日",
  "base_book_1_edition_input": "2005（平成17）年11月15日初版第1刷",
  "base_book_1_edition_proofing": "2005（平成17）年11月15日初版第1刷",
  "base_book_1_parent": "",
  "base_book_1_parent_publisher": "",
  "base_book_1_parent_1st_edition": "",
  "base_book_2": "",
  "base_book_2_publisher": "",
  "base_book_2_1st_edition": "",
  "base_book_2_edition_input": "",
  "base_book_2_edition_proofing": "",
  "base_book_2_parent": "",
  "base_book_2_parent_publisher": "",
  "base_book_2_parent_1st_edition": "",
  "input": "富田晶子",
  "proofing": "雪森",
  "text_url": "https://www.aozora.gr.jp/cards/000055/files/59489_txt_66663.zip",
  "text_last_modified": "2018-12-24T00:00:00.000Z",
  "text_encoding": "ShiftJIS",
  "text_charset": "JIS X 0208",
  "text_updated": 0,
  "html_url": "https://www.aozora.gr.jp/cards/000055/files/59489_66714.html",
  "html_last_modified": "2018-12-24T00:00:00.000Z",
  "html_encoding": "ShiftJIS",
  "html_charset": "JIS X 0208",
  "html_updated": 0,
  "authors": [
    {
      "person_id": 55,
      "last_name": "富田",
      "first_name": "倫生"
    }
  ]
}

としてもよい。

作家情報の照会

以下の URI で青空文庫に収録されている全ての作家情報が取れる。

$ http://www.aozorahack.net/api/v0.1/persons

URI には以下のオプションを付加できる。

オプション名	機能	既定値
`name`	作家名で絞り込む	なし

たとえば「「天に積む宝」のふやし方、へらし方」を著した「富田倫生」さんの情報を探す場合には

$ curl http://www.aozorahack.net/api/v0.1/persons?name=%E5%AF%8C%E7%94%B0%E5%80%AB%E7%94%9F | jq .
[
  {
    "person_id": 55,
    "last_name": "富田",
    "first_name": "倫生",
    "last_name_yomi": "とみた",
    "first_name_yomi": "みちお",
    "last_name_sort": "とみた",
    "first_name_sort": "みちお",
    "last_name_roman": "Tomita",
    "first_name_roman": "Michio",
    "date_of_birth": "1952-04-20",
    "date_of_death": "2013-08-16",
    "author_copyright": true
  }
]

などとする。

作家No.（person_id）が分かっている場合は

$ curl http://www.aozorahack.net/api/v0.1/persons/55 | jq .
{
  "person_id": 55,
  "last_name": "富田",
  "first_name": "倫生",
  "last_name_yomi": "とみた",
  "first_name_yomi": "みちお",
  "last_name_sort": "とみた",
  "first_name_sort": "みちお",
  "last_name_roman": "Tomita",
  "first_name_roman": "Michio",
  "date_of_birth": "1952-04-20",
  "date_of_death": "2013-08-16",
  "author_copyright": true
}

としてもよい。

ブックマーク

参考図書

インターネット図書館青空文庫: 野口英司 (著); はる書房 2005-11-01; 単行本; 4899840721 (ASIN), 9784899840725 (EAN), 4899840721 (ISBN); 評価

青空文庫の活動について紹介。作品を収録した DVD も付いてる！巻末に載っている富田倫生さんの文章は青空文庫に収録されている。

reviewed by Spiegel on 2019-01-02 (powered by PA-APIv5)

本の未来 (Ascii books): 富田倫生 (著); アスキー 1997-02-01; 単行本; 4756117074 (ASIN), 9784756117076 (EAN), 4756117074 (ISBN); 評価

e-book の未来を予見する試みの書。あるいは本とコンピュータの関係について。青空文庫にも収録されている。

reviewed by Spiegel on 2019-01-02 (powered by PA-APIv5)

fields オプションは効いてない感じ？ ↩︎