21 | 22 |
23 | 24 |
25 | 26 |

27 |  Gitのような複雑なシステムは使い方が難しい。 28 | ある程度使い方を知っている場合でも、あまり一般的でない機能を使うのは難しい。 29 | たとえば以下のような場合はどういうコマンドを使えばいいだろうか? 30 |

31 | 32 |
    33 |
  • ひとつ前のバージョンのREADME.mdからの変更を見たい
  • 34 |
  • README.mdは3日前からどう変わった?
  • 35 |
  • package.jsoncoffeeという名前が入ったのはいつ?
  • 36 |
  • ここ1週間ぐらい変更されてないファイルは?
  • 37 |
  • 最近大量に修正したファイルはどれだっけ?
  • 38 |
39 | 40 |
41 | 42 |

43 |  最初の例について考えてみる。 44 | 45 | Gitでは「HEAD^」「HEAD^^」のような表現で昔のコミットを参照できるので 46 | 47 |

48 | $ git diff HEAD^ README.md 49 |
50 | 51 | のようにすればひとつ前のコミットのREADME.mdとの比較ができるが、 52 | 最近のコミットでREADME.mdを編集していなかった場合は 53 | このコマンドを起動しても何も出力されない。 54 | 55 |
56 | $ git log README.md 57 |
58 | 59 | とすればREDME.mdの編集履歴を調べられるので、 60 | ひとつ前のバージョンのコミットIDを使えば 61 | 62 |
63 | $ git diff (ひとつ前のバージョンのコミットID) README.md 64 |
65 | 66 | のようにして 67 | ひとつ前のバージョンのREADME.mdからの変更を見ることができる。 68 |

69 | 70 |
71 | 72 |

73 |  しかしこれはなかなか面倒な話である。 74 | 75 | 手動でコミットIDを手打ちかコピペしなければならない 76 | 77 | し、当然ながら 78 | 79 | git loggit diffといったコマンドの存在と動作を知っていなければならない。 80 | 81 | git loggit diffはよく使うコマンドなので 82 | Gitユーザなら誰でも知っているだろうが、 83 | このような簡単な仕事でもコピペのような面倒な操作が必要なのは嫌である。 84 | 85 |
86 |  実はGitにはrev-listというコマンドがあり、 87 | 編集があったコミットのIDをリストすることができる。 88 | これを利用すると、ひとつ前の編集のコミットIDは 89 | 90 |

91 | $ git rev-list HEAD -- README.md | head -2 | tail -1 92 |
93 | 94 | で取得できる。 95 | この結果を利用すると、 96 | 「ひとつ前のバージョンのREADME.mdからの変更を見たい」 97 | という要求は 98 | 99 |
100 | git diff $(git rev-list HEAD -- README.md | head -2 | tail -1) -- README.md 101 |
102 | 103 | のようなコマンドで実行できることになる。 104 | ($(...)というのはbashの記法で、コマンド実行結果を文字列として扱うものである。 105 | --というのは、その後に続く文字列がオプションではなくてファイル名等だということを示すもの。) 106 |

107 |

108 |  rev-list-nオプションを利用すると 109 | 110 |

111 | git diff $(git rev-list -n 1 HEAD -- README.md)^ -- README.md 112 |
113 | 114 | のように書くこともできる。 115 |

116 | 117 |
118 | 119 |

120 |  それにしても、このように 121 | 無駄知識が大量に必要 122 | だったり 123 | 単純な要求の実行が大変 124 | だったりするのは嫌すぎる。 125 | 126 | 上のような工夫によって、 127 | ひとつ前のバージョンのREADME.mdからの変更は調べられるようになったわけだが、 128 | こういった要求は無限にあるわけで、 129 | そのたびにいろんなGit機能を調べたり思い出したりしなければならないのだろうか。 130 | 131 | 「README.mdは最後にどこ変えたっけ?」 132 | のような自然な質問を簡単に 133 | Gitコマンドに翻訳する方法が欲しい。 134 | 135 |
136 |  こういった要望に対して最近は人工知能的に解決しようとするアプローチが人気かもしれない。 137 | しかしそのためには高度な自然言語処理が必要で、 138 | ちょっと違った表現を許したり内容を変えたりすることは簡単ではない。 139 | 大阪弁で質問できる日が来るとは思えない。 140 | 141 | また、「longfilename」のようなものを指定しようとして 142 | 「logfile」のように間違って入力しても動くようにするには 143 | 単純な予測/補完/誤り修正機能などを使った方が良いだろう。 144 | 145 |
146 |  逆引き辞典などでは 147 | 「ひとつ前のバージョンのファイルとの違いを知る」 148 | のようなエントリはあるかもしれないが、 149 | それを調べた後で「README.md」のような名前を指定してコマンドを起動する必要がある。 150 | こういった二度手間も減らしたいものである。 151 |

152 |

153 |  Macのヘルプで「時間 セット」と入力しても時間をセットする方法は出てこないし、ヘルプを自分で追加することはできない。 154 |
155 | 156 |
157 | 時間をセットする方法がヘルプに書いてあったとしても、 158 | 時間を4時にセットするためには自分で「4時」という値を指定してから「時間のセット」機能を実行しなければならない。 159 |

160 | 161 |

162 |  マニュアルやヘルプを書くのは面倒なものである。 163 | システムのドキュメントやマニュアルやヘルプシステムを独立に開発するのは 164 | 面倒すぎるし齟齬も起きやすいだろう。 165 | ユーザをサポートするシステムがひとつにまとまっていて、 166 | 誰でも情報を足したり修正したりできたら嬉しいだろう。 167 |

168 | 169 |

GitHelpのアプローチ

170 | 171 |

172 |  GitHelpは、以下のような方針で上のような課題をすべて解決しようというものである。 173 | 174 |

    175 |
  • ユーザのあらゆる曖昧な表現にマッチするようにヘルプ文字列を正規表現で表現し、 176 | Gitコマンドに変換する
  • 177 | - ExpandHelp(ソース / 178 | 論文)を利用 179 |
  • データをすべてクラウド上に置いて編集可能にすることにより、 180 | 誰でもデータを追加/修正できるようにする
  • 181 | - Scrapboxを利用 182 |
  • ユーザが指定したパラメタはそのまま利用して実行に使う
  • 183 | - ユーザが「4」「時間」などと指定すると「時刻を4時にセットする」のようなものを提案して実行可能にする 184 |
  • 多少の誤入力を許す
  • 185 |
186 | 187 | この結果、やりたいことの一部を漠然と言えばすぐ実行できるようになるのが理想である。 188 |

189 | 190 |

利用例

191 | 192 | Gitに関連するタスクのキーワードやパラメタを指定して 193 | githelpを起動すると 194 | 候補のリストが表示され、 195 | カーソルで選択すると実行される。 196 | 197 |
    198 |
  • $ githelp 2 READMEのように引数を指定して起動すると以下のような候補リストが提示される
  • 199 | 200 | 201 | 202 |

    203 |
  • カーソルで選択してリターンを押すと実行される
  • 204 | 205 | 206 |
207 | 208 |

インストール

209 | 210 |
211 | 	% gem install githelp   
212 | 213 |
    214 |
  • 対話的処理のためにpecoが必要
  • 215 |
      216 |
    • Macだと% brew install pecoでインストール可能
    • 217 |
    • Linuxなどの場合こちらのファイルからインストール (yumなどでは入らない)
    • 218 |
    219 |
220 | 221 |

実装

222 | 223 |
    224 |
  • re_expand 225 | という正規表現展開ライブラリを利用
  • 226 |
  • Scrapboxにあらゆる情報を書いておく
  • 227 |
    228 | 229 |
  • 230 | 様々なタスクの説明と実際の操作を組にして記述しておき、 231 | ユーザが与えたキーワードやパラメタにマッチするものを 232 | リストして実行可能にする
  • 233 |
  • 行頭に$がある行でタスクの説明を記述し、行頭に%がある行で実行コマンドを示す
  • 234 | 235 |
  • ファイル名にマッチする引数(e.g. READM)や 236 | 数字にマッチする引数(e.g. 2)が指定されると 237 | $の行に記述された#{filename}#{number}に 238 | マッチする
  • 239 |
  • マッチしたときは、マッチした文字列が$1などで参照/展開されてGitコマンド文字列になる 240 |
  • ワンライナーでは難しい場合は exe 241 | の下にヘルパーコマンドを用意して利用する (e.g. githelp-changed) )
  • 242 |
243 | 244 | 245 |

考察

246 | 247 |
    248 |
  • 生活の中ではこういった言い換えをいつも行なっているかもしれない。 249 | たとえば「部屋暗くして」と頼まれたら 250 | 部屋の入口にある電灯スイッチを操作するかもしれないが、 251 | この場合は頭の中で 252 | 「部屋を暗くする」⇒「電灯を消す」⇒「電灯のスイッチを切る」 253 | という翻訳が行なわれていることになる。 254 | こういうことは生活で非常に多いので 255 | 翻訳作業があまり気にならないものなのかもしれないが、 256 | そういう「翻訳」は少ない方が良いのは確かだろう。 257 |
  • 258 |
  • そういえば先日「らくらくホン」画面に出てくる鬱陶しい「羊」を消す方法が全くわからなかったのだが、 259 | あれは「マチキャラ」と呼ばれるものなので 260 | 「マチキャラ」を消すという操作が必要だった。 261 | お前はMSのイルカか。 262 | 「羊 消す」とか「消す」とかで消せるべきだろう。 263 | githelpでは $ githelp 削除 と入力すれば削除関連で何ができるのかわかるだろうし、 264 | (鬱陶しい|不快な)羊を(消す|殺す) 265 | のようなエントリをユーザが足すこともできるだろう。 266 |
  • 267 | 268 |
  • というわけでGitは単なる適用例であり、広い範囲で使いたいと思っている。
  • 269 |
270 | 271 |

注意

272 | 273 |
    274 |
  • githelpコマンドはGitリポジトリのディレクトリで実行する必要がある
  • 275 |
  • re_expandの実装が富豪的なので 276 | 大きなリポジトリだと不具合があるかも
  • 277 |
  • データが全然足りない... 特にリモートリポジトリ関連のデータは皆無だが、 278 | ローカルだけでも充分複雑なのでとりあえずローカル処理の情報を充実させたい
  • 279 |
  • 旧版はこちら 280 |
281 | 282 |

関連システム

283 | 284 |
    285 |
  • AnyCode
  • 286 |
      287 |
    • 自然言語キーワードからJavaスニペットを検索する
    • 288 |
    • copy fileA fileB みたいなキーワードから FileUtil.copyFile(new File(fileA), new File(fileB)) みたいなコード候補を生成する
    • 289 |
    290 | 291 |
  • 文芸的プログラミング
  • 292 |
293 | 294 |