HN 日本語サマリー

← 一覧へ戻る
プログラミング

Malleable Computing、Emacs、そしてあなた

Malleable Computing, Emacs, and You (yummymelon.com)

126 pointsby kickingvegas36 コメント

要約

この記事は、GitHubのイシューをEmacsのOrg Agendaに手動でコピーする作業を自動化するプロセスについて解説しています。Emacs LispとGitHub CLIツール`gh`を活用し、このタスクを効率化する方法を示しています。また、Emacsの持つ「Malleable Computing」(柔軟なコンピューティング)の能力についても考察しています。

全文翻訳

Malleable Computing, Emacs, and You

すべては日常的なタスクから始まりました。私は公開プロジェクトのすべてにGitHubのIssueを使用していますが、私の好みはOrg Agendaで物事を管理することです。この2つを連携させるために、私はGitHubのIssueのタイトルと説明を、まるで動物のように、手動でOrgファイルにコピーしていました。

この分離にもかかわらず、複製されたIssueは、Orgで表現できるあらゆるもののためのスクラッチパッドとして扱うことを可能にしました。このように、私はOrgの複製されたIssueを、メモを取るための専用エリアと、公開されているIssueで共有したいフォローアップコメントを作成するための「ステージング」エリアの両方として使用しました。

私は、認めたくないほど長い間、手動でコピーしていました。Emacsでタスクを十分に繰り返すと、必然的に「これを自動化すべきだ」という考えが浮かびます。

この記事では、このタスクをどのように自動化したかを recount し、その過程でEmacsのMalleable Computing(柔軟なコンピューティング)の能力を強調します。また、私の以前の記事「In Emacs, Everything Looks Like a Service」のフォローアップとしても考慮されるべきです。

Requirements

どのような自動化の試みにおいても、不可欠な質問は「何をしたいのか?」です。

私は以下のことができるようになりたかったのです。

  • GitHubのIssue(タイトル、説明、いくつかのメタデータ)を、Agendaビューで追跡できるOrgタスクとして簡単にコピーできること。
  • EmacsとWebブラウザ間のコンテキストスイッチを最小限に抑えるため、主にEmacsから作業できること。
  • Orgの構文で自分の考えを表現できること。
  • 新しいGitHubのIssueを作成できること。
  • GitHubの認証を扱う必要がないこと。
  • Emacsから、GitHubのIssueをWebブラウザで開けること。

もう一つの不可欠な質問は「何をしたくないのか?」です。

  • フル機能のGitHubクライアントをインストールしたり書いたりすること。
    • ローカル(Emacs)とサーバー(GitHub)の状態間の同期ロジックについて、過度に心配すること。
  • これに多くの時間を費やすこと(理想的には1日で作業が完了し、最大でも1週間)。

Specification

上記の要件を踏まえて、次の質問は「これをどう構築するか?」です。

この特定の演習のために、私は既存のGitHubコマンドラインユーティリティ gh のインストールを活用することにしました。

  • GitHubの認証は gh に委任されるため、Emacsから直接扱う必要がありません。

  • Emacsは、以下の図に示すように、gh をGitHubへのRESTサービスとして扱うことができます。

    [画像: GitHub CLI gh をEmacsからサービスとして扱うアーキテクチャ図]

ツールの残りの部分を充実させるために、さまざまなElispパッケージとプログラムを活用できます。

  • ユーザーインターフェースには、メニューと表示にそれぞれ Transient および Variable Pitch Table (vtable) パッケージが使用されます。

  • OrgからMarkdownへの変換には、ox-gfm が使用されます。

  • MarkdownからOrgへの変換には、Pandoc が使用されます。

  • Elispネイティブの JSON サポートが、gh からのJSON応答をデシリアライズするために使用されます。

Implementation

上記の実際の実装は、パッケージ gah として公開されており、そのソースコードは gah.el ファイルで確認できます。特に注目すべきは、gh を介してGitHubのIssueを取得する gah-request-issues 関数です。

(defun gah-request-issues (repo)
  "Request issues for REPO."
  (let* ((fields gah-browser-fields)
         (cmd-list (list "gh"
                         "--repo"
                         (format "'%s'" repo)
                         "issue"
                         "list"
                         "--limit"
                         (number-to-string gah-request-issue-count)
                         "--json"
                         (string-join fields ","))))

    (json-parse-string (shell-command-to-string
                        (string-join cmd-list " "))
                       :null-object nil)))

gah-request-issues が提供する高い抽象化レベルを考慮してください。

  • cmd-list リストはリクエストを形成します(この場合、gh を呼び出す引数)。
  • shell-command-to-string はリクエストを gh にディスパッチします。
  • 返されたJSON応答は json-parse-string によって処理され、JSONをElispのハッシュテーブルにデシリアライズします。
  • 上記すべてが20行未満のコードで達成されます。

返されたハッシュテーブルの結果は、その後、以下の図に示すように vtable を populat するために処理されます。vtable から、ユーザーは選択されたIssueの詳細を表示する補助ウィンドウでIssueのリストをナビゲートできます。

[画像: vtableでIssueリストを表示している様子]

上記のハッシュテーブルを操作する複数のコマンドと関数が、上記の要件を満たすために作成されました。これらは、以下の図に示す Transient メニューからアクセスできます。

[画像: Transient メニューでgahのコマンドが表示されている様子]

Malleable Computing Observations

Elispは 動的プログラミング言語 であるため、上記の関数(またはそのバリアント)は、実行中のEmacsセッション内でコーディングおよび評価できます。Emacsでは、再起動することなくコードの動作をプロトタイプ化することが日常的な実践です。これを、静的言語で構築され、拡張性を持たないツールと比較してください。これらのツールでは、ソースコードが利用可能であれば、編集-コンパイル-デバッグ の開発サイクルを適用して動作を確認する必要があります。

Emacsは、Elispコードの編集と評価のための多数の方法を提供しています。その中には以下のようなものがあります。

  • スクラッチバッファ
  • Elispファイル
  • Orgソースブロック
  • IELM REPL
  • Eshell
  • eval-expression (M-:)

ロードされたElispコード間には分離がないため、すべてを即興的にオーケストレーションできます。シェル経由でEmacsからアクセス可能な任意のプログラムは、このミックスにさらに追加されます。

高い抽象化が提供されている場合、望ましい動作のために書く必要のあるコード量は少なくなる可能性があります。この記事の執筆時点では、gah.el は cloc によって約400行のコードであると測定されています。

github.com/AlDanial/cloc v 2.08  T=0.01 s (146.4 files/s, 76550.1 lines/s)
-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
Lisp                             1             93             38            392
-------------------------------------------------------------------------------

私が望む基本的な動作(GitHubからIssueを取得し、表示する)を構築するのに約2時間半かかり、残りの日は元の要件すべてをカバーするのに費やしました。それ以降はすべてリファクタリングでした。

意欲のある読者は、gah.el を調べてその詳細を理解することを歓迎します。しかし、この時点で、ソフトウェアエンジニアリングとMalleable Computingについて考察する機会を得たいと思います。

Software Scope - Some Percentage Anecdotes

90/90ルール は、「コードの最初の90パーセントが開発時間の最初の90パーセントを占め、残りの10パーセントのコードが開発時間の残りの90パーセントを占める」と提唱しています。ソフトウェア開発に(誤って)適用されるパレートの法則(別名80/20ルール)とも密接に関連しています。ユーザーの80パーセントは、機能の20パーセントしか実際には使用しません。

制御理論には、BIBO安定性(Bounded Input, Bounded Output stability)という概念があります。システムがBIBO安定であれば、どんなに制限された入力であっても、出力も制限されます。

これらの考え方を組み合わせると、望む機能(BIBO安定性)がその20パーセントの成果物に含まれている場合、より速く望ましい結果を得ることができます。

残念ながら、この観察は、大規模なオーディエンスを満足させる必要があるツールを出荷する多くのプロデューサーには利用できません。Sinofsky の記事「What is Software Bloat, Really?」では、Microsoft Officeの製品定義の問題、特に機能セットについて説明しています。彼らのユーザー調査から、彼らはこの発見に至りました。「...データは完全に決定的でした。Officeのほとんどは使用されていました。しかし、一人の人間が製品全体を使用することはありませんでした。」

製品定義について議論する際には、2つの非公式なダイナミクスを区別することが役立ちます。供給と需要です。

供給のみで提供されるソフトウェア(MS Officeの場合など)では、製品定義の重みはプロデューサーが負担します。プロデューサーが広範なオーディエンスにサービスを提供したい場合、その機能セットとそれに伴う開発スコープも広くなる可能性が高いです。需要側では、消費者は新機能のリクエストを行うことができますが、その優先順位はプロデューサーによって制御されます。この状況では、プロデューサーと消費者の役割は明確に区別されます。

Malleable software(ユーザーがデジタルツールを適応および再形成する権限を持つソフトウェア)は、異なる可能性を提供します。プロデューサーはビルディングブロックを提供し、消費者が独自のツールを作成できるようにします。これにより、既存のコードとプログラムが組み合わされて新しい動作が作成されます。言い換えれば、Malleable softwareは組み合わせ爆発を利用しており、望ましい機能のサブセットは、既存のライブラリ(この場合Elisp)とさまざまなプログラムを組み合わせた状態空間内で見つけられる可能性が高いです。Malleable softwareでは、プロデューサーと消費者の役割はあまり区別されません。Malleableなビルディングブロックから新しいツールを構築する消費者は、製品定義の重みを負担する必要があります。

Build for 1 or N

1人のために構築することとN人のために構築することのスコープは、桁違いになる可能性があり、さらにNは大きくなくてもよいという点があります。他の人のためにコードを書くこと(N=2)を選択すると、そうでなければ無視できる懸念事項が増大します。

  • エラーハンドリング
  • コードの保守性
    • モジュール性/再利用
  • ドキュメント
  • 単体テストおよび統合テスト
  • パッケージング
  • 配布

Malleableなテクニックの祝福と呪いの両方として、それらは「ちょうど十分な」能力を可能にします。「Malleableなテクニックは、1人のために構築することを奨励します。なぜなら、「自分にとってうまくいく」状態に到達することが、勝利を宣言するのに十分であることが多いためです。

ほとんどの供給のみで提供されるソフトウェアでは、N人のために構築することが要件です。Malleableなテクニックで構築されたほとんどのソフトウェアでは、N人のために構築することは選択です。

Malleable Software and User Agency

gah に戻ると、1人のために構築することの利点は明らかです。

Emacs内から、私は簡単に以下を行うことができます。

  • 指定されたリポジトリのGitHub Issueを閲覧する。
  • GitHub IssueをOrgファイルにコピーする。
  • Org構文を使用して新しいGitHub Issueを作成する。
  • GitHub IssueをWebブラウザで開く。

Emacsで gah を実装することは、Elispパッケージ(組み込みおよびサードパーティ)と外部アプリケーション(gh、pandoc)を活用して構築できたため、簡単でした。1日以内に、私が望むことを行うツールができました。許可を求める必要もなく、特権的な資料(ソースコード)を必要とすることもなく gah を構築できました。Emacsを使えば、ただ実行することができました。Malleableなテクニックによって推進されるこのような個人のエンパワーメントは、互いにほとんど、またはまったく統合されていないサイロ化されたアプリケーションで作業するのと対照的に、解放的です。

Closing Thoughts

この記事では、Emacsが提供するMalleable Computingの能力について考察し、具体的な例(gah.el)を通じて、コードとプログラムの再利用を即興的に活用して新しい動作を作成する方法を示しています。測定された期待値(要件、機能セット、オーディエンス)があれば、Malleableなテクニックは、それなしでは不可能だったであろうツールを構築することを可能にします。

Links

Addendum 2026-07-23 11:30 PST

しまった。これは個人的なプロジェクトとして始まったため、プロジェクト名について十分な調査を行いませんでした。どうやら fj という名前は、Forgejoのクライアント としてすでに使用されているようです。

そのため、プロジェクト名を gah に変更し、この記事をそれに応じて修正しました。ご迷惑をおかけした場合はお詫び申し上げます。

emacs   org mode