今までダラダラとRubyスクリプトを書いてきたのだけど、書いたあとにスクリプトを見直しても使い方が分からなくなったりしている。ということで、ドキュメントを書かなきゃと思いましたのです。
あと、ダラダラと書いて、でも動かないので直したら余計に動かない、というのをやめて、TDD(Test Driven Development)をやってみようと。
YARD
RD→RDoc→YARDと進化してきたRubyドキュメント作成環境第三世代(と思ってる)。
YARD - A Ruby Documentation Tool
インストール
$ gem install yard Fetching: yard-0.8.7.gem (100%) Successfully installed yard-0.8.7 1 gem installed Installing YARD documentation for yard-0.8.7...
RSpec
(RubyUnit→)Test::Unit→RSpecと変わってきた、TDD環境(正確には違うけど)。というかBDD(Behaviour Driven Development)環境。
いまのRSpecは、rspec-core、rspec-mocks、rspec-expectationsから構成されているらしい。
インストール
$ gem install rspec Fetching: rspec-core-2.14.5.gem (100%) Fetching: diff-lcs-1.2.4.gem (100%) Fetching: rspec-expectations-2.14.2.gem (100%) Fetching: rspec-mocks-2.14.3.gem (100%) Fetching: rspec-2.14.1.gem (100%) Successfully installed rspec-core-2.14.5 Successfully installed diff-lcs-1.2.4 Successfully installed rspec-expectations-2.14.2 Successfully installed rspec-mocks-2.14.3 Successfully installed rspec-2.14.1 5 gems installed Installing ri documentation for rspec-core-2.14.5... Building YARD (yri) index for rspec-core-2.14.5... Installing ri documentation for diff-lcs-1.2.4... Building YARD (yri) index for diff-lcs-1.2.4... Installing ri documentation for rspec-expectations-2.14.2... Building YARD (yri) index for rspec-expectations-2.14.2... Installing ri documentation for rspec-mocks-2.14.3... Building YARD (yri) index for rspec-mocks-2.14.3... Installing ri documentation for rspec-2.14.1... Building YARD (yri) index for rspec-2.14.1... Installing RDoc documentation for rspec-core-2.14.5... Installing RDoc documentation for diff-lcs-1.2.4... Installing RDoc documentation for rspec-expectations-2.14.2... Installing RDoc documentation for rspec-mocks-2.14.3... Installing RDoc documentation for rspec-2.14.1...