Perl で add・list・complete の3つのサブコマンドを持つ Todo CLI を、if-elsif で書いた約50行のスクリプトから始めて、1回に1つずつ作り直していく全10回の連載です。Moo の Task クラス、JSON での保存、Repository パターン、ファイルを使わないテスト、Command パターン、Getopt::Long と手を入れ、第9回で全体を振り返ります。第10回は、保存先を SQLite に差し替える演習です。
各回は前の回のコードに手を入れていく作りなので、通して読むなら第1回からが早道です。このページは目次を兼ねた案内板です。入口は「どこから読むか」で、困りごとが決まっているなら「困りごとから探す」で、順に追うなら「全話一覧」で選んでください。
対象は、Moo の has と Moo::Role を一度書いたことがある方です。Moo が初めてなら、先に前シリーズ「Mooで覚えるオブジェクト指向プログラミング」の目次(このページの最後にリンクがあります)から読んでください。
どこから読むか
- 第1回 — if-elsif で書いたスクリプトが長くなってきた自覚があるなら。何が辛いのかを確かめてから、第2回・第3回でクラスと JSON に置き換える
- 第4回 — 保存の処理がメイン処理に混ざっているなら。Repository で分け、第5回でファイルを使わないテストまで書く
- 第6回 — コマンドを足すたびに分岐が伸びているなら。Command で操作をクラスにし、第7回で1つ足して確かめる
- 第9回 — 設計の全体像から入りたいなら。第1回と完成形を見比べ、使ったパターンと設計原則を先に見られる
困りごとから探す
コマンドを足すたびに、if-elsif が伸びていく
- 第1回 — add・list・complete を if-elsif で振り分けている
- 第6回 — メイン処理の分岐が、コマンドの数だけ長くなる
- 第7回 — 新しいコマンドのために、動いているコマンドまで触っている
データの持ち方・保存の形式に無理がある
保存の処理が、あちこちに混ざっている
テストを書こうとすると、ファイルが邪魔をする
- 第5回 — テストのたびにファイルができ、失敗すると残る
コマンドライン引数の扱いが窮屈
- 第8回 —
--verboseや--fileのようなオプションを足したい
手を入れた結果を、説明できない
- 第9回 — コードは増えたのに、なぜ直しやすくなったのかを言葉にしたい
全話一覧
- 第1回 if-elsifで書いた約50行のTodo CLIは動く。でもテストが書けない理由を確かめる【素朴な実装】
- 第2回 タスクがただの文字列で、完了の印を付ける場所がない。データと操作を1つのクラスにまとめる【Taskクラス】
- 第3回 タスク名にタブが入ると、保存ファイルが読めなくなる。構造ごと書き出す【JSON】
- 第4回 どのコマンドにもファイルの読み書きが混ざり、保存形式を変えると全部直すことになる。保存の仕事を1か所に分ける【Repository】
- 第5回 テストのたびにファイルが作られ、失敗すると残る。メモリ上で動く保存先に差し替える【InMemoryRepository】
- 第6回 コマンドを足すたびに、メイン処理のif-elsifが伸びていく。操作を1つずつオブジェクトにする【Command】
- 第7回 addとlistをCommandにした。completeも、動いている2つに触らず足せるかを確かめる【Command::Complete】
- 第8回 –verboseや–fileを足したいのに、shift @ARGVでは引数の順番に縛られる。オプション解析を任せる【Getopt::Long】
- 第9回 約50行のif-elsifが、約300行と8つのクラス・ロールに増えた。それでも直しやすくなった理由を振り返る【設計原則】
- 第10回 JSONで保存していたTodo CLIを、SQLiteでも動かす。変えるのはリポジトリを選ぶ所だけ【演習:SQLite】
