hikiutils 0.2.3.8 → 0.2.3.9

data/hikiutils_yamane/clidescription.hiki

@@ -1,35 +0,0 @@
-{{toc}}
-//!CLIのコード
-hikiutilsのコマンドライン解析ツールをoptparseからthorに換えることでコマンドの書き換えを行うことができた．
-また，thorで書かれたhikiutilsはoptparseで書かれたものよりもコードが短くなり，コマンドの解析も簡単に行えることができた．
-ここではthorとoptparseのコードを比較しthorの良さを確認する．
-!CLIの解説
-!!Thor
-Thorとは，コマンドラインツールの作成を支援するライブラリのことである．
-gitやbundlerのようにサブコマンドを含むコマンドラインツールを簡単に作成することができる[1-2]．
-
-Thorの基本的な流れとしては
-
-#Thorを継承したクラスのパブリックメソッドがコマンドになる
-#クラス.start(ARGV)でコマンドラインの処理をスタートする
-という流れである[1-2].
-
-startに渡す引数が空の場合，Thorはクラスのヘルプリストを出力する．
-また，Thorはサブコマンドやサブサブコマンドも作ることができる．
-!!optparse
-optparseとは，getoptよりも簡便で，柔軟性に富み，かつ強力なコマンドライン解析ライブラリである．
-optparseでは，より宣言的なスタイルのコマンドライン解析手法，すなわちOptionParserのインスタンスでコマンドラインを解析するという手法をとっている．
-これを使うと，GNU/POSIX構文でオプションを指定できるだけでなく，使用法やヘルプメッセージの生成も行える[1-3]．
-
-利用頻度はあまり高くないが古くから開発され，使用例が広く紹介されている．
-
-optparseの基本的な流れとしては
-
-#OptionParserオブジェクトoptを生成する
-#オプションを取り扱うブロックをopt.onに登録する
-#opt.parse(ARGV)でコマンドラインを実際にparseする
-という流れである.
-
-OptionParserはコマンドラインのオプション取り扱うためのクラスであるためオブジェクトoptを生成されopt.onにコマンドを登録することができる．
-しかし，OptionParser\#onにはコマンドが登録されているだけであるため，OptionParser\#parseが呼ばれた時，コマンドラインにオプションが指定されていれば実行される．
-optparseにはデフォルトとして--helpと--versionオプションを認識する[1-4].

data/hikiutils_yamane/code.hiki

@@ -1,285 +0,0 @@
-{{toc}}
-!Thorの初期化                                                      
-{{attach_view(hikiutils_yamane_09_copy.003.jpg,hikiutils_yamane)}}
-*Thorのinitializeでのコード
-#Hikithor::CLI.start(ARGV)が呼ばれる
-#initializeメソッドが呼ばれる
-#これではThorのinitializeメソッドが呼ばれない
-#superを書くことでThorのinitializeメソッドが呼ばれる
-optparseではrequireでoptparseを呼びoptparseのinitializeを定義する必要はないが，Thorはinitializeを定義する必要がある．
-Thorの定義方法はrequireでThorを呼びCLIクラスで継承し，initializeメソッドにsuperを書くことでThorのinitializeが呼ばれる．
-initializeメソッド内ではThorの初期設定がされていないため，スーパークラスのメソッドを読み出してくれるsuperを書き加えることで図のようにinitializeメソッド内でThorのinitilalizeメソッドが
-呼ばれ定義される．
-!!コード
-<<< ruby
-# -*- coding: utf-8 -*-                                                         
-require 'thor'
-require 'kconv'
-require 'hikidoc'
-require 'erb'
-require "hikiutils/version"
-require "hikiutils/tmarshal"
-require "hikiutils/infodb"
-require 'systemu'
-require 'fileutils'
-require 'yaml'
-require 'pp'
-
-module Hikithor
-
-  DATA_FILE=File.join(ENV['HOME'],'.hikirc')
-  attr_accessor :src, :target, :editor_command, :browser, :data_name, :l_dir
-
-  class CLI < Thor
-   def initialize(*args)
-      super
-      @data_name=['nick_name','local_dir','local_uri','global_dir','global_uri']
-      data_path = File.join(ENV['HOME'], '.hikirc')
-      DataFiles.prepare(data_path)
-
-      file = File.open(DATA_FILE,'r')
-      @src = YAML.load(file.read)
-      file.close
-      @target = @src[:target]
-      @l_dir=@src[:srcs][@target][:local_dir]
-      browser = @src[:browser]
-      @browser = (browser==nil) ? 'firefox' : browser
-      p editor_command = @src[:editor_command]
-      @editor_command = (editor_command==nil) ? 'open -a mi' : editor_command
-   end
->>>
-!コマンド表示と処理
-!!Thor
-{{attach_view(hikiutils_yamane_09_copy.004.jpg,hikiutils_yamane)}}
-#コマンド名，コマンドの説明を一覧に表示させる
-#パブリックメソッドのコマンドを別のコマンド名でも実行できるようにする
-#コマンドの命令の実行コード
-Thorではdescで一覧を表示させるコマンド名，コマンドの説明を登録する．しかし，ここで記述したコマンドは一覧で表示させるものであり，実行されることはないので実際のコマンドと対応させる必要がある．
-Thorでは処理実行を行うメソッドがコマンドとなる．しかし，それではコマンド名は１つしか使うことができない．
-ここで用いるものがmapである．
-<<<
-map A => B
->>>
-mapとはBでしか読めないものをAでも読めるようにしてくれるものである.
-よって，これを使うことで別のコマンドも指定することができる．
-!!optparse
-{{attach_view(hikiutils_yamane_09_copy.005.jpg,hikiutils_yamane)}}
-#OptionParserオブジェクトoptを生成
-#optにコマンドを登録
-#入力されたコマンドの処理のメソッドへ移動
-optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけで
-コマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録された
-コマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録は
-また別の手段でやらなくてはいけない．
-以上より，Thorではコマンドの指定と処理にはdesc,map,処理メソッドだけで済むが，optparseではコマンドを登録するためのメソッドと処理メソッドが必要になってくる．
-また，コマンドはThorでは処理メソッドがコマンド名になるが，optparseではコマンドを登録するための処理も必要となってくる．
-
-!!コード
-*Thor
-<<< ruby
-    desc 'show,--show', 'show sources'
-    map "--show" => "show"
-    def show
-      printf("target_no:%i\n",@src[:target])
-      printf("editor_command:%s\n",@src[:editor_command])
-      @i_size,@n_size,@l_size,@g_size=3,5,30,15 #i,g_size are fixed             
-      n_l,l_l=0,0
-      @src[:srcs].each_with_index{|src,i|
-        n_l =(n_l= src[:nick_name].length)>@n_size? n_l:@n_size
-        l_l =(l_l= src[:local_dir].length)>@l_size? l_l:@l_size
-      }
-      @n_size,@l_size=n_l,l_l
-      command = Command.new
-      header = command.display_format('id','name','local directory','global uri',@i_size,@n_size,@l_size,@g_size)
-
-      puts header
-      puts '-' * header.size
-
-      @src[:srcs].each_with_index{|src,i|
-        target = i==@src[:target] ? '*':' '
-        id = target+i.to_s
-        name=src[:nick_name]
-        local=src[:local_dir]
-        global=src[:global_uri]
-        puts command.display_format(id,name,local,global,@i_size,@n_size,@l_size,@g_size)
-      }
-    end
->>>
-*optparse
-<<< ruby 
-    def execute
-      @argv << '--help' if @argv.size==0
-      command_parser = OptionParser.new do |opt|
-        opt.on('-v', '--version','show program Version.') { |v|
-          opt.version = HikiUtils::VERSION
-          puts opt.ver
-        }
-        opt.on('-s', '--show','show sources') {show_sources}
-        opt.on('-a', '--add','add sources info') {add_sources }
-        opt.on('-t', '--target VAL','set target id') {|val| set_target(val)}
-        opt.on('-e', '--edit FILE','open file') {|file| edit_file(file) }
-        opt.on('-l', '--list [FILE]','list files') {|file| list_files(file)}
-        opt.on('-u', '--update FILE','update file') {|file| update_file(file) }
-        opt.on('-r', '--rsync','rsync files') {rsync_files}
-        opt.on('--database FILE','read database file') {|file| db_file(file)}
-        opt.on('--display FILE','display converted hikifile') {|file| display(file)}
-        opt.on('-c', '--checkdb','check database file') {check_db}
-        opt.on('--remove FILE','remove file') {|file| remove_file(file)}
-        opt.on('--move FILES','move file1,file2',Array) {|files| move_file(files)}
-        opt.on('--euc FILE','translate file to euc') {|file| euc_file(file)}
-        opt.on('--initialize','initialize source directory') {dir_init() }
-      end
-      begin
-        command_parser.parse!(@argv)
-      rescue=> eval
-        p eval
-      end
-      dump_sources
-      exit
-    end    
-    
-    def show_sources()
-      printf("target_no:%i\n",@src[:target])
-      printf("editor_command:%s\n",@src[:editor_command])
-      check_display_size()
-      header = display_format('id','name','local directory','global uri')
-
-      puts header
-      puts '-' * header.size
-
-      @src[:srcs].each_with_index{|src,i|
-        target = i==@src[:target] ? '*':' '
-        id = target+i.to_s
-        name=src[:nick_name]
-        local=src[:local_dir]
-        global=src[:global_uri]
-        puts display_format(id,name,local,global)
-      }
-    end
-
-    def add_sources
-      cont = {}
-      @data_name.each{|name|
-        printf("%s ? ", name)
-        tmp = gets.chomp
-        cont[name.to_sym] = tmp
-      }
-      @src[:srcs] << cont
-      show_sources
-    end
->>>
-!CLIの実行
-!!Thor
-{{attach_view(hikiutils_yamane_09_copy.006.jpg,hikiutils_yamane)}}
-*実行手順
-
-#hiki_thorのHikithor::CLI.start(ARGV)でhikiutils_thor.rbのCLIクラスを呼ぶ
-#hikiutils_thor.rbのCLIクラスのメソッドを順に実行していく
-
-Thorではstart(ARGV)を呼び出すことでCLIを開始する．Hikithor::CLI.start(ARGV)を実行されることによりrequireで呼ばれているhikiutils_thor.rbのCLIコマンドを順に実行する．
-そして，入力されたコマンドと一致するメソッドを探し，そのコマンドの処理が実行される．
-!!optparse
-{{attach_view(hikiutils_yamane_09_copy.007.jpg,hikiutils_yamane)}}
-*実行手順
-
-#HikiのHikiUtils::Command.run(ARGV)でhikiutils.rbのrunメソッドを呼ぶ
-#new(argv).executeでexecuteメソッドが実行される
-一方，optparseではHikiutils::Command.run(ARGV)を実行される．requireで呼び出されたhikiutils.rbでrunメソッドが実行される．
-そこでコマンドを登録しているexecuteメソッドへ移動し入力したコマンドと対応させる．そして，対応したコマンドの処理が行われるメソッドに移動することで実行される．
-このようにoptparseでは実行を行うためのメソッドが必要であるが，Thorではクラスのメソッドを順に実行していくため
-runメソッドとexecuteメソッドは必要ない．また，optparseでの実行手順はメソッドの移動回数が多く複雑であるが，Thorは単純で分かりやすいものとなっている．
-!!コード
-*Thor
-<<< ruby
-#!/usr/bin/env ruby                                                             
-
-require "hikiutils_thor"
-
-Hikithor::CLI.start(ARGV)
->>>
-<<< ruby
-# -*- coding: utf-8 -*-                                                         
-require 'thor'
-require 'kconv'
-require 'hikidoc'
-require 'erb'
-require "hikiutils/version"
-require "hikiutils/tmarshal"
-require "hikiutils/infodb"
-require 'systemu'
-require 'fileutils'
-require 'yaml'
-require 'pp'
-
-module Hikithor
-
-  DATA_FILE=File.join(ENV['HOME'],'.hikirc')
-  attr_accessor :src, :target, :editor_command, :browser, :data_name, :l_dir
-
-  class CLI < Thor
-   def initialize(*args)
-      super
-      @data_name=['nick_name','local_dir','local_uri','global_dir','global_uri']
-      data_path = File.join(ENV['HOME'], '.hikirc')
-      DataFiles.prepare(data_path)
-
-      file = File.open(DATA_FILE,'r')
-      @src = YAML.load(file.read)
-      file.close
-      @target = @src[:target]
-      @l_dir=@src[:srcs][@target][:local_dir]
-      browser = @src[:browser]
-      @browser = (browser==nil) ? 'firefox' : browser
-
->>>
-*optparse
-<<< ruby
-#!/usr/bin/env ruby                                                             
-
-require "hikiutils"
-
-HikiUtils::Command.run(ARGV)
->>>
-<<< ruby
-    def self.run(argv=[])
-      print "hikiutils: provide utilities for helping hiki editing.\n"
-      new(argv).execute
-    end
-
-    def execute
-      @argv << '--help' if @argv.size==0
-      command_parser = OptionParser.new do |opt|
-        opt.on('-v', '--version','show program Version.') { |v|
-          opt.version = HikiUtils::VERSION
-          puts opt.ver
-        }
-        opt.on('-s', '--show','show sources') {show_sources}
-        opt.on('-a', '--add','add sources info') {add_sources }
-        opt.on('-t', '--target VAL','set target id') {|val| set_target(val) }
-        opt.on('-e', '--edit FILE','open file') {|file| edit_file(file) }
-        opt.on('-l', '--list [FILE]','list files') {|file| list_files(file) }
-        opt.on('-u', '--update FILE','update file') {|file| update_file(file) }
-        opt.on('-r', '--rsync','rsync files') {rsync_files}
-        opt.on('--database FILE','read database file') {|file| db_file(file)}
-        opt.on('--display FILE','display converted hikifile') {|file| display(f\
-ile)}
-        opt.on('-c', '--checkdb','check database file') {check_db}
-        opt.on('--remove FILE','remove file') {|file| remove_file(file)}
-        opt.on('--move FILES','move file1,file2',Array) {|files| move_file(file\
-s)}
-        opt.on('--euc FILE','translate file to euc') {|file| euc_file(file) }
-        opt.on('--initialize','initialize source directory') {dir_init() }
-      end
-      begin
-        command_parser.parse!(@argv)
-      rescue=> eval
-        p eval
-      end
-      dump_sources
-      exit
-    end  
->>>
-コードからもThorのほうが短くなっていることが分かる．
-よって，Thorとoptparseでのコードの違いは以上の部分になるが全体的にもThorのほうがコードが短くなり，
-コマンドの定義も簡単に行うことができる．また，実行手順も分かりやすくコードが読みやすいため書き換えもすぐ行うことが
-できるので，より直感的なコマンドを実装することも可能となった．

data/hikiutils_yamane/command_table.hiki

@@ -1,19 +0,0 @@
-!コマンド名の検討
-bashあるいはtcshなどのshellコマンドの振る舞いに似た振る舞いをするコマンドはおなじ名前を振るべきと考えられる．そこで，次のように検討を加える．
-
-||現在のcommand||変える？||検討内容
-||add             || ||  add sources info
-||checkdb         || ||  check database file
-||datebase FILE   || ||  read datebase file
-||display FILE    ||?||  display converted hikifile
-||edit FILE       ||open||  open file
-||euc FILE        || ||  translate file to euc
-||help [COMMAND]  || ||  Describe available commands or one specific command
-||list [FILE]     ||ls||  list files
-||move [FILE]     ||mv|  move file
-||remove [FILE]   ||rm||  remove files
-||rsync           || ||  rsync files
-||show            ||??||lsとかぶる．
-||target VAL      ||cd||  set target id
-||update FILE     ||touch||  update file
-||version         || ||  show program version

data/hikiutils_yamane/latex_dir/clidescription.aux

@@ -1,24 +0,0 @@
-\relax 
-\@writefile{toc}{\contentsline {subsection}{\numberline {4.4}CLIの解説}{12}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.4.1}Thor}{12}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.4.2}optparse}{12}}
-\@setckpt{clidescription}{
-\setcounter{page}{14}
-\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}{4}
-\setcounter{subsubsection}{2}
-\setcounter{paragraph}{0}
-\setcounter{subparagraph}{0}
-\setcounter{figure}{2}
-\setcounter{table}{1}
-\setcounter{lstnumber}{12}
-\setcounter{lstlisting}{0}
-}

data/hikiutils_yamane/latex_dir/clidescription.tex

@@ -1,41 +0,0 @@
-\verb|{{toc}}|
-hikiutilsのコマンドライン解析ツールをoptparseからthorに換えることでコマンドの書き換えを行うことができた．
-また，thorで書かれたhikiutilsはoptparseで書かれたものよりもコードが短くなり，コマンドの解析も簡単に行えることができた．
-ここではthorとoptparseのコードを比較しthorの良さを確認する．
-
-\subsection{CLIの解説}
-\subsubsection{Thor}
-Thorとは，コマンドラインツールの作成を支援するライブラリのことである．
-gitやbundlerのようにサブコマンドを含むコマンドラインツールを簡単に作成することができる[1-2]．
-
-Thorの基本的な流れとしては
-
-\begin{enumerate}
-\item Thorを継承したクラスのパブリックメソッドがコマンドになる
-\item クラス.start(ARGV)でコマンドラインの処理をスタートする
-\end{enumerate}
-という流れである[1-2].
-
-startに渡す引数が空の場合，Thorはクラスのヘルプリストを出力する．
-また，Thorはサブコマンドやサブサブコマンドも作ることができる．
-
-\subsubsection{optparse}
-optparseとは，getoptよりも簡便で，柔軟性に富み，かつ強力なコマンドライン解析ライブラリである．
-optparseでは，より宣言的なスタイルのコマンドライン解析手法，すなわちOptionParserのインスタンスでコマンドラインを解析するという手法をとっている．
-これを使うと，GNU/POSIX構文でオプションを指定できるだけでなく，使用法やヘルプメッセージの生成も行える[1-3]．
-
-利用頻度はあまり高くないが古くから開発され，使用例が広く紹介されている．
-
-optparseの基本的な流れとしては
-
-\begin{enumerate}
-\item OptionParserオブジェクトoptを生成する
-\item オプションを取り扱うブロックをopt.onに登録する
-\item opt.parse(ARGV)でコマンドラインを実際にparseする
-\end{enumerate}
-という流れである.
-
-OptionParserはコマンドラインのオプション取り扱うためのクラスであるためオブジェクトoptを生成されopt.onにコマンドを登録することができる．
-しかし，OptionParser\#onにはコマンドが登録されているだけであるため，OptionParser\#parseが呼ばれた時，コマンドラインにオプションが指定されていれば実行される．
-optparseにはデフォルトとして--helpと--versionオプションを認識する[1-4].
-

data/hikiutils_yamane/latex_dir/code.aux

@@ -1,41 +0,0 @@
-\relax 
-\@writefile{toc}{\contentsline {subsection}{\numberline {4.5}Thorの初期化}{14}}
-\@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces }}{14}}
-\newlabel{default}{{3}{14}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.5.1}コード}{14}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {4.6}コマンド表示と処理}{15}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.1}Thor}{15}}
-\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces }}{16}}
-\newlabel{default}{{4}{16}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.2}optparse}{16}}
-\@writefile{lof}{\contentsline {figure}{\numberline {5}{\ignorespaces }}{17}}
-\newlabel{default}{{5}{17}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.3}コード}{17}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {4.7}CLIの実行}{20}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.1}Thor}{20}}
-\@writefile{lof}{\contentsline {figure}{\numberline {6}{\ignorespaces }}{20}}
-\newlabel{default}{{6}{20}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.2}optparse}{20}}
-\@writefile{lof}{\contentsline {figure}{\numberline {7}{\ignorespaces }}{21}}
-\newlabel{default}{{7}{21}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.3}コード}{21}}
-\@setckpt{code}{
-\setcounter{page}{25}
-\setcounter{equation}{0}
-\setcounter{enumi}{2}
-\setcounter{enumii}{0}
-\setcounter{enumiii}{0}
-\setcounter{enumiv}{0}
-\setcounter{footnote}{0}
-\setcounter{mpfootnote}{0}
-\setcounter{part}{0}
-\setcounter{section}{4}
-\setcounter{subsection}{7}
-\setcounter{subsubsection}{3}
-\setcounter{paragraph}{0}
-\setcounter{subparagraph}{0}
-\setcounter{figure}{7}
-\setcounter{table}{1}
-\setcounter{lstnumber}{38}
-\setcounter{lstlisting}{0}
-}