まずgithub pagesでサイトを作った。

args_parser for Ruby
くわしくは上を見ればわかる。


アップデート内容

コマンドライン引数をparseした後に、validationやfilterをかけれるようになった。
parser側で入力値がチェックできるので、アプリ側でめんどうくさい処理をしなくて済む。

parseスタイルが増えた。
% rackup config.ru --port 5000 --env development
のような–key valueの他に、
% gem install twitter --version=3.7.0
みたいなイコールでつなぐスタイルも選択できる。
自分でスタイルを追加する事もできるようになってる。

順に解説する。

Validator / Filter

filterとvalidatorを追加した。こう書く。


require 'args_parser'

parser = ArgsParser.parse ARGV do

  arg :url, 'URL', :alias => :u, :default => "http://shokai.org"

  arg :help, 'show help', :alias => :h



  filter :url do |v|

    v.to_s.strip

  end



  validate :url, "invalid URL" do |v|

    v =~ /^https?:\/\/.+$/

  end

end
parse後にvalidateブロックが走って引数がチェックされる。
上の例だと引数 –url が正規表現に合わない時にエラーを起こす。


filterは、文字列を小文字にするとか、小数だったら整数に丸めるみたいな下準備に使う。
validateとfilterは何個でも書ける。


validator内のエラーはデフォルトでは
Error: invalid URL (--url hasadfttp://shokai.org)
がSTDERRに表示されて、exit 1される。


これはon_validate_error や on_filter_error を書いておけば横取りできる。exit 1されたくない時にどうぞ。


require 'args_parser'

parser = ArgsParser.parse ARGV do

  arg :url, 'URL', :alias => :u, :default => "http://shokai.org"

  arg :help, 'show help', :alias => :h



  filter :url do |v|

    v.to_s.strip

  end



  on_filter_error do |err, name, value|

    STDERR.puts "filter error : #{err.class} #{name}=#{value}"

  end



  validate :url, "invalid URL" do |v|

    v =~ /^https?:\/\/.+$/

  end



  on_validate_error do |err, name, value|

    STDERR.puts "validate error : #{err.class} #{name}=#{value}"

  end

end

横取り結果
validate error : ArgsParser::ValidationError url=hasadfttp://shokai.org


Style

ArgsParser#parseを呼び出す部分、ブロックしか渡さないと:defaultのstyleが使われる。


parser = ArgsParser.parse ARGV do
しかしコレだとハイフンが頭に付く文字列を引数として渡せない（負の数とか）
そういう時は別のスタイルを選べる。

:style => :equalを渡すとスタイルが変わる。


parser = ArgsParser.parse ARGV, :style => :equal do

2種類のスタイルは
https://github.com/shokai/args_parser/tree/master/lib/args_parser/styles
に入っている。

自分でスタイルを作るときは、parse_style_スタイル名(argv)を定義したArgsParser::Parserを読み込んでからArgsParser#parseを呼べばいい。