my_help 0.4.5 → 0.5.0

data/docs/nasu/keynote/cucumber01.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/cucumber01.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+92B0042B-42C8-4B59-BBC5-242C3A7AB2A7

data/docs/nasu/keynote/cucumber02.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/cucumber02.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+EB10F494-6B48-4203-9A92-C94111442851

data/docs/nasu/keynote/cucumber03.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/cucumber03.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+63E6B0D2-471E-4283-BE48-2870965E1107

data/docs/nasu/keynote/cucumber04.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/cucumber04.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+0B5FA5CF-ACA8-4442-9EEF-606113D24EEA

data/docs/nasu/keynote/cucumber05.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/cucumber05.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+AC085591-E69F-4207-91A3-5CE1120ACBB4

data/docs/nasu/keynote/my_help_nasu1.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/my_help_nasu1.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+7529235A-AF45-4E92-868E-3705DFFF99C7

data/docs/nasu/keynote/rspec01.key/Metadata/BuildVersionHistory.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2-1861-1</string>
+</array>
+</plist>

data/docs/nasu/keynote/rspec01.key/Metadata/DocumentIdentifier

@@ -0,0 +1 @@
+DCA775C4-6CEB-45EF-BEA3-4C39D1B6B62D

data/docs/nasu/latex_dir/abstract.tex

@@ -0,0 +1,18 @@
+プログラム開発では，統合開発環境がいくつも用意されているが，多くの現場では，terminal上での開発が一般的です．
+ところが，プログラミング初心者はterminal上でのcharacter user interface(CUI)を苦手としています．
+この不可欠なCUIスキルの習得を助けるソフトとして，ユーザメモソフトmy\_helpがruby gemsに置かれています．
+このcommand line interface(CLI)で動作するmy\_helpは，helpをterminal上で簡単に提示するものです．
+また，初心者が自ら編集することによって，すぐに参照できるメモとしての機能を提供しています．
+これにより，プログラム開発に集中できることが期待でき，初心者のスキル習得が加速することが期待できます．
+しかし，Ruby gemsとして提供されているこのソフトは，動作はするがテストが用意されていません．
+今後ソフトを進化させるために共同開発を進めていくには，仕様や動作の標準となるテスト記述が不可欠となります．
+そこで，本研究では，ユーザメモソフトであるmy\_helpのテストを開発することを目的とします．
+本研究では、テスト駆動開発の中でも，ソフトの振る舞いを記述します
+Behavior Driven Development(BDD)に基づいてテストを記述していきます．
+Rubyにおいて、BDD環境を提供する標準的なフレームワークであるCucumberとRSpecを用いて，
+my\_helpがどのような振る舞いをするのかを記述します．
+Cucumberは自然言語で振る舞いを記述することができるため，ユーザにとって，わかりやすく振る舞いを確認することができます．
+ここでは，実際にBDDの流れにそって，my\_helpのある一例を取り上げてのテスト開発を進めていきます．
+また，my\_helpの頻繁に使うコマンドの振る舞いを記述しています．
+このことにより，来年の本研究室の研究生のスキルがより向上することが期待されると考えています．
+

data/{my_help_nasu → docs/nasu}/latex_dir/code.tex

@@ -53,20 +53,8 @@ featuresディレクトリにあるmy\_todo.featureファイルをcucumberで実
 
 実行すると以下のようになります．
 \begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
-# language: ja
-機能: todoの更新を行う
-todoは更新していくものであり,新しく書いたり終わったものを消したいのでバックアップをとって，過去のtodoを残しておく
 
-  シナリオ: コマンドを入力してtodoを更新していく # features/my_todo.feature:6
-    前提todoを編集したい             # features/my_todo.feature:7
-    もし"my_todo --edit"と入力する  # features/my_todo.feature:8
-    ならばeditが開かれる             # features/my_todo.feature:9
-    かつ自分のtodoを書き込む           # features/my_todo.feature:10
-
-  シナリオ: コマンドを入力してバックアップをとる          # features/my_todo.feature:12
-    前提todoの編集が終わった                  # features/my_todo.feature:13
-    もし"my_todo --store [item]"と入力する # features/my_todo.feature:14
-    ならばitemのバックアップを取る               # features/my_todo.feature:15
+＜省略＞
 
 2 scenarios (2 undefined)
 7 steps (7 undefined)
@@ -195,14 +183,14 @@ todoは更新していくものであり,新しく書いたり終わったもの
 
 \end{lstlisting}
 \subsection{RSpec}
-次にRSpecを使って実際にtodoを更新する振る舞いをするコード書いていく．
+次にRSpecを使って実際にtodoを更新する振る舞いをするコード書いていきます．
 
-そのための準備として，まずspecというディレクトリを作成し，my\_todoというサブディレクトリを追加する．
-次に，このサブディレクトリにtodo\_spec.rbというファイルを追加する．
+そのための準備として，まずspecというディレクトリを作成し，my\_todoというサブディレクトリを追加します．
+次に，このサブディレクトリにtodo\_spec.rbというファイルを追加します．
 作業を進める過程で，lib/my\_todo/my\_todo.rbソースファイルとspec/my\_todo/todo\_spec.rbスペックファイルが１対１に対応するといった要領で，
-並列のディレクトリ構造を築いていく．
+並列のディレクトリ構造を築いていきます．
 この機能はmy\_help --editと入力されれば，~/.my\_help/my\_todo.ymlが開かれるのでその振る舞いをするコードを書きます．
-まずtodo\_spec.rbは下記の通りになります
+まずtodo\_spec.rbは下記の通りになります．
 \begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
 require 'spec_helper'
 
@@ -245,7 +233,7 @@ module Mytodo
 end
 
 \end{lstlisting}
-これでrspecを実行すると以下のような結果が表示される．
+これでrspecを実行すると以下のような結果が表示されます．
 \begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
 /Users/nasubi/my_help% rspec spec --color
 
@@ -265,7 +253,7 @@ Finished in 3.87 seconds (files took 0.30703 seconds to load)
 5 examples, 0 failures
 
 \end{lstlisting}
-これでtodoを更新するときの振る舞いのテストはうまく成功した．
+これでtodoを更新するときの振る舞いのテストはうまく成功しました．
 
-この方法でBDDでmy\_helpのテスト開発を行い，仕様を決定していった．
+この方法でBDDでmy\_helpのテスト開発を行い，仕様を決定していきました．
 

data/docs/nasu/latex_dir/discussion.aux

@@ -0,0 +1,28 @@
+\relax 
+\citation{RSpecBook}
+\citation{RSpecBook}
+\@writefile{toc}{\contentsline {section}{\numberline {4}考察と今後の課題}{30}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {4.1}考察}{30}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.1}Cucumberを記述できるようになるまで時間がかかる}{30}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.2}BDDを行うときにrubyの知識が必要}{30}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {4.2}my\_helpの今後}{30}}
+\@setckpt{discussion}{
+\setcounter{page}{32}
+\setcounter{equation}{0}
+\setcounter{enumi}{3}
+\setcounter{enumii}{0}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{4}
+\setcounter{subsection}{2}
+\setcounter{subsubsection}{0}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{8}
+\setcounter{table}{1}
+\setcounter{lstlisting}{0}
+\setcounter{lstnumber}{13}
+}

data/docs/nasu/latex_dir/discussion.tex

@@ -0,0 +1,19 @@
+\section{考察と今後の課題}
+\subsection{考察}
+my\_helpを対象とした具体的なビヘイビア駆動開発の実践を通して，以下のような問題点が明らかになってきました．
+
+\subsubsection{Cucumberを記述できるようになるまで時間がかかる}
+日本語で書くことができるので，記述されているコードを「理解する」のは容易で，「記述する」ことも可能であると考えていました．ところが，The RSpec Book\cite{RSpecBook}に記載されているテンプレートが少なく，理解することにも非常に困難を覚えました．自力で何も前例のない状況から作成することはできますが，やはり時間がかかってしまいます．ネットで検索しても，日本語のサイトではほぼThe RSpec Book\cite{RSpecBook}と類似したシナリオしか記載されていないのも問題の一つであり，違った種類の書き方のテンプレートがもっと必要です．地道に幾度もCucumberを叩いて，featuresやrspecの記述すること，またそのデータベースを蓄えていくことが必要です．
+また，BDDではCucumberでエラーが出ている状況が正しく，Cucumberを放置してRSpecへと進みます．今までのプログラミングとは少し違う感覚に陥り，不安がよぎります．これは慣れるまでの辛抱ではありますが，この問題も時間との戦いです．
+
+\subsubsection{BDDを行うときにrubyの知識が必要}
+Cucumberのステップ定義やRSpecにおいてrubyを用いることが多々あります．スッテプ定義を記述するときに，あればよいと思うコードを書くのですが，具体的なプログラムを書くよりも難易度が高いと感じました．部分的なプログラムを作成するので，知識がないと正しいかどうかの判断が最後にしかできません．BDDを通してrubyを学べるという考え方もできますが，BDDでrubyを学ぶには物足りなさがあり，不向きです．したがって，BDDを使用する前にrubyの基礎の勉強は不可欠です．
+
+\subsection{my\_helpの今後}
+my\_helpのテスト記述が完了するに伴って，仕様や動作の標準が確定しました．
+my\_helpは今後も開発者，ならびに多くのユーザの使用を通じて，どのように進化させれば便利なのかが徐々にわかってくることで，my\_helpはまだまだ進化する機会が出てくると思われます．
+つまり，ビヘイビアの記述を利用することで，今後my\_helpを進化させるための共同開発が円滑に進める手助けになると推測します．
+また，my\_helpの進化の開発だけに関わらず，my\_helpの使用方法が明確になったことで，本研究で作成したmy\_helpのfeaturesを読めば初心者でもmy\_helpの振る舞いが容易に理解できます．
+my\_helpは本研究室で今後使われていくと予想し，本研究はこれからの研究の手助けになります．
+今後の本研究室の研究生が，CUIなどの習得に時間をかけずにプログラミングに集中でき，研究の質が向上すると予想できます．
+

data/docs/nasu/latex_dir/features.aux

@@ -0,0 +1,30 @@
+\relax 
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.5}featuresでの記述とその意味}{25}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.1}--add [item]}{25}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.2}--all}{25}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.3}--backup\_list}{26}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.4}--edit}{26}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.5}--remove [item]}{27}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.6}--store [item]}{27}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.7}--to\_hiki}{27}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.5.8}todoの更新}{28}}
+\@setckpt{features}{
+\setcounter{page}{30}
+\setcounter{equation}{0}
+\setcounter{enumi}{3}
+\setcounter{enumii}{0}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{3}
+\setcounter{subsection}{5}
+\setcounter{subsubsection}{8}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{8}
+\setcounter{table}{1}
+\setcounter{lstlisting}{0}
+\setcounter{lstnumber}{13}
+}