my_help 0.4.5 → 0.5.0

data/docs/nasu/nasu_abst/nasu_abst.log

@@ -0,0 +1,179 @@
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  16 FEB 2017 11:32
+entering extended mode
+ restricted \write18 enabled.
+ file:line:error style messages enabled.
+ %&-line parsing enabled.
+**nasu_abst.tex
+(./nasu_abst.tex
+pLaTeX2e <2016/11/29> (based on LaTeX2e <2017/01/01>)
+Babel <3.9r> and hyphenation patterns for 83 language(s) loaded.
+(/usr/local/texlive/2016/texmf-dist/tex/platex/jsclasses/jsarticle.cls
+Document Class: jsarticle 2017/01/13 okumura, texjporg
+\jsc@mpt=\dimen118
+\jsc@mmm=\dimen119
+\jsc@smallskipamount=\skip41
+LaTeX Info: Redefining \rmfamily on input line 468.
+LaTeX Info: Redefining \sffamily on input line 471.
+LaTeX Info: Redefining \ttfamily on input line 474.
+LaTeX Info: Redefining \textmc on input line 477.
+LaTeX Info: Redefining \textgt on input line 479.
+\symmincho=\mathgroup4
+LaTeX Font Info:    Overwriting symbol font `mincho' in version `bold'
+(Font)                  JY1/mc/m/n --> JY1/gt/m/n on input line 540.
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 9.60999pt on input line 731.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 9.60999pt on input line 731.
+\fullwidth=\dimen120
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 7.68799pt on input line 883.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 7.68799pt on input line 883.
+\c@part=\count82
+\c@section=\count83
+\c@subsection=\count84
+\c@subsubsection=\count85
+\c@paragraph=\count86
+\c@subparagraph=\count87
+\@abstractbox=\box41
+\c@figure=\count88
+\c@table=\count89
+\abovecaptionskip=\skip42
+\belowcaptionskip=\skip43
+\jsc@tocl@width=\dimen121
+\@lnumwidth=\dimen122
+\bibindent=\dimen123
+(/usr/local/texlive/2016/texmf-dist/tex/platex/jsclasses/jslogo.sty
+Package: jslogo 2016/07/14 okumura, texjporg
+LaTeX Info: Redefining \TeX on input line 94.
+LaTeX Info: Redefining \LaTeX on input line 147.
+LaTeX Info: Redefining \LaTeXe on input line 200.
+)
+\heisei=\count90
+)
+(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/graphicx.sty
+Package: graphicx 2014/10/28 v1.0g Enhanced LaTeX Graphics (DPC,SPQR)
+
+(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/keyval.sty
+Package: keyval 2014/10/28 v1.15 key=value parser (DPC)
+\KV@toks@=\toks15
+)
+(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/graphics.sty
+Package: graphics 2016/10/09 v1.0u Standard LaTeX Graphics (DPC,SPQR)
+
+(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/trig.sty
+Package: trig 2016/01/03 v1.10 sin cos tan (DPC)
+)
+(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics-cfg/graphics.cfg
+File: graphics.cfg 2016/06/04 v1.11 sample graphics configuration
+)
+Package graphics Info: Driver file: dvipdfmx.def on input line 99.
+
+(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics-def/dvipdfmx.def
+File: dvipdfmx.def 2016/07/11 v4.12 LaTeX color/graphics driver for dvipdfmx (L
+3/ChoF)
+))
+\Gin@req@height=\dimen124
+\Gin@req@width=\dimen125
+)
+(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/listings.sty
+\lst@mode=\count91
+\lst@gtempboxa=\box42
+\lst@token=\toks16
+\lst@length=\count92
+\lst@currlwidth=\dimen126
+\lst@column=\count93
+\lst@pos=\count94
+\lst@lostspace=\dimen127
+\lst@width=\dimen128
+\lst@newlines=\count95
+\lst@lineno=\count96
+\lst@maxwidth=\dimen129
+
+(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/lstmisc.sty
+File: lstmisc.sty 2015/06/04 1.6 (Carsten Heinz)
+\c@lstnumber=\count97
+\lst@skipnumbers=\count98
+\lst@framebox=\box43
+)
+(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/listings.cfg
+File: listings.cfg 2015/06/04 1.6 listings configuration
+))
+Package: listings 2015/06/04 1.6 (Carsten Heinz)
+
+(./nasu_abst.aux)
+\openout1 = `nasu_abst.aux'.
+
+LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for JY1/mc/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+LaTeX Font Info:    Checking defaults for JT1/mc/m/n on input line 12.
+LaTeX Font Info:    ... okay on input line 12.
+\c@lstlisting=\count99
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 16.60605pt on input line 16.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 16.60605pt on input line 16.
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 11.53198pt on input line 16.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 11.53198pt on input line 16.
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <12> on input line 16.
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <8> on input line 16.
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <6> on input line 16.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 5.76599pt on input line 16.
+LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
+(Font)              scaled to size 11.53198pt on input line 18.
+LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
+(Font)              scaled to size 11.53198pt on input line 18.
+LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
+(Font)              scaled to size 9.60999pt on input line 25.
+LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
+(Font)              scaled to size 9.60999pt on input line 25.
+File: abst_fig.png Graphic file (type bmp)
+ <abst_fig.png>
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 33.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 33.
+
+Underfull \vbox (badness 10000) has occurred while \output is active []
+
+LaTeX Font Info:    Font shape `JT1/mc/m/it' in size <10> not available
+(Font)              Font shape `JT1/mc/m/n' tried instead on input line 61.
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 9.60999pt on input line 61.
+LaTeX Font Info:    Font shape `JY1/mc/m/it' in size <10> not available
+(Font)              Font shape `JY1/mc/m/n' tried instead on input line 61.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 9.60999pt on input line 61.
+ [1
+
+
+]
+(./nasu_abst.aux) ) 
+Here is how much of TeX's memory you used:
+ 2015 strings out of 493683
+ 27305 string characters out of 6149653
+ 93733 words of memory out of 5000000
+ 5615 multiletter control sequences out of 15000+600000
+ 13862 words of font info for 60 fonts, out of 8000000 for 9000
+ 934 hyphenation exceptions out of 8191
+ 26i,7n,32p,679b,325s stack positions out of 5000i,500n,10000p,200000b,80000s
+
+Output written on nasu_abst.dvi (1 page, 7808 bytes).

data/docs/nasu/nasu_abst/nasu_abst.tex

@@ -0,0 +1,63 @@
+\documentclass[10pt,a4j,twocolumn]{jsarticle}
+
+\usepackage[dvipdfmx]{graphicx}
+\usepackage{listings}
+\setlength{\textheight}{275mm}
+\headheight 5mm
+\topmargin -30mm
+\textwidth 185mm
+\oddsidemargin -15mm
+\evensidemargin -15mm
+\pagestyle{empty}
+\begin{document}
+\title{ユーザメモソフトmy\_helpのビヘイビアテスト開発}
+\author{関西学院大学 情報科学科 西谷研究室 2535 那須比呂貴}
+\date{}
+\maketitle
+
+\section{目的}
+\vspace{-0.5em}
+プログラム開発では，統合開発環境がいくつも用意されているが，多くの現場では，terminal上での開発が一般的である．ところが，プログラミング初心者はterminal上でのcharacter user interface(CUI)を苦手としている．この不可欠なCUIスキルの習得を助けるソフトとして，ユーザメモソフトmy\_helpがruby gemsに置かれている．しかし，Ruby gemsとして提供されているこのソフトは，テストが用意されていない．今後ソフトを共同開発を進めていくには，仕様や動作の標準となるテスト記述が不可欠である．本研究の目的は，ユーザメモソフトであるmy\_helpのテストをBDDを用いて開発することである．
+
+\section{方法}
+\vspace{-0.5em}
+\paragraph{BDD}
+ビヘイビア駆動開発(Behaviour-Driven Development : BDD)は，テスト駆動開発(Test-Driven Development : TDD)の工程への理解を深め，それをうまく説明しようとして始まった．TDDの持つ単語のイメージが構造のテストを中心とすべしというのに対して，BDDはソフトの振る舞いに中心をおくという意図がある．この違いが，初めに考えるべきテストの性質を変化させ，構造ではなく振る舞いを中心にテストを構築するという意識をもたせてくれる．さらに，実世界における開発チームやテストチーム，あるいはドキュメントチーム間のコミュニケーションの取り方を，システムで提供するのがBDDのフレームワークであり，CucumberとRSpecはこれを実現する一つのシステムとして提供されている\cite{RSpecBook}．
+
+\paragraph{CucumberとRSpec}
+図1はRSpecとCucumberの関係図である．BDDの流れとして，まずCucumberで一つのシナリオに焦点を当てて，その振る舞いを記述するfeatureを書く．一つのfeatureが書けたら、次に，それぞれfeatureを実現するステップに分けて仕様を決める．これはTDDのred green refactoringの前に行う作業，「仕様を決める」に対応している．このプロセスが終了したら，RSpecに進む．
+RSpecでは実際にテストコードを書き，ここでもred, green, refactoringをおこない，RSpecが成功したら，Cucumberのrefactoringをおこなう．
+\begin{figure}
+\begin{center}
+\includegraphics[width=5cm, bb=0 0 394 443]{abst_fig.png}
+\caption{RSpecとCucumberのRed-Green-Refactoringサイクル間の関係．}
+\end{center}
+\vspace{-3em}
+\end{figure}
+
+\section{ビヘイビアテスト駆動開発の実践}
+CucumberとRSpecを用いてBDDでmy\_helpのテスト開発を進めていった．
+ここでは，焦点を合わせたmy\_helpの中での一つの振る舞いである「todoの更新」を例として詳しく見ていく．
+\begin{description}
+\item[cucumber]
+\begin{enumerate}
+\item まず，「todoの更新」のシナリオをfeatureで記述．
+\item cucumberを実行するとステップの元なるコードブロックが自動生成されるので，それをコピー\&ペーストしてステップを記述．
+\item ここではあれば良いなと思うコードを記述し，もう一度cucumberを実行．
+\end{enumerate}
+\item[rspec]
+\item ここでは，エラーが出るはずで，そのシナリオに焦点をあて，RSpecに移行してテストコードを記述．
+\item[cucumber] RSpecが成功したら，もう一度Cucumberに戻り，redをgreenに．
+\end{description}
+このようにして，BDDのコンセプトに従って，my\_helpの仕様や動作の標準を確定していった．
+
+\section{まとめ}
+\vspace{-0.5em}
+my\_helpのテスト記述の進展に伴って，仕様や動作の標準が確定した．
+my\_helpは今後も開発者，ならびに多くのユーザの使用を通じて，どのように進化させれば便利なのかが徐々にわかってくる．つまり，ビヘイビアの記述により，今後my\_helpを進化させるための共同開発が円滑に進める手助けになる．
+さらに，my\_helpの使用方法が明確になったことで，本研究で作成したmy\_helpのfeaturesを読めば初心者でもmy\_helpの振る舞いが容易に理解できるようになった．
+
+\begin{thebibliography}{99}
+\bibitem{RSpecBook}   "The RSpec Book", David Chelimsky {\it et al.}, (翔泳社, 2012).
+\end{thebibliography}
+\end{document}

data/docs/nasu/new_code.hiki

@@ -0,0 +1,246 @@
+{{toc}}
+!ビヘイビア駆動開発の実践
+
+CucumberとRSpecを用いてBDDでmy_helpのテスト開発を進めていきました．
+// アプリの振る舞いを説明する
+// なぜ自分が作ったかを納得してもらえないから．
+// 自分の作業の目的の意義を説明するために，全体の概要を説明することは妥当
+// 先行研究->先行開発，ソフト開発==研究，why!!
+ビヘイビア駆動開発のコツとして「焦点を合わせる」ことが強調されています．
+ここでは，焦点を合わせたmy_helpの中での一つの振る舞いである
+「todoの更新」を例として詳しく見ていきます．
+
+!!todoの更新マニュアル
+最初に，todoを更新するときの手順を示します．
+
+#my_todo --editを入力して~/.my_help/my_todo.ymlを開く
+#editorでtodoを書き込む（今週やることならweeklyというitemを作ってそこに書き込む）
+#保存して~/.my_help/my_todo.ymlを閉じる
+//#my_todoと打ち込んで更新されていたら完成
+//#my_todo --store [item]を入力してitemのバックアップをとる
+
+この振る舞いがきちんとできているのかをBDDでテストを書いていきます．
+
+!!Cucumber
+
+以下はtodoの更新を行うときのfeatureです．
+まず，適当なディレクトリにfeaturesというディレクトリを作成します．
+次に先ほど作成した，featuresディレクトリにmy_todo.featureを作成します．
+<<< tcsh
+# language: ja 
+
+機能: todoの更新を行う
+自分のするべきことを書き込むためにtodoを更新する
+
+ シナリオ: コマンドを入力してtodoを更新していく
+          前提 todoを編集したい
+          もし "my_todo --edit"と入力する
+          ならば editが開かれる
+          かつ 自分のtodoを書き込む
+>>>
+
+機能とは，このシステムの機能のことを記述します．ここでは，todoを更新するシステムですので，「todoの更新を行う」です．
+機能の下には，機能の補足説明を記述します．機能の補足説明では，ルールがないので自分がわかりやすいように，記述するのが常識です．
+シナリオは，その名の通りtodoを更新する時のユーザの行動やシステム振る舞いを前提，もし，ならば，かつ，しかしに分類して記述します．
+
+
+ここまでfeatureが記述できたら，次はcucumberコマンドを実行してみます．
+コマンドは以下の通りです．
+ nasu% cucumber features/my_todo.feature 
+featuresディレクトリにあるmy_todo.featureファイルをcucumberで実行するという意味です．
+
+実行すると図{{ref(fig:003)}}のようになります．
+
+!!!caption:(fig:003)step定義をする前のcucumberの実行結果．
+{{attach_view(my_help_nasu.003.jpeg,my_help_nasu)}})
+
+ここでは，1つのscenarioと4つのstepが失敗しています．
+まだstep定義を記述していないので当たり前です．
+
+一度cucumberを実行したのには理由があります．
+featureを書いた時点でcucumberを実行すると，ステップ定義の元となるコマンドを，cucumberが自動的に作成してくれるからです．
+
+以下がcucumberから出力されたステップ定義の元となる部分です．
+
+<<< tcsh
+前提(/^todoを編集したい$/) do
+
+end
+
+もし(/^"([^"]*)"と入力する$/) do |command|
+
+end
+
+ならば(/^editが開かれる$/) do
+  
+end
+
+ならば(/^自分のtodoを書き込む$/) do
+
+end
+>>>
+
+これをコピーして，featuresディレクトリの中でstep_definitionsディレクトリを作成し，その中にmy_todo_spec.rbを作成し，そこに貼付けます．
+
+ここでもう一度cucumberを実行してみると図{{ref(fig:004)}}のように変化が出てきます．
+
+!!!caption:(fig:004)defaultのstep定義を貼り付けた後のcucumberの実行結果．
+{{attach_view(my_help_nasu.004.jpeg,my_help_nasu)}}
+
+これは1つのシナリオがあり，1つがpendingであり，4つのstepの内1つがpendingで3つがskipしたことを表しています．
+step_definitionsのmy_todo_spec.rbのpending部分を書き換えて，step_definitionsの記述を進めていきます.
+
+まず，「前提」を見てみるとmy_helpが何か振る舞いをすることはありません．
+よって，このままにしておきます．
+「もし」もユーザが入力するコマンドであり，my_helpが何か振る舞いをすることはないのでこのままにしておきます．
+次に，「ならば」を見てみるとmy_helpがeditを開くという振る舞いをしています．
+ステップ定義では，あれば良いと思うコードを記述するので私は下記のように記述しました．
+
+<<< tcsh
+ならば(/^editが開かれる$/) do
+  Mytodo::Edit.new.open
+end
+>>>
+
+pendingの部分が書けたので，もう一度cucumber features/my_todo.featureを実行します．
+すると，図{{ref(fig:005)}}のような結果が返ってきました．
+
+!!!caption:(fig:005)pendingのstep定義を書き込んだ後のcucumberの実行結果．
+{{attach_view(my_help_nasu.005.jpeg,my_help_nasu)}}
+
+Cucumberは，エラーが出たステップのすぐ後ろにエラーを表示してくれます．
+ここでCucumberでエラーが出たので，この「ならば　editが開かれる」のシナリオに注目してRSpecに進むことにします．
+
+
+!!RSpec
+次にRSpecを使って実際にtodoを更新する振る舞いをするコード書いていきます．
+
+そのための準備として，まずspecというディレクトリを作成し，my_todoというサブディレクトリを追加します．
+次に，このサブディレクトリにtodo_spec.rbというファイルを追加します．
+この機能はmy_help --editと入力されれば，~/.my_help/my_todo.ymlが開かれるので，その振る舞いをするコードを書きます．
+まずtodo_spec.rbは下記の通りです．
+
+<<< ruby
+require 'spec_helper'
+
+
+module Mytodo
+  describe Todo do
+    describe "#open" do
+      it "open file my_todo.yml" 
+    end
+  end
+end
+
+>>>
+
+describe()メソッドは，RSpecのAPIにアクセスしてRSpec::Core::ExampleGroupのサブクラスを返します．
+ExampleGroupクラスはオブジェクトに期待される振る舞いのサンプルを示すグループです．
+it()メソッドはサンプルを作成します．
+
+
+完成したコードを下記の通りです．
+
+<<< ruby
+require 'spec_helper'
+
+
+module Mytodo
+  describe Todo do
+    describe "#open" do
+      it "open file my_todo.yml" do
+          system("emacs ~/.my_help/my_todo.yml")
+      end
+    end
+  end
+end
+
+>>>
+
+specディレクトリのmy_todoディレクトリをrspecで実行すると図{{ref(fig:006)}}結果がでました．
+[[--color]]を付け加えるとわかりやすく色づけをしてくれて，見やすくなります．
+
+!!!caption:(fig:006)pendingのstep定義を書き込んだ後のcucumberの実行結果．
+{{attach_view(my_help_nasu.006.jpeg,my_help_nasu)}}
+
+図{{ref(fig:006)}}を見るとエラーが出てしまっているのがわかります．
+
+ `<module:Mytodo>': uninitialized constant Mytodo::Edit (NameError)
+
+上記のエラーを解決するために，specディレクトリの一つ上の構造のディレクトリにlibディレクトリを作成します．
+その中にmy_todoというディレクトリを作成し，my_todo.rbを作成します．
+
+構造を表示すると以下のようになります．
+ /Users/nasubi/my_help/lib/my_todo% ls
+ my_todo.rb
+
+my_todo.rbに先ほどのエラーでMytodoというmoduleがないといわれているので，
+ここで作成します．
+
+/Users/nasubi/my_help/lib/my_todo/my_todo.rbの中に以下のコードを記述します．
+
+<<< tcsh
+module Mytodo
+  class Edit
+    def open
+
+    end
+  end
+end
+>>>
+
+また，これをrequireしないといけないので，lib/todo.rbとして，以下を追加します．
+<<<
+require 'my_todo/my_todo'
+>>>
+
+これだけでは，rspecがlib/my_todo/my_todo.rbを読み込んでいないため，このスペックを実行するために，specディレクトリにspec_helper.rbに以下を追加します．
+
+<<< tcsh
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'todo'
+>>>
+
+これでもう一度rspecを実行してみると図{{ref(fig:007)}}の結果が返ってきました．
+
+!!!caption:(fig:007)redを修正してgreenになったrspecの実行結果
+{{attach_view(my_help_nasu.007.jpeg,my_help_nasu)}}
+
+図{{ref(fig:007)}}を見ると，エラーが消えて成功しているのがわかります．
+これで「ならば　editが開かれる」のシナリオのRSpec部分が成功しました．
+Red, Greenと進めたので次はRefactoringをするのですが，ここではあまり必要のないので省略します．
+RSpecが終わったので，Cucumberに戻ります．
+
+先ほどlibディレクトリでlib/my_todo/my_todo.rbを作成したので，cucumberでも読み込むために，以下を作成します．
+
+ /Users/nasubi/my_help/features/support/env.rb
+
+env.rbの中は以下の通りです．
+<<< ruby
+$LOAD_PATH.unshift File.expand_path('../../../lib', __FILE__)
+require 'todo'
+>>>
+
+これでcucumberもlib/の中身を読み取ってくれます．
+
+もう一度cucumberを実行してみると,図{{ref(fig:008)}}の結果が返ってきました．
+
+!!!caption:(fig:008)libの中身を読み込むようにしたcucumberの実行結果．
+{{attach_view(my_help_nasu.008.jpeg,my_help_nasu)}}
+
+エラーが消えています．
+
+これでBDDが成功しました．
+残りの「自分のtodoを書き込む」もmy_helpが何か振る舞いをするわけではないので，「コマンドを入力してtodoを更新する」シナリオ全てのテスト開発が終わりました．
+このようにBDDでmy_helpのテスト開発を行っていきました．
+
+!!.rspec options
+図{{ref(fig:006)}}の時に述べたように,[rspec spec --color]で実行すると成功すればGreenで表示され，失敗すればRedで表示されます．
+結果に色がついていると見やすく，どのような結果が出ているかが一目瞭然です．
+しかし，毎回[--color]のコマンドを打ち込むのが面倒になってきます．
+そこで，カレントディレクトリに.rspecを用意し，
+<<<
+--format documentation
+--color
+>>>
+のようにすることで，rspecで実行するときにこのファイルを読み込み，[--color]を入力しなくても実行されます．

data/docs/nasu/spec/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/docs/nasu/spec/my_help_spec.rb

@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+require "./spec_helper.rb"
+
+RSpec.describe 'my_help command', type: :aruba do
+  context 'version option' do
+    before(:each) { run('my_help -v') }
+    it { expect(last_command_started).to be_successfully_executed }
+    it { expect(last_command_started).to have_output("my_help 0.4.5") }
+  end
+
+  context 'help option' do
+    expected = <<EXPECTED
+Usage: my_help [options]
+    -v, --version                    show program Version.
+    -l, --list                       list specific helps
+    -e, --edit NAME                  edit NAME help(eg test_help)
+    -i, --init NAME                  initialize NAME help(eg test_help)
+    -m, --make                       make executables for all helps
+    -c, --clean                      clean up exe dir.
+        --install_local              install local after edit helps
+        --delete NAME                delete NAME help
+EXPECTED
+    before(:each) { run('my_help -h') }
+    it { expect(last_command_started).to be_successfully_executed }
+    it { expect(last_command_started).to have_output(expected.chomp) }
+  end
+
+  context 'init option1' do
+    before(:each) { run('my_help -i test_help') }
+
+    expected=<<EOS
+"/Users/OyagiToshiharu/.my_help/test_help.yml"
+File exists. rm it first to initialize it.
+EOS
+    it { expect(last_command_started).to be_successfully_executed }
+    it { expect(last_command_started).to have_output(expected.chomp) }
+  end
+
+
+  context 'edit option' do
+    expected = <<EXPECTED
+#<OptionParser::MissingArgument: -e>
+EXPECTED
+  before(:each) { run('my_help -e') }
+  it { expect(last_command_started).to be_successfully_executed }
+  it { expect(last_command_started).to have_output(expected.chomp) }
+  end
+
+  context 'init option2' do
+    expected = <<EXPECTED
+#<OptionParser::MissingArgument: -i>
+EXPECTED
+  before(:each) { run('my_help -i') }
+  it { expect(last_command_started).to be_successfully_executed }
+  it { expect(last_command_started).to have_output(expected.chomp) }
+  end
+
+  context 'make option' do
+    expected = <<EXPECTED
+"exe/my_todo"
+#<Errno::ENOENT: No such file or directory @ rb_sysopen - exe/my_todo>
+EXPECTED
+    before(:each) { run('my_help -m') }
+    it { expect(last_command_started).to be_successfully_executed }
+    it { expect(last_command_started).to have_output(expected.chomp) }
+  end
+
+  context 'list option' do
+    expected = "Specific help file:\n  my_todo\t:my todo\n  emacs_help\t:emacsのキーバインド\n  test_help\t:ヘルプのサンプル雛形\n"
+
+    before(:each) { run('my_help -l') }
+    it { expect(last_command_started).to be_successfully_executed }
+    it { expect(last_command_started).to have_output(expected.chomp) }
+  end
+end

data/docs/nasu/spec/my_todo/todo_spec.rb

@@ -0,0 +1,15 @@
+
+require 'spec_helper'
+
+
+module Mytodo
+  describe Edit do
+    describe "#open" do
+      it "open file my_todo.yml" do
+#        if command == "my_todo --edit"
+          system("emacs ~/.my_help/my_todo.yml")
+#        end
+      end
+    end
+  end
+end

data/docs/nasu/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'my_help'
+require 'todo'
+if RUBY_VERSION < '1.9.3'
+  ::Dir.glob(::File.expand_path('../support/*.rb', __FILE__)).each { |f| require File.join(File.dirname(f), File.basename(f, '.rb')) }
+  ::Dir.glob(::File.expand_path('../support/**/*.rb', __FILE__)).each { |f| require File.join(File.dirname(f), File.basename(f, '.rb')) }
+else
+  ::Dir.glob(::File.expand_path('../support/*.rb', __FILE__)).each { |f| require_relative f }
+  ::Dir.glob(::File.expand_path('../support/**/*.rb', __FILE__)).each { |f| require_relative f }
+end
+

data/docs/nasu/spec/support/aruba.rb

@@ -0,0 +1 @@
+require 'aruba/rspec'