Hatena::ブログ(Diary)

いたさんの日記

2010-09-24

Rails3で自分専用のブログを作る(17) ─ featureを日本語化する

Cucumberのfeatureを日本語で記述したいので、web_steps.rbを日本語化するweb_ja_steps.rbを作成しました。翻訳はid:moroさんのmoro-misoを参考にしました。

# coding: UTF-8
Given /^"([^\"]*)"ページを表示している$/ do |page_name|
  Given /^I am on #{page_name}$/
end

When /^"([^\"]*)"ページを表示する$/ do |page_name|
  When /^(?:|I )go to #{page_name}$/
end

When /^(?:"([^\"]*)"の)?"([^\"]*)"ボタンをクリックする$/ do |selector ,button|
  When /^(?:|I )press "#{button}"(?: within "#{selector}")?$/
end

When /^(?:"([^\"]*)"の)?"([^\"]*)"リンクをクリックする$/ do |selector, link|
  When /^(?:|I )follow "#{link}"(?: within "#{selector}")?$/
end

When /^(?:"([^\"]*)"の)?"([^\"]*)""([^\"]*)"と入力する$/ do |selector, field, value|
  When /^(?:|I )fill in "#{field}" with "#{value}"(?: within "#{selector}")?$/
end

#When /^(?:|I )fill in "([^"]*)" for "([^"]*)"(?: within "([^"]*)")?$/ do |value, field, selector|
#  with_scope(selector) do
#    fill_in(field, :with => value)
#  end
#end

# Use this to fill in an entire form with data from a table. Example:
#
#   When I fill in the following:
#     | Account Number | 5002       |
#     | Expiry date    | 2009-11-01 |
#     | Note           | Nice guy   |
#     | Wants Email?   |            |
#
# TODO: Add support for checkbox, select og option
# based on naming conventions.
#
When /^(?:"([^\"]*)"の中に)?以下の項目を入力する:$/ do |selector, fields|
  When /^(?:|I )fill in the following(?: within "#{selector}")?:$/
end

When /^(?:"([^\"]*)"の)?"([^\"]*)"から"([^\"]*)"を選択する$/ do |selector, field, value|
  When /^(?:|I )select "#{value}" from "#{field}"(?: within "#{selector}")?$/
end

When /^(?:"([^\"]*)"の)?"([^\"]*)"をチェックする$/ do |selector, field|
  When /^(?:|I )check "#{field}"(?: within "#{selector}")?$/
end

When /^(?:"([^\"]*)"の中の)?"([^\"]*)"のチェックを外す$/ do |selector, field|
  When /^(?:|I )uncheck "#{field}"(?: within "#{selector}")?$/
end

When /^(?:"([^\"]*)"の中の)?"([^\"]*)"を選択する$/ do |selector, field|
  When /^(?:|I )choose "#{field}"(?: within "#{selector}")?$/
end

When /^(?:"([^\"]*)"の中の)?"([^\"]*)"としてファイル"([^\"]*)"を選択する$/ do |selector, field, path|
  When /^(?:|I )attach the file "#{path}" to "#{field}"(?: within "selector")?$/
end

Then /^次のJSONがえられること:$/ do |expected_json|
  Then /^(?:|I )should see JSON:$/
end

Then /^(?:"([^\"]*)"に)?"([^\"]*)"と表示されていること$/ do |selector, text|
  Then /^(?:|I )should see "#{text}"(?: within "#{selector}")?$/
end

Then /^(?:"([^\"]*)"に)?\/([^\/]*)\/と表示されていること$/ do |selector, regexp|
  Then /^(?:|I )should see \/#{regexp}\/(?: within "#{scope}")?$/
end

Then /^(?:"([^\"]*)"に)?"([^\"]*)"と表示されていないこと$/ do |selector, text|
  Then /^(?:|I )should not see "#{text}"(?: within "#{selector}")?$/
end

Then /^(?:"([^\"]*)"に)?\/([^\/]*)\/と表示されていないこと$/ do |selector, regexp|
  Then /^(?:|I )should not see \/#{regexp}\/(?: within "#{selector}")?$/
end

Then /^(?:"([^\"]*)"の中の)?入力項目"([^\"]*)""([^\"]*)"と表示されていること$/ do |selector, field, value|
  Then /^the "#{field}" field(?: within "#{selector}")? should contain "#{value}"$/
end

Then /^(?:"([^\"]*)"の中の)?入力項目"([^\"]*)""([^\"]*)"と表示されていないこと$/ do |selector, field, value|
  Then /^the "#{field}" field(?: within "#{selector}")? should not contain "#{value}"$/
end

Then /^(?:"([^\"]*)"の中の)?"([^\"]*)"がチェックされていること$/ do |selector, label|
  Then /^the "#{label}" checkbox(?: within "#{selector}")? should be checked$/
end

Then /^(?:"([^\"]*)"の中の)?"([^\"]*)"がチェックされていないこと$/ do |selector, label|
  Then /^the "#{label}" checkbox(?: within "#{selector}")? should not be checked$/
end

Then /^"([^\"]*)"ページを表示していること$/ do |page_name|
  Then /^(?:|I )should be on #{page_name}$/
end

Then /^次のクエリストリングが得られること:$/ do |expected_pairs|
  Then /^(?:|I )should have the following query string:$/
end

Then /^ページを表示する$/ do
  Then /^show me the page$/
end

また、featureジェネレータが作成したarticles_steps.rbにも追記を行いました。

Given /^次の記事があるとき:$/ do |articles|
  Given /^the following articles:$/
end

When /^(\d+)番目の記事を削除する$/ do |pos|
  When /^I delete the #{pos}(?:st|nd|rd|th) article$/
end

Then /^次の記事が表示されること:$/ do |expected_articles_table|
  Then /^I should see the following articles:$/
end

これでfeatureも日本語化できます。manage_articles_ja.featureというファイル名にしました。

# language: ja
フィーチャ: 記事を管理する
  [ゴール]に到達するために
  [ステークホルダ]は
  [振る舞い]が欲しい

  シナリオ: 新しい記事を登録する
    "前提"    "the new article page"ページを表示している
    "もし"    "title 1"に"Title"と入力する
    "かつ"    "body 1"に"Body"と入力する
    "かつ"    "Create"ボタンをクリックする
    "ならば"  "title 1"と表示されていること
    "かつ"    "body 1"と表示されていること

  シナリオ: 記事を削除する
    "前提"    次の記事があるとき:
      |title|body|
      |title 1|body 1|
      |title 2|body 2|
      |title 3|body 3|
      |title 4|body 4|
    "もし"    3番目の記事を削除する
    "ならば"  次の記事が表示されること:
      |Title|Body|
      |title 1|body 1|
      |title 2|body 2|
      |title 4|body 4|

「前提」、「もし」、「ならば」、「かつ」などをダブルクォーテーションで括っているのは、括らないとエラーになるため。以前は引用符なしでも大丈夫だったのですが、Ruby 1.9正規表現の動作(単語の境界の検出)が変わったのが原因かもしれません。それにしても、「フィーチャ」や「シナリオ」が大丈夫なのは変ですがコロンで分離されているからでしょうか。

2010-09-08

Rails3で自分専用のブログを作る(16) ─ RSpecに必要なwebratを追加

rake spec

でspecを実行してみるとhave_tagなどがNoMethodErrorになってしまいます。こうしたセレクタはwebratが持っているものなのでこれを追加する必要がありそうです。

gem install webrat --pre

と実行し、最新のベータ版をインストールしました。

次に、Gemfileに必要なgemとして定義します。本番環境には必要のないものなので、下記の様にグループを定義して、ブロック内に記述しましょう。

group :development, :test do
  gem 'capybara'
  gem 'database_cleaner'
  gem 'cucumber-rails'
  gem 'cucumber'
  gem 'rspec-rails', '2.0.0.beta.20'
  gem 'rspec', '2.0.0.beta.20'
  gem 'spork'
  gem 'launchy'
  gem 'webrat'
end

この後、build install することでエラーが出なくなりました。

2010-09-05

Rails3で自分専用のブログを作る(15) ─ featureとscaffoldをgenerateする

CucumberとRSpecの設定が終わったので、最初の機能であるブログ記事の作成についてのfeatureを生成してみます。Rails 2.xとは構文が変わっていますね。

rails generate cucumber:feature article title:string body:text

英語のmanage_articles.featureが生成された事を確認した後、早速テストを実行してみると、

rake cucumber

当然、いろいろなエラーと失敗がでます。

そこで、とりあえずお決まりのscaffoldを生成してみましょう。

rails generate scaffold article title:string body:text

Rails3ではデータベースは必要になったときに生成されるようなので、migrateを実行。

rake db:migrate

再びcucumberのテストを実行してみます。

rake cucumber

cucumberのfeatureが通るようになったようです。

2010-08-26

Rails3で自分専用のブログを作る(14) ─ Cucumber, RSpecをgenerate

Railsアプリを生成した後、CucumberやRSpecを生成していなかったので、生成する事にします。

まず、cucumber-rails の README を参照すると、Gemfileに下記の追加を行う必要があるらしい。

gem 'capybara'
gem 'database_cleaner'
gem 'cucumber-rails'
gem 'cucumber'
gem 'rspec-rails'
gem 'spork'
gem 'launchy'

これを追記して bundle install を実行します。おっと、nokogiriのインストールでエラーに。libxslt関連のヘッダがないようです。

sudo apt-get install libxslt-dev

を実行してから、再び bundle install で大丈夫になりました。これで、cucumber を生成できます。

ruby script/rails generate cucumber:install --help

でオプションを確認し、次のように生成しました。

ruby script/rails generate cucumber:install --capybara  --rspec

つぎはRSpec です。Gemfileにrspec-railsが登録済なので、次のようにうってみると、

ruby script/rails generate rspec:install

rspec generatorが見つからないとのエラー。調べてみると、Rails 3に対応したRSpecは 2.0ですが、正式リリースはされていません。

gem install rspec-rails --pre

で 2.0.0.beta.20がインストールできました。ただ、このままでbundle install しても、rspecは古いままなので、Gemfileのrspec関係の記述を次のように修正しました。

gem 'rspec-rails', '2.0.0.beta.20'
gem 'rspec', '2.0.0.beta.20'

これでbundle install してから、

ruby script/rails generate rspec:install

これでOKでした。

2010-08-22

Rails3で自分専用のブログを作る(13) ─ データベースを作成

データベースを作成するために、PostgreSQLにユーザーを登録します。

# su postgres
$ createuser DIY-Blog
新しいロールをスーパーユーザとしますか? (y/n) n
新しいロールにデータベース作成権限を与えますか? (y/n) y
新しいロールにロールを作成する権限を与えますか? (y/n) n
$ exit
$ exit

/etc/postgresql/8.4/main/pg_hba.conf を編集しました。

(略)
local   all         DIY-Blog                   trust
local   all         all                               ident
(略)

データベースを生成します。

rake db:create:all

テストしてみましょう。

rails s

http://localhost:3000/ にアクセスしてWelcome画面が表示される事を確認します。

Rails3で自分専用のブログを作る(12) ─ Railsアプリを生成

新しくRailsアプリを生成します。ディレクトリとREADMEを生成済みなので、上書きを指定する -f を指定します。また、テストにはRspecを使用するのでtestディレクトリ以下の生成を抑制する -T スイッチを指定しました。

$ cd ~
$ rails new DIY-Blog -d postgresql -f -T

gitリポジトリに登録しておきます。

$ cd DIY-Blog
$ git add -A
$ git commit -m "rails app generated"

Rails3で自分専用のブログを作る(11) ─ Cucumber と Rspec をインストール

今回の開発はBDDでやってみようと思うので、Cucumber と Rspecインストールします。

Cucumberは、cucumber-railsを指定してインストール

masatoshi@ubuntu:~$ gem install cucumber-rails
Building native extensions.  This could take a while...

(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)

                     (::)   U P G R A D I N G    (::)

Thank you for installing cucumber-0.8.5.
Please be sure to read http://wiki.github.com/aslakhellesoy/cucumber/upgrading
for important information about this release. Happy cuking!

(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)

Successfully installed trollop-1.16.2
Successfully installed gherkin-2.1.5
Successfully installed term-ansicolor-1.0.5
Successfully installed diff-lcs-1.1.2
Successfully installed json_pure-1.4.6
Successfully installed cucumber-0.8.5
Successfully installed cucumber-rails-0.3.2
7 gems installed
Installing ri documentation for trollop-1.16.2...
Installing ri documentation for gherkin-2.1.5...
Installing ri documentation for term-ansicolor-1.0.5...
Installing ri documentation for diff-lcs-1.1.2...
Installing ri documentation for json_pure-1.4.6...
Installing ri documentation for cucumber-0.8.5...
Installing ri documentation for cucumber-rails-0.3.2...
Installing RDoc documentation for trollop-1.16.2...
Installing RDoc documentation for gherkin-2.1.5...
Installing RDoc documentation for term-ansicolor-1.0.5...
Installing RDoc documentation for diff-lcs-1.1.2...
Installing RDoc documentation for json_pure-1.4.6...
Installing RDoc documentation for cucumber-0.8.5...
Installing RDoc documentation for cucumber-rails-0.3.2...

Rspecrspec-railsを指定してインストール

masatoshi@ubuntu:~$ gem install rspec-rails
**************************************************

  Thank you for installing rspec-1.3.0

  Please be sure to read History.rdoc and Upgrade.rdoc
  for useful information about this release.

**************************************************
**************************************************

  Thank you for installing rspec-rails-1.3.2

  If you are upgrading, do this in each of your rails apps
  that you want to upgrade:

    $ ruby script/generate rspec

  Please be sure to read History.rdoc and Upgrade.rdoc
  for useful information about this release.

**************************************************
Successfully installed rspec-1.3.0
Successfully installed rspec-rails-1.3.2
2 gems installed
Installing ri documentation for rspec-1.3.0...
Installing ri documentation for rspec-rails-1.3.2...
Installing RDoc documentation for rspec-1.3.0...
Installing RDoc documentation for rspec-rails-1.3.2...