my_help 0.4.5 → 0.5.0

data/docs/yagi/bachelor_thesis/final/thesis/final_thesis.ipynb

@@ -0,0 +1,449 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "toc": true
+   },
+   "source": [
+    "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n",
+    "<div class=\"toc\" style=\"margin-top: 1em;\"><ul class=\"toc-item\"><li><span><a href=\"#はじめに\" data-toc-modified-id=\"はじめに-1\"><span class=\"toc-item-num\">1&nbsp;&nbsp;</span>はじめに</a></span><ul class=\"toc-item\"><li><span><a href=\"#目的\" data-toc-modified-id=\"目的-1.1\"><span class=\"toc-item-num\">1.1&nbsp;&nbsp;</span>目的</a></span></li></ul></li><li><span><a href=\"#基本的事項\" data-toc-modified-id=\"基本的事項-2\"><span class=\"toc-item-num\">2&nbsp;&nbsp;</span>基本的事項</a></span><ul class=\"toc-item\"><li><span><a href=\"#my_help\" data-toc-modified-id=\"my_help-2.1\"><span class=\"toc-item-num\">2.1&nbsp;&nbsp;</span>my_help</a></span><ul class=\"toc-item\"><li><span><a href=\"#my_helpの目的\" data-toc-modified-id=\"my_helpの目的-2.1.1\"><span class=\"toc-item-num\">2.1.1&nbsp;&nbsp;</span>my_helpの目的</a></span></li><li><span><a href=\"#使用法\" data-toc-modified-id=\"使用法-2.1.2\"><span class=\"toc-item-num\">2.1.2&nbsp;&nbsp;</span>使用法</a></span></li></ul></li><li><span><a href=\"#optparse\" data-toc-modified-id=\"optparse-2.2\"><span class=\"toc-item-num\">2.2&nbsp;&nbsp;</span>optparse</a></span></li><li><span><a href=\"#thor\" data-toc-modified-id=\"thor-2.3\"><span class=\"toc-item-num\">2.3&nbsp;&nbsp;</span>thor</a></span></li><li><span><a href=\"#option\" data-toc-modified-id=\"option-2.4\"><span class=\"toc-item-num\">2.4&nbsp;&nbsp;</span>option</a></span></li></ul></li><li><span><a href=\"#研究内容\" data-toc-modified-id=\"研究内容-3\"><span class=\"toc-item-num\">3&nbsp;&nbsp;</span>研究内容</a></span><ul class=\"toc-item\"><li><span><a href=\"#thor化に伴う書き換え（具体的な作業）\" data-toc-modified-id=\"thor化に伴う書き換え（具体的な作業）-3.1\"><span class=\"toc-item-num\">3.1&nbsp;&nbsp;</span>thor化に伴う書き換え（具体的な作業）</a></span></li><li><span><a href=\"#thorによるサブコマンド\" data-toc-modified-id=\"thorによるサブコマンド-3.2\"><span class=\"toc-item-num\">3.2&nbsp;&nbsp;</span>thorによるサブコマンド</a></span></li><li><span><a href=\"#exeディレクトリの書き換え\" data-toc-modified-id=\"exeディレクトリの書き換え-3.3\"><span class=\"toc-item-num\">3.3&nbsp;&nbsp;</span>exeディレクトリの書き換え</a></span></li><li><span><a href=\"#libディレクトリ\" data-toc-modified-id=\"libディレクトリ-3.4\"><span class=\"toc-item-num\">3.4&nbsp;&nbsp;</span>libディレクトリ</a></span></li><li><span><a href=\"#その他オプション\" data-toc-modified-id=\"その他オプション-3.5\"><span class=\"toc-item-num\">3.5&nbsp;&nbsp;</span>その他オプション</a></span></li><li><span><a href=\"#オプションの比較\" data-toc-modified-id=\"オプションの比較-3.6\"><span class=\"toc-item-num\">3.6&nbsp;&nbsp;</span>オプションの比較</a></span><ul class=\"toc-item\"><li><span><a href=\"#optparse版\" data-toc-modified-id=\"optparse版-3.6.1\"><span class=\"toc-item-num\">3.6.1&nbsp;&nbsp;</span>optparse版</a></span></li><li><span><a href=\"#thor版\" data-toc-modified-id=\"thor版-3.6.2\"><span class=\"toc-item-num\">3.6.2&nbsp;&nbsp;</span>thor版</a></span></li></ul></li></ul></li><li><span><a href=\"#総括\" data-toc-modified-id=\"総括-4\"><span class=\"toc-item-num\">4&nbsp;&nbsp;</span>総括</a></span></li><li><span><a href=\"#謝辞\" data-toc-modified-id=\"謝辞-5\"><span class=\"toc-item-num\">5&nbsp;&nbsp;</span>謝辞</a></span></li><li><span><a href=\"#参考文献\" data-toc-modified-id=\"参考文献-6\"><span class=\"toc-item-num\">6&nbsp;&nbsp;</span>参考文献</a></span></li></ul></div>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# はじめに\n",
+    "\n",
+    "## 目的\n",
+    "\n",
+    "西谷研究室で使われているユーザメモソフト，my helpの振る舞いを制御しているサブコマンドは，マイナスを付した省略記法が取られている．プログラミング初心者にとってこの省略記法は，覚えにくかったりわかりにくかったりするという問題があり，現在はフルワードを使った自然言語に近い記述法が多く用いられている．\n",
+    "そこで，本研究ではコマンドラインツール作成ライブラリを自然言語に近いサブコマンド体系を実装しやすいライブラリであるThorに変更する．rubyの標準ライブラリであるoptparseで作成されているmy helpをThorによって書き直し，異なった2つライブラリで作成されたmy helpの使用感を比較検討することを目的とする．\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# 基本的事項\n",
+    "\n",
+    "## my_help\n",
+    "\n",
+    "### my_helpの目的\n",
+    "\n",
+    "my helpとは，ユーザー独自のマニュアルを作成することができるユーザメモソフトである．これは，terminalだけを用いて簡単に起動，編集，削除などをすることができるため，非常に便利である．さらに，そのマニュアルは自分ですぐに編集，参照することができるので，メモとしての機能も果たし ている．これにより，プログラミング初心者が，頻繁に使うコマンドやキーバインドなどをいちいちweb browserを立ち上げて調べるのではなく，terminal上で即座に取得できるため，プログラム開発を集中することが期待される．\n",
+    "\n",
+    "メモやtodoリストの作成が行えることや，保存場所を共通化することでどこでも立ち上げることができることなど，emacsのorg-modeと類似している点がいくつか存在する．しかし，明確な相違点も存在する．org-modeはemacsを起動させなければならないが，my helpはemacsを起動させる必要がなくterminalで編集することが可能である．また，org-modeを使用するとなるとorg-mode独自のコマンドを学ぶ必要があり，学習コストがかかってしまう．my_helpにはその必要がなく，非常に単純な操作でアプリを使用することができるので，org-modeの使い方を理解していない初心者にとって使いやすいものとなっている．\n",
+    "\n",
+    "また，アプリやプログラミング言語などの正式なマニュアルは英語で書かれていることが多く，初心者には理解するのが困難である．my_helpを使用すれば，自分なりのマニュアルを作成することができるので，仕様を噛み砕いて理解することが可能である．tarminal上でいつでもメモを参照できるため，どこにメモをしたかを忘れるリスクも軽減される．\n",
+    "\n",
+    "\n",
+    "### 使用法\n",
+    "\n",
+    "インストールする方法だが，gemの標準とは少し方法が異なっている．\n",
+    "まず，githubにあるmy helpのリポジトリをフォーク，クローンすることでローカル（ネットワークに繋がれていない環境）でもmy helpを操作することができるようになる．\n",
+    "\n",
+    "> git clone git@github.com:daddygongon/my_help.git\n",
+    "\n",
+    "これ以降の作業はbundleにて行っていく．\n",
+    "\n",
+    "> bundle update\n",
+    "\n",
+    "を実行することでmy_help.gemspecに記述されている必要なgemsがbundleされる．ここでCould not locate Gemfileとエラーが出た場合は、Gemfileのある場所を探し、その配下に移動してから再びコマンドを入力する．\n",
+    "\n",
+    "> bundle exec exe/my_help\n",
+    "\n",
+    "でmy helpに用意されているコマンドを参照することができる．デフォルトでemacs helpというemacsのヘルプが用意されている．これはemacs helpの他に，省略形のe_hでも表示されるようになっている．\n",
+    "\n",
+    "次に，独自のヘルプを作成する方法であるが，まず，\n",
+    "\n",
+    "> bundle exec exe/my_help -i new_help\n",
+    "\n",
+    "とすることでnew helpという名前のヘルプが作成され，そこにテンプレートが格納される．また，\n",
+    "\n",
+    "> bundle exec exe/my_help -e new_help\n",
+    "\n",
+    "で，自分の好きなように編集することができる．ヘルプが完成したら，\n",
+    "\n",
+    "> bundle exec exe/my_help -m\n",
+    "\n",
+    "とすることでexeディレクトリにnew helpが追加され，new help，n_hが使用可能になるという手順である．\n",
+    "\n",
+    "\n",
+    "## optparse\n",
+    "\n",
+    "今回の研究対象のmy helpは，optparseで実装されている．optparseはRubyの標準ライブラリであり，Rubyでコマンドラインのオプションを操作するためのライブラリである[1]．optparseが操作するオプションは，下記のonメソッドで設定する．\n",
+    "\n",
+    "```\n",
+    "def execute\n",
+    "  @argv << ’--help’ if @argv.size==0\n",
+    "  command_parser = OptionParser.new do |opt|\n",
+    "    opt.on(’-v’, ’--version’,’show␣program␣Version.’ ) { |v|\n",
+    "      opt.version = MyHelp::VERSION\n",
+    "      puts opt.ver\n",
+    "    }\n",
+    "    opt.on(’-l’, ’--list’, ’list␣specific␣helps’){list_helps}\n",
+    "    #中略\n",
+    "  end\n",
+    "  #中略\n",
+    "end\n",
+    "    \n",
+    "def list_helps\n",
+    "#中略\n",
+    "end\n",
+    "#後略\n",
+    "```\n",
+    "\n",
+    "第１引数はショートオプションで，-aや-dのような形で設定する．同様にして，第２引数はロングオプションを表し，--addや--deleteのように，第３引数はそのオプションの説明文で，helpで表示される説明文を設定する．後ろのブロックには，そのオプションが指定された場合に実行されるコードを記述する [2]．しかしこのライブラリでは自然言語に近い，ハイフンなしのサブコマンドを実装するには相当な書き換えが必要となる．\n",
+    "\n",
+    "メソッドの引数でオプションを定義し，引数が指定された時の処理をブロックで記述する．ブロックの引数にはオプションが指定されたことを示すtrueが渡される．onメソッドが呼ばれた時点ではオプションは実行されず，定義されるだけである．parseが呼ばれた際，コマンドラインにオプションが登録されていれば実行される．\n",
+    "\n",
+    "オプション定義の際，スペースの後に任意の文字を追加すると，そのオプションは引数を受け取るオプションになる．その文字に[]をつけることで引数は必須でなくなる．また引数がハイフンで始まる場合，オプションとの間にハイフンを２つ挟むことで引数として認識される．\n",
+    "\n",
+    "helpとversionのサブコマンドはデフォルトで作成される．\n",
+    "\n",
+    "## thor\n",
+    "\n",
+    "本研究ではoptparseの代わりのライブラリとしてThorの採用を検討する．Thorは，コマンドラインツールの作成を支援するライブラリであり，gitやbundlerのようにサブコマンドを含むコマンドラインツールを簡単に作成することができる [3]．Thorには以下のような特徴がある．\n",
+    "1. コマンドラインオプションのパーズやサブコマンドごとのヘルプを作るなどの面倒な作業を簡単にこなすことができ，手早くビルドツールや実行可能なコマンドを作成できる [4]．\n",
+    "1. 特殊なDSL(Domain Specific Language)を使わずにメソッドを定義することで処理を記述するため，テストを行いやすい [4]．\n",
+    "1. optparseでは作成することが困難な，マイナスを伴わない(自然言語に近い)サブコマンドを実装することが可能である．\n",
+    "\n",
+    "```\n",
+    "desc 'list, --list', 'list specific helps'\n",
+    "    map \"--list\" => \"list\"\n",
+    "    def list\n",
+    "      print \"Specific help file:\\n\"\n",
+    "      local_help_entries.each{|file|\n",
+    "        file_path=File.join(@local_help_dir,file)\n",
+    "        help = YAML.load(File.read(file_path))\n",
+    "        print \"  #{file}\\t:#{help[:head][0]}\\n\"\n",
+    "      }\n",
+    "    end\n",
+    "end\n",
+    "```\n",
+    "\n",
+    "optparseではonメソッドでコマンドの登録を行い，その後のdefでコマンドの振る舞いを定義している．それに対してThorは登録と定義を同時に行うことが可能である．また，Thorを継承したクラスのパブリックメソッドがそのままコマンドになるので非常に簡単にコマンドを作成することが可能である．Thorはコマンドを作成した時点で自動的にヘルプを生成し，コマンドを指定せずにコマンドラインアプリを実行するとヘルプを表示する．\n",
+    "\n",
+    "\n",
+    "![optparse とThor の比較. \\label{opt_thor}](./figs/opt_thor.png)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## option\n",
+    "\n",
+    "今日，複雑な機能を持つコマンドが増加している．そのようなコマンドは，オプション（サブコマンド）を使用することで適切な動作を実行することが可能になる．例えばgitコマンドはオプションなしでは意味をなさない．オプションでどのような動作をするかが決まるので，オプションを入力することで正常に動作するのである．\n",
+    "\n",
+    "そもそも，オプションにはショートオプションとロングオプションの２種類がある．ショートオプションはハイフンの後に英字１字を付けた形式のもので，-aや-vなどといったものがショートオプションである．また，ショートオプションは２つ以上のオプションを１つにまとめて実行することもできる．例えば，-l，-a，-tの３つのオプションを１つにまとめて-latとして実行することが可能である．それに対してロングオプションは，ハイフン２つの後に英字２字以上を付けることができる形式である．例えば--allや--versionなどである．ロングオプションは英字を２字以上使用することができるので，どのようなオプションであるかを明確にするために一般的にフルワードが採用されている．--no-の形にすることで否定形のオプションを作成することも可能である．ロングオプションはショートオプションのように複数のオプションを１つにまとめることは不可能であり，１つ１つをスペースで区切る必要がある．\n",
+    "\n",
+    "ショートオプションを設定する際，英字１文字しか使用することができないので基本的には対応づけられたロングオプション（そのオプションがどのような動作を行うのかを表す単語）の頭文字であることが多く，慣れている人であればショートオプションを使うことで素早くアプリケーションを動かすことが可能である．しかし，用いるアプリが１つであるとは限らないし，全てのアプリのショートオプションを統一するのも困難である．またinitialとinstallなど，頭文字が重複してしまう２つのオプションがある場合，-iというショートオプションがinitialを意味するのかinstallを意味するのかを判断するのは，初心者には容易ではなく，混乱を引き起こしかねない．そのため，ヒューマンエラーを引き起こしてしまったり，学習コストがかかってしまったりすることがある．\n",
+    "\n",
+    "ショートオプションの場合，複数のオプションを一つにまとめることができると記述したが，これは引数を必要としないオプションの場合である．引数を必要とするオプションの場合，２文字目以降の英字は引数扱いになってしまう．例えば上に示した-latにおいて，-lが引数を必要とするオプションであれば，-latはatという引数が与えられた-lという風に解釈されてしまうので注意が必要である．そういった点においてもショートオプションは初心者にとって扱いにくい形式であると言える．\n",
+    "\n",
+    "Command line applicationのオプションの記述方法には幾つもの流儀があるようで\n",
+    "何らかの標準があるわけではない．\n",
+    "しかし，それら全てに対応することはできず，なんらかの\n",
+    "基準に従ってオプション記法を解釈する必要がある．\n",
+    "\n",
+    "ここでは，\n",
+    "\"Build awesome command-line application in ruby 2\"に従って\n",
+    "オプション記法と用語をまとめておく．\n",
+    "\n",
+    "コマンドラインの基本形は，\n",
+    "\n",
+    "> ls -lat dir_name\n",
+    "\n",
+    "というように\n",
+    "\n",
+    "> executabel options arguments\n",
+    "\n",
+    "での形であった．これは，GNU標準に基本構造が記載されている．\n",
+    "\n",
+    "その後，幾つかのswitchやflagを組み合わせて，複雑な\n",
+    "命令を解釈できるようにするに従って，\n",
+    "\n",
+    "> grep --igonre-case -C 4 \"some string\" /tmp\n",
+    "\n",
+    "などとほぼ呪文のような形態となってきた．\n",
+    "\n",
+    "その後，command line suiteと呼ばれる一群のcommand line applicationが登場した．典型的なのはgitである[5]．\n",
+    "\n",
+    "gitはlinuxのバックアップを分散処理するために，\n",
+    "Linus Torvaldsが開発したものであるが，いくつもの\n",
+    "機能に従ってそれぞれ個別のコマンドが用意されていた．\n",
+    "それぞれ，git-commitとかgit-fetchなどであった．\n",
+    "それがある時，すべてをまとめてsuiteとして\n",
+    "パッケージし直され，1つのまとまったcommandとして提供された．\n",
+    "すなわち，git commitやgit fetchなどである[6]．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# 研究内容"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## thor化に伴う書き換え（具体的な作業）\n",
+    "\n",
+    "optparseからthorへの書き換えの際，第一に必要となるのは，~.gemspecファイル内にThorがインストールされるように変更を加えることである．\n",
+    "\n",
+    "```\n",
+    "spec.add_development_dependency \"thor\"\n",
+    "```\n",
+    "\n",
+    "この記述は，作成しているコマンドラインツールがThorに依存性を持つことを意味している．optparseで書いた場合は，Thorに依存性を持つ必要がなく，当然このような記述はされていないので，上の一文を書き加える必要がある．また，bundle updateをターミナル上で実行することで，ローカルでのコマンドラインツールを実行した際にThorが適用されるようにアップデートされる．そうすることで，Thorの記述が実際にソースファイルで使用できるようになる．\n",
+    "\n",
+    "## thorによるサブコマンド\n",
+    "\n",
+    "次に，コマンドが呼ばれる流れについて説明する．\n",
+    "\n",
+    "1. コマンドを実行する．\n",
+    "1. コマンドを実行すると，exeディレクトリの中にあるコマンド名と同じ名前のファイル（以降コマンドファイルと呼ぶ）が実行される．\n",
+    "1. コマンドファイル内でlibディレクトリ内のソースファイルをrequireしておき，クラス内のコマンドを解析する関数を呼び出す．\n",
+    "1. ソースファイル内に書かれた処理が実行される．\n",
+    "\n",
+    "このような流れでコマンドが呼び出され，処理が行われる．Thorとoptpaseの差異は4.におけるコマンドの解析による処理関数への中継の方法である．\n",
+    "\n",
+    "## exeディレクトリの書き換え\n",
+    "\n",
+    "exeディレクトリの中にあるコマンドファイルについて書き換えを行う．まずはoptparseを使用した際のコマンドファイルの記述を記載する．\n",
+    "\n",
+    "```\n",
+    "!/usr/bin/env ruby                                                                                                               \n",
+    "require \"my_help_opt\"\n",
+    "\n",
+    "MyHelp::Command.run(ARGV)\n",
+    "```\n",
+    "\n",
+    "optparseの場合，MyHelp::Command.run(ARGV)というクラス関数を実行することでコマンドを呼び出している．しかし，Thorはoptparseのようにrun(ARGV)を用いず，start(ARGV)というクラス関数を実行してコマンドを呼び出す．よって，runをstartに書き換える作業が必要になる．以下にThorを使用した際のコマンドファイルの記述を記載する．\n",
+    "\n",
+    "```\n",
+    "!/usr/bin/env ruby                                                                                                               \n",
+    "require \"my_help_thor\"\n",
+    "\n",
+    "MyHelp::Command.start(ARGV)\n",
+    "```\n",
+    "\n",
+    "## libディレクトリ\n",
+    "\n",
+    "まず，self.runについてであるが，Thorでは使用されないのでこの一文は削除する．次にinitializeであるが，こちらについては変更が必要である．そもそもinitializeとはmy_helpを動かすのに必要なディレクトリがあるかどうかを調べるメソッドであり，なければここで作ることができる．optparseのinitializeではargv=[]となっているところをThorでは（アスタリスク）argvとする必要がある．また，大きな違いはsuperの有無である．optparseではsuperは必要ないのだが，Thorでは必要になる．これは，\n",
+    "\n",
+    "## その他オプション\n",
+    "\n",
+    "optparseではコマンド実行の際，引数の解析を行い，その引数に合わせた関数を呼び出す，という手順で動作している．その手順を記述した関数がexecuteである．\n",
+    "\n",
+    "```\n",
+    "def execute\n",
+    "      @argv << '--help' if @argv.size==0\n",
+    "      command_parser = OptionParser.new do |opt|\n",
+    "        opt.on('-v', '--version','show program Version.') { |v|\n",
+    "          opt.version = MyHelp::VERSION\n",
+    "          puts opt.ver\n",
+    "        }\n",
+    "        \n",
+    "        opt.on('-l', '--list', 'list specific helps'){list_helps}\n",
+    "        opt.on('-e NAME', '--edit NAME', 'edit NAME help(eg test_help)'){|file| edit_help(file)}\n",
+    "        opt.on('-i NAME', '--init NAME', 'initialize NAME help(eg test_help).'){|file| init_help(file)}\n",
+    "        opt.on('-m', '--make', 'make executables for all helps.'){make_help}\n",
+    "        opt.on('-c', '--clean', 'clean up exe dir.'){clean_exe}\n",
+    "        opt.on('--install_local','install local after edit helps'){install_local}\n",
+    "        opt.on('--delete NAME','delete NAME help'){|file| delete_help(file)}\n",
+    "      end\n",
+    "      \n",
+    "      begin\n",
+    "        command_parser.parse!(@argv)\n",
+    "      rescue=> eval\n",
+    "        p eval\n",
+    "      end\n",
+    "      exit\n",
+    "end\n",
+    "```\n",
+    "\n",
+    "しかしThorの場合，executeのような間を取り持つ関数を用意する必要がなく，関数自体をコマンドとして登録していく形をとっているので，この関数は不必要である．以下にThorでの関数宣言を記載する．optparseno場合，-iというコマンドで呼び出されている処理をinitというコマンドで呼び出されるように書き換えたのが以下の関数である．\n",
+    "\n",
+    "```\n",
+    "desc 'init NAME, --init NAME', 'initialize NAME help(eg test_help).'\n",
+    " 関数についての説明，ここがヘルプで表示される．\n",
+    "map \"--init\" => \"init\"\n",
+    " --オプションでも呼び出すことが可能．\n",
+    "def init(file)\n",
+    "以下は変更なし\n",
+    "    p target_help=File.join(@local_help_dir,file)\n",
+    "    if File::exists?(target_help)\n",
+    "        puts \"File exists. rm it first to initialize it.\"\n",
+    "        exit\n",
+    "    end\n",
+    "    p template = File.join(@default_help_dir,'template_help')\n",
+    "    FileUtils::Verbose.cp(template,target_help)\n",
+    "end\n",
+    "```\n",
+    "\n",
+    "このように書き換えることで，Thorを使用したオプションの設定を行うことができるのだが，実際に動かしてみるとエラーが表示されることがある．ここで表示されるエラーは，コマンドとして設定されていない関数があることについての警告文である．その関数はコマンドとして使用しないということを明確に記述することでこの警告を消すことが可能である．\n",
+    "\n",
+    "```\n",
+    "no_commands do\n",
+    "\n",
+    "    この間にコマンド設定しない関数を記述\n",
+    "\n",
+    "end\n",
+    "```\n",
+    "\n",
+    "## オプションの比較\n",
+    "\n",
+    "オプションを省略記法から自然言語に近い記法に変更したことでより直感的なコマンド入力が可能になると思われる．\n",
+    "\n",
+    "### optparse版\n",
+    "\n",
+    "Usage: my_help [options] \n",
+    "\n",
+    "-v, --version show program Version.\n",
+    "\n",
+    "-l, --list 個別(specific)ヘルプのList表示.\n",
+    "\n",
+    "-e, --edit NAME NAME(例：test_help)をEdit編集. \n",
+    "\n",
+    "-i, --init NAME NAME(例：test_help)のtemplateを作成. \n",
+    "\n",
+    "-m, --make make executables for all helps. \n",
+    "\n",
+    "-c, --clean clean up exe dir. \n",
+    "\n",
+    "--install_local install local after edit helps \n",
+    "\n",
+    "--delete NAME delete NAME help\n",
+    "\n",
+    "### thor版\n",
+    "\n",
+    "Commands:\n",
+    "\n",
+    "  my_help clean, --clean                   clean up exe dir.\n",
+    "  \n",
+    "  my_help delete NAME, --delete NAME       delete NAME help\n",
+    "  \n",
+    "  my_help edit NAME, --edit NAME           edit NAME help(eg test_help)\n",
+    "  \n",
+    "  my_help help [COMMAND]                   Describe available commands or one specific command\n",
+    "  \n",
+    "  my_help init NAME, --init NAME           initialize NAME help(eg test_help).\n",
+    "  \n",
+    "  my_help install_local, --install_local   install local after edit helps\n",
+    "  \n",
+    "  my_help list, --list                     list specific helps\n",
+    "  \n",
+    "  my_help make, --make                     make executables for all helps.\n",
+    "  \n",
+    "  my_help version, -v                      show program version"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# 総括\n",
+    "\n",
+    "今回の研究では，ユーザメモソフトであるmy helpのthorによる書き換えを行った．この書き換えによる成果は以下の通りである．\n",
+    "\n",
+    "1. オプションの記法を-（ハイフン）を用いた省略記法からフルワードを用いた自然言語に近い記法に変更した．これにより，初心者でも直感的にオプションを使用することができ，学習コストの削減，学習効率の向上に繋がると考えられる．\n",
+    "\n",
+    "1. thorを用いることによってoptparseを用いた時よりもソースコードを短くすることに成功した．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": true
+   },
+   "source": [
+    "# 謝辞\n",
+    "\n",
+    "本研究を行うにあたって，終始多大なるご指導，ご鞭撻を頂いた関西学院大学理工学部情報科学科西谷滋人教授に対し，深く御礼申し上げます．また，本研究の進行に伴い，様々な助力，協力をして頂きました西谷研究室の先輩方，同輩達に心から感謝いたします．西谷研究室の益々のご発展，ご多幸を心よりお祈り申し上げます．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# 参考文献\n",
+    "\n",
+    "[1] library optparse, https://docs.ruby-lang.org/ja/latest/library/optparse.html accessed 2018.2.9.\n",
+    "\n",
+    "[2] コマンドライン引数によるオプションに対応する (optparse), http://maku77.github.io/ruby/io/optparse.html accessed 2018.2.1.\n",
+    "\n",
+    "[3] S.Koichiro, Thorの使い方まとめ, https://qiita.com/succi0303/items/32560103190436c9435b accessed 2018.2.9.\n",
+    "\n",
+    "[4] Thorで簡単にコマンドラインアプリをつくる, http://note.hibariya.org/entries/20111025/a0.html 2018.2.9.\n",
+    "\n",
+    "[5] David Bryant Copeland, Build Awesome Command-Line Applications in Ruby 2, (Pragmatic Bookshelf, 2013), pp.14-5.\n",
+    "\n",
+    "[6] David Bryant Copeland, Build Awesome Command-Line Applications in Ruby 2, (Pragmatic Bookshelf, 2013), p.16."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Ruby 2.3.3",
+   "language": "ruby",
+   "name": "ruby"
+  },
+  "language_info": {
+   "file_extension": ".rb",
+   "mimetype": "application/x-ruby",
+   "name": "ruby",
+   "version": "2.3.3"
+  },
+  "latex_envs": {
+   "LaTeX_envs_menu_present": true,
+   "autocomplete": true,
+   "bibliofile": "biblio.bib",
+   "cite_by": "apalike",
+   "current_citInitial": 1,
+   "eqLabelWithNumbers": true,
+   "eqNumInitial": 1,
+   "hotkeys": {
+    "equation": "Ctrl-E",
+    "itemize": "Ctrl-I"
+   },
+   "labels_anchors": false,
+   "latex_user_defs": false,
+   "report_style_numbering": false,
+   "user_envs_cfg": false
+  },
+  "toc": {
+   "nav_menu": {},
+   "number_sections": true,
+   "sideBar": true,
+   "skip_h1_title": false,
+   "toc_cell": true,
+   "toc_position": {
+    "height": "529px",
+    "left": "0px",
+    "right": "926.2000122070313px",
+    "top": "106px",
+    "width": "152px"
+   },
+   "toc_section_display": "block",
+   "toc_window_display": false
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}