helm-github-stars.el という便利な Emacs Lisp ツールがあります。
「自分がつけた GitHub の Star」や「自分または Organization 所有の
リポジトリ」等を Helm interface で操作できます。
「Star 付けたリポジトリがあったけど、なんて名前だったかなー」
なんて時に、素早く検索してブラウザで開けたりします。便利です。
課題
helm-github-stars.el は便利なのですが、キャッシュファイル
（~/.emacs.d/hgs-cache）を作る hgs/generate-cache-file()
は
同期処理関数です。Emacs built-in の url-retrieve-synchronously()
を使っています。
うっかり M-x helm-github-stars すると、数十秒待たされます。辛いです。
※ helm-github-stars-refetch-time を設定に基づき、
M-x helm-github-stars のタイミングでキャッシュファイルが更新されます。
そういうわけで、最近は当該キーバインドをコメントアウトしている状態
でした。
つい先日の木曜日。重い腰を上げて、非同期処理版の
hgs/generate-cache-file() を作ろうとしました。でも、Star と Repo
両方の API を呼ぶ必要があり、なかなかに複雑です。コーディングが進
みません。
そんな中見つけたのが async.el でした。
async.el
今回使ったのは、async.el に含まれる async-start() です。
async-start START-FUNC FINISH-FUNC
- START-FUNC は子プロセスの Emacs で実行される
- FINISH-FUNC は現在の Emacs で実行される
上記のとおり、このライブラリはなんと Emacs の子プロセスとして、も
うひとつ Emacs を起動し、そこで非同期処理をして結果を返してくれま
す。変態です。
子プロセスの Emacs は -Q オプションで高速に起動され、START-FUNC の
終了とともに終了します。
ご存知の方も多いと思いますが、Emacs で非同期処理を実現するためには、
TCP コネクションを開くか、外部コマンドを起動しなくてはいけません。
ただ、外部コマンドの種類に制限はないので、Emacs に S 式を渡して処
理させたというわけです。天才か。
コード自体はそこまで凝ったことはしていません。子プロセスとして
Emacs を起動する
以外は start-process() を使った普通の非同期処理
です。
ですが、このようなシンタックスとして定義されていると、非同期処理を
感じさせません。Lisp 処理系の真骨頂ですね。
変更前
async.el で非同期化する前のコードです。
~/.emacs.d/hgs-cache を作ってから 0.5 日経った後に
M-x helm-github-stars すると、そのタイミングで同期処理が実行されます。
私の場合だと 20 秒ほど待たされます。
※ my-lisp-load() は [2016-05-06-2] で解説しています。
変更後
async.el で非同期化したコードです。
Emacs を起動すると、
my-helm-github-stars-async-generate-cache-file() が
Emacs Timer に登録されつつ、初回の実行をします。
このコードだと、この後 1 時間ごとに非同期（バックグラウンド）で実
行されます。
my-helm-github-stars-async-generate-cache-file() は async-start()
を呼ぶだけの関数です。
START-FUNC では、まず load-path を通すために、package 関連の処理を
します。
次に helm-github-stars-token を設定するために、my-lisp-load() の
S 式を評価してから、この Lambda 式を評価しています。
※ (lambda …) の前のバッククォートと (my-lisp-load …) の前のカ
ンマがセットです。
async-inject-variables()
を使っても良かったのですが、
helm-github-stars-token は現在の Emacs では nil で良いため、
この形に落ち着きました。
FINISH-FUNC は *Messages* バッファにこんなログを出すだけです。
[GH] Success to GET my GitHub Stars and Repos (28.2sec) at 2017-10-21 00:33:14.
まとめ
async.el を使って、helm-github-stars.el に変更を加えることなく、
非同期化しました。
-Q で起動しているとは言え、Emacs は大きなプロセスですので、インター
バルの短かすぎる処理は避けたほうが良いと思います。
今回の GitHub 関連の情報は、「自分のはてブ」や「自分の Qiita:Team
のストック」とともに helm-my-bookmark() という関数で横串検索してい
ます。詳しい設定は私の init.el
をどうぞ。
追記(2017-12-30):
Issue で紹介してみました（無謀奴）。
https://github.com/Sliim/helm-github-stars/issues/23