インラインTODO管理のWatsonを使う

最近、Githubのトレンドにも入っていたWatsonを紹介します。

インラインTODO管理とは何か

もしあなたがエンジニアなら、次のようなコメントを見たことがあると思います。

class ApplicationController < ActionController::Base
  def logged_in?
    # TODO 管理ユーザーと処理を分ける
    ...
  end
end

このように、コード内には至る所にコメントが書かれています。単なるコードの説明に限らず、修正が必要な内容を記述したものも多くあります。

しかしながら、しばしばこういったコメントは放置され、コードの中に埋もれたままになってしまうこともあります。

Watsonは、コード内に書かれたコメントを走査し、近代的な管理ツールに流し込むことでIssueを管理するツールです。

watsonを使って、コード内に記述されたコメントを洗い出して、GithubのIssueに登録してみましょう。

$ gem install watson

$ cd path/to/project_dir
$ watson
# 一旦<Ctrl-C>で終了してください。

.watsonrcが自動的に作成されるので、プロジェクトに合わせて走査するディレクトリなどを設定します。

例として、Railsプロジェクト用の.watsonrcを貼付けておきます。

watsonを使うときは、独自のタグを使ってコメントを書いておきます。

試しに、適当なファイルを開いて、上記のようなフォーマットでコメントを記入してみてください。

後は、再度watsonと打って実行！

めでたしめでたし。プロジェクト内のTODOなどが、一覧で出力されます。

先ほどの出力した内容を、Githubへ一括同期しましょう。

まず、Githubのリポジトリをwatsonに認識させます

$ watson --remote github

英語のコメントに沿って、情報を入力していきましょう。

続いて、Issueを登録します。

$ watson --update

処理が終わると、Githubのissueへの登録が完了です。

watsonは先月ぐらいに注目され始めた新しいプロジェクトです。

今後は、コメントを活用して様々な処理を行えるように拡張されると思うので、動向が楽しみですね。