本パッケージは
- コマンドラインクライアント(htnblog.exe, htnblog)
→ シェル、コマンドプロンプトなどから利用。vim など任意のテキストエディターで記事を編集して、投稿 - クライアントライブラリ(github.com/hymkor/go-htnblog)
→ Go言語で投稿機能を利用できるライブラリ
からなります。Windows, Linux (Ubuntu on WSL) で動作を確認しています
Releases よりダウンロードして、環境変数 PATH で指定されたディレクトリに実行ファイル htnblog.exe を展開してください
go install github.com/hymkor/go-htnblog/cmd/htnblog@latest
scoop install https://raw.githubusercontent.com/hymkor/go-htnblog/master/htnblog.json
もしくは
scoop bucket add hymkor https://github.com/hymkor/scoop-bucket
scoop install htnblog
htnblog init
を実行してください。
$ htnblog init
Hatena-id ? (← Hatena-IDを入力)
API-KEY ? (← APIキー入力)
End Point URL 1 ? (← 一つ目のブログのEndPointURL を入力)
End Point URL 2 ? (← 二つ目のブログのEndPointURL を入力:Enterのみで省略可)
End Point URL 3 ? (← 三つめのブログのEndPointURL を入力:Enterのみで省略可)
End Point URL (default) ? (← デフォルトのブログの EndPointURL: 既定値は1と同じ)
Text Editor Path ? (← テキストエディタのパス: 既定値は%EDITOR%)
Saved configuration to C:\Users\hymkor\.htnblog
設定は ~/.htnblog というファイルに次のように保存されます。
{
"userid":"(YOUR_HATENA_ID)",
"endpointurl":"(END_POINT_URL)",
"apikey":"(YOUR API KEY)",
"editor":"(YOUR EDITOR FULLPATH))"
"endpointurl1":"(END_POINT_URL at option `-1`)",
"endpointurl2":"(END_POINT_URL at option `-2`)",
"endpointurl3":"(END_POINT_URL at option `-3`)",
}
- endpointurl は 「はてな」の「ダッシュボード」 → (ブログ名) → 「設定」 → 詳細設定 → 「AtomPub」セクションのルートネンドポイントの記載の URL になります。
- apikey は「アカウント設定」→「APIキー」に記載されています。
- editor は編集に使うテキストエディターのパスを記載してください。
- endpointurl[123] は endpointurl と同じですが、オプション -1,-2,-3 が指定された時にこちらが使われます。
htnblog
(オプションなし) … ヘルプhtnblog init
… 設定の編集htnblog list
… 直近10件の記事のリストhtnblog new
… 新規記事のドラフトを作成htnblog edit {URL|@0|@1|…}
… 既存記事の編集。記事を指定しない場合は @0 = 最も最近に編集したページを対象とするhtnblog publish {URL|@0|@1|…}
… 指定した記事を下書き状態から公開状態へ変更するhtnblog browse {URL|@0|@1|…}
… 指定した記事の編集ページをウェブブラウザで開く
htnblog v0.8.0-11-g70fa80c-windows-amd64 by go1.21.5
Usage: htnblog {options...} {init|list|new|type|edit}
htnblog init ... edit configuration
htnblog list ... show recent articles
htnblog new ... create a new draft
htnblog type {URL|@0|@1|..} ... output the article to STDOUT
htnblog edit {URL|@0|@1|..} ... edit the article
htnblog delete {URL|@0|@1|..} ... output the article to STDOUT and delete it
htnblog publish {URL|@0|@1|..} ... set false the draft flag of the article
htnblog browse {URL|@0|@1|..} ... open the edit page in a web browser
The lines in the draft up to "---" are the header lines,
and the rest is the article body.
-1 Use the value of "endpointurl1" in the JSON setting
-2 Use the value of "endpointurl2" in the JSON setting
-3 Use the value of "endpointurl3" in the JSON setting
-debug
Enable Debug Output
-f Delete without prompt
-n int
fetch articles (default 10)
-rc string
use the specified file instead of ~/.htnblog
設定は標準入力から読み込むようにしてます。ブログに投稿するためのアカウント情報を保持する htnblog.Blog型のインスタンスは htnblog.NewFromJSON
関数で JSON テキストから生成していますが、別に &Blog{...}
でいきなり生成しても構いません。
package main
import (
"fmt"
"io"
"os"
"github.com/hymkor/go-htnblog"
)
func list() error {
auth, err := io.ReadAll(os.Stdin)
if err != nil {
return err
}
blog, err := htnblog.NewFromJSON(auth)
if err != nil {
return err
}
entries, err := blog.List()
if err != nil {
return err
}
for _, entry1 := range entries {
fmt.Println(entry1.Title)
fmt.Println(entry1.EditUrl())
}
return nil
}
func main() {
if err := list(); err != nil {
fmt.Fprintln(os.Stderr, err.Error())
os.Exit(1)
}
}
(*Blog) Post
関数は戻り値としてウェブアクセスの返信を *http.Response
と error
で返してきます。エラーでない場合は *https.Response
の Body という io.Reader を全部読みとって、Close しなければいけないのですが、それらはエラーの判断も含めて (*Blog).DropResponse
というメソッドに委ねています。同メソッドでは通常は読み取ったデータを io.Discard に捨てていますが、DebugPrint という io.Writer のフィールドが nil でない場合はそちらへコピーします
( つまり例では標準エラー出力にサーバーのレスポンスを表示させています )
$ go run examples/post.go < ~/.htnblog
package main
import (
"fmt"
"io"
"os"
"time"
"github.com/hymkor/go-htnblog"
)
func post() error {
auth, err := io.ReadAll(os.Stdin)
if err != nil {
return err
}
blog, err := htnblog.NewFromJSON(auth)
if err != nil {
return err
}
blog.DebugPrint = os.Stderr
return blog.DropResponse(blog.Post(time.Now().Format("投稿 2006-01-02 15:04:05"), "本文を書く", "yes"))
}
func main() {
if err := post(); err != nil {
fmt.Fprintln(os.Stderr, err.Error())
os.Exit(1)
}
}
$ go run examples/edit.go < ~/.htnblog
package main
import (
"errors"
"fmt"
"io"
"os"
"time"
"github.com/hymkor/go-htnblog"
)
func edit() error {
auth, err := io.ReadAll(os.Stdin)
if err != nil {
return err
}
blog, err := htnblog.NewFromJSON(auth)
if err != nil {
return err
}
entries, err := blog.List()
if err != nil {
fmt.Fprintln(os.Stderr, err.Error())
os.Exit(1)
}
if len(entries) <= 0 {
return errors.New("no entries")
}
entries[0].Content.Body += time.Now().Format("\n編集 2006-01-02 15:04:05")
blog.DebugPrint = os.Stderr
return blog.DropResponse(blog.Update(entries[0]))
}
func main() {
if err := edit(); err != nil {
fmt.Fprintln(os.Stderr, err.Error())
os.Exit(1)
}
}