ビヘイビア駆動開発入門

目的

ビヘイビア駆動開発(BDD)習得

前提

ソフトウェア	バージョン	備考
OS X	10.8.5
ruby	2.1.1
rvm	1.24.0
rbricks	2.0.5
heroku-toolbelt	3.6.0
rspec	2.14.8
cucumber	1.3.14

構成

ビヘイビア駆動開発(BDD)とは
セットアップ
サンプル実行
日本語シナリオ
ログインフィーチャの追加
CI環境構築

詳細

ビヘイビア駆動開発(BDD)とは

テスト駆動開発(TDD)からビヘイビア駆動開発(BDD)へ

TDD・・・オブジェクトが何をするかではなく、オブジェクトが何であるか。構造に焦点を合わせる。

TDD概念図

BDD・・・オブジェクトが何をするか。構造ではなく振る舞いに焦点を合わせる。

BDD概念図

BDDの概要

BDDとは、ステークホルダーの視点に立って振る舞いを説明することにより、アプリケーションを実装するための手法である。

『The RSpec Book』

BDDサイクル

Cucmberで始める
１つのシナリオに焦点を合わせる
失敗するステップ定義を書く
RSpecに進む 1. 失敗するサンプルを書く 1. サンプルを失敗させる 1. リファクタリング 1. ステップが成功するまで1-3を繰り返す
リファクタリング
シナリオが成功するまで1-5を繰り返す
シナリオが成功したら1に戻る

BDDの原則

十分といったら十分
ステークホルダーに価値をもたらす
すべては振る舞いから

プロジェクトのインセプション

すべてのステークホルダーを集めて、プロジェクトのビジョンまたは目的を定める。
定めたことを理解するためそのビジョンを持つコアステークホルダーと協力し、結果または目標を洗い出す。洗い出す対象はSMARTであることが望ましい。
洗いだしたことを達成するソフトウエアで実行する必要があることを、フィーチャーセットまたはテーマ（レポートや顧客の登録など）として表現する。
最後にこれらのテーマを構成する特定のフィーチャやストーリーについて話し合う

BDDは主にこの最後のレベルで適用される。また、ステークホルダーやビジネスアナリストといった用語は、個人ではなく役割を表す。

SMARTな結果

SMARTは、ある種の特性を持つ結果または目標を表現するために使われる頭文字です。その特性とは、Specific(具体的)、Measurable(測定可能)、Achievable(達成可能)、Relevant(適切)、Timeboxed(期限付き)の５つです。

『The RSpec Book』

リリースサイクル

ステークホルダーがビジネスアナリストと話し合い要件をフィーチャとして表現する。必要があればフィーチャを検証可能な小さなストーリーに分解する。
ステークホルダーとビジネスアナリストがテスト担当者と協力してストーリーの範囲を決定する。各ストーリーはどのように完結するかを意識する。
プログラマがストーリーの実装にとりかかる前の最後のタスクとして必要に応じてシナリオを自動化する。
開発者はRSpecと「Coding by Example」に基づいてシナリオを実際に動かす。
必要な振る舞いを説明するサンプルコードを記述する
そのサンプルを動作させるためのコードを実装する
リファクタリングをおこなう
このシナリオを動かすのに十分なソフトウエアを完成させ、他のシナリオが動くようになるまでこの作業を繰り返す。
一周して元に戻り、実際に動くシナリオをステークホルダーに見てもらいストーリーを完成させる。

BDDのもっとも重要な特徴の１つはシナリオを自動化するのが簡単で、しかもステークホルダーにとって理解しやすいこと。これらのシナリオを定義し、自動化するのがCucumberが担当する。

ストーリーイン、フィーチャアウト

フィーチャは凝集された価値をステークホルダーに提供するものであり、ストーリーはほんの数日で実装できる機能を見てもらうためのものです。したがって、ステークホルダーにとって意味があるのはフィーチャのほうであり、フィーチャを提供するチームにとって意味があるのはストーリーのほうです。

『The RSpec Book』

ストーリーの構造

タイトル
どのストーリーについて説明するのかを明確にする。
ナラティブ
最低でもこのストーリーのステークホルダー、ステークホルダーが望んでいるフィーチャの説明、およびステークホルダーがそれを望んでいる理由を明らかにする。そしてこの振る舞いによりどのような利益を手にするのかを明らかにする。
受け入れ基準
BDDの受け入れ基準は個々のステップで構成されるいくつかのシナリオとして定義される。

ナラティブの例

<ステークホルダー>として
<フィーチャ>をしたい
なぜなら<利益>だからだ

ビジネスアナリストはステークホルダーの使う言葉(ドメイン用語)をストーリーに使うことで全員が同じ用語を使うようにしなければならない
ドメイン用語はオブジェクト、メソッド、変数などコードベースにそのまま含まれる
ストーリーの「完了」を定義する受け入れい基準となるシナリオにおいて重要なのはステークホルダーが行うのとまったく同じ方法でアプリケーションとやりとりすること

まとめ

BDDはTDDの枠組みを変化させ、本格的なアジャイル開発を理解しやすくする試みから発展した手法。
BDDには３つの原則がある
- 十分といったら十分
- ステークホルダーに価値をもたらす
- すべては振る舞いから
BDDのストーリーとシナリオは、自動化しやすく、ステークホルダーが明確に理解できることに重点を置いてた上で、一連の作業モデルをサポートするように設計されている。

セットアップ

RailsBricks入門参照

RailsBricks入門(BDD適用編)参照

サンプル実行

Hello RSpec

spec/greeter_spec.rb

describe "RSpec Greeter" do
  it "should say 'Hello RSpec!' when it receives the greet() message" do
    greeter = RSpecGreeter.new
    greeting = greeter.greet
    greeting.should == "Hello RSpec!"
  end
end

RSpecの実行

$ rspec spec/greeter_spec.rb
F

Failures:

  1) RSpec Greeter should say 'Hello RSpec!' when it receives the greet() message
     Failure/Error: greeter = RSpecGreeter.new
     NameError:
       uninitialized constant RSpecGreeter
     # ./spec/greeter_spec.rb:3:in `block (2 levels) in <top (required)>'

Finished in 0.00073 seconds
1 example, 1 failure

Failed examples:

rspec ./spec/greeter_spec.rb:2 # RSpec Greeter should say 'Hello RSpec!' when it receives the greet() message

修正

class RSpecGreeter
  def greet
    "Hello RSpec!"
  end
end

describe "RSpec Greeter" do
  it "should say 'Hello RSpec!' when it receives the greet() message" do
    greeter = RSpecGreeter.new
    greeting = greeter.greet
    expect(greeting).to eq("Hello RSpec!")
  end
end

再実行

$ rspec spec/greeter_spec.rb
No examples found.


Finished in 0.00007 seconds
0 examples, 0 failures

Hello Cucumber

feature/greeter_says_hello.feature

Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello
    Given a greeter
    When I send it the greet message
    Then I should see "Hello Cucumber"

cucumberの実行

$ cucumber features
Using the default profile...
Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello         # features/greeter_says_hello.feature:7
    Given a greeter                    # features/greeter_says_hello.feature:8
      Undefined step: "a greeter" (Cucumber::Undefined)
      features/greeter_says_hello.feature:8:in `Given a greeter'
    When I send it the greet message   # features/greeter_says_hello.feature:9
      Undefined step: "I send it the greet message" (Cucumber::Undefined)
      features/greeter_says_hello.feature:9:in `When I send it the greet message'
    Then I should see "Hello Cucumber" # features/greeter_says_hello.feature:10
      Undefined step: "I should see "Hello Cucumber"" (Cucumber::Undefined)
      features/greeter_says_hello.feature:10:in `Then I should see "Hello Cucumber"'

1 scenario (1 undefined)
3 steps (3 undefined)
0m0.350s

You can implement step definitions for undefined steps with these snippets:

Given(/^a greeter$/) do
  pending # express the regexp above with the code you wish you had
end

When(/^I send it the greet message$/) do
  pending # express the regexp above with the code you wish you had
end

Then(/^I should see "(.*?)"$/) do |arg1|
  pending # express the regexp above with the code you wish you had
end

feature/step_definitions/greeter_steps.rb

Given(/^a greeter$/) do
  @greeter = CucumberGreeter.new
end

When(/^I send it the greet message$/) do
  @message = @greeter.greet
end

Then(/^I should see "(.*?)"$/) do |arg1|
  @message.should == greeting
end

再実行

$ cucumber features
Using the default profile...
Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello         # features/greeter_says_hello.feature:7
    Given a greeter                    # features/step_definitions/greeter_steps.rb:1
      uninitialized constant CucumberGreeter (NameError)
      ./features/step_definitions/greeter_steps.rb:2:in `/^a greeter$/'
      features/greeter_says_hello.feature:8:in `Given a greeter'
    When I send it the greet message   # features/step_definitions/greeter_steps.rb:5
    Then I should see "Hello Cucumber" # features/step_definitions/greeter_steps.rb:9

Failing Scenarios:
cucumber features/greeter_says_hello.feature:7 # Scenario: greeter says hello

1 scenario (1 failed)
3 steps (1 failed, 2 skipped)
0m0.359s

修正

class CucumberGreeter
  def greet
    "Hello Cucumber!"
  end
end

Given(/^a greeter$/) do
  @greeter = CucumberGreeter.new
end

When(/^I send it the greet message$/) do
  @message = @greeter.greet
end

Then(/^I should see "(.*?)"$/) do |greeting|
  @message.should == greeting
end

再実行

$ cucumber features
Using the default profile...
Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello          # features/greeter_says_hello.feature:7
    Given a greeter                     # features/step_definitions/greeter_steps.rb:7
    When I send it the greet message    # features/step_definitions/greeter_steps.rb:11
    Then I should see "Hello Cucumber!" # features/step_definitions/greeter_steps.rb:15

1 scenario (1 passed)
3 steps (3 passed)
0m0.370s

一括実行

$ rake
/Users/k2works/.rvm/rubies/ruby-2.0.0-p247/bin/ruby -S rspec ./spec/greeter_spec.rb
.

Finished in 0.00141 seconds
1 example, 0 failures
/Users/k2works/.rvm/rubies/ruby-2.0.0-p247/bin/ruby -S bundle exec cucumber  --profile default
Using the default profile...
Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello          # features/greeter_says_hello.feature:7
    Given a greeter                     # features/step_definitions/greeter_steps.rb:7
    When I send it the greet message    # features/step_definitions/greeter_steps.rb:11
    Then I should see "Hello Cucumber!" # features/step_definitions/greeter_steps.rb:15

1 scenario (1 passed)
3 steps (3 passed)
0m0.389s

日本語シナリオ

spec/greeter_ja_spec.rb

class RSpecGreeterJa
  def greet
    "こんにちはRSpec!"
  end
end

describe "RSpecあいさつ" do
  it "greet()メッセージを受けっとった場合'こんにちはRSpec!'と表示される" do
    greeter = RSpecGreeterJa.new
    greeting = greeter.greet
    expect(greeting).to eq("こんにちはRSpec!")
  end
end

features/greeter_says_hello_ja.feature

# language: ja
機能: こんにちはとあいさつする

  RSpec Book読者として
  こんにちはとあいさつしたい
  なぜならRSpecとCucumberの学習を始めたいからだ

  シナリオ: こんにちはとあいさつする
    前提 あいさつする人がいる
    もし あいさつのメッセージを送った
    ならば "こんにちはCucumber!"と表示される

features/step_definitions/greeter_steps_ja.rb

class CucumberGreeter
  def greet_ja
    "こんにちはCucumber!"
  end
end

前提(/^あいさつする人がいる$/) do
  @greeter = CucumberGreeter.new
end

もし(/^あいさつのメッセージを送った$/) do
  @message = @greeter.greet_ja
end

ならば(/^"(.*?)"と表示される$/) do |greeting|
  @message.should == greeting
end

命令一覧

$ cucumber --i18n ja
      | feature          | "フィーチャ", "機能"                                  |
      | background       | "背景"                                           |
      | scenario         | "シナリオ"                                         |
      | scenario_outline | "シナリオアウトライン", "シナリオテンプレート", "テンプレ", "シナリオテンプレ" |
      | examples         | "例", "サンプル"                                    |
      | given            | "* ", "前提"                                     |
      | when             | "* ", "もし"                                     |
      | then             | "* ", "ならば"                                    |
      | and              | "* ", "かつ"                                     |
      | but              | "* ", "しかし", "但し", "ただし"                       |
      | given (code)     | "前提"                                           |
      | when (code)      | "もし"                                           |
      | then (code)      | "ならば"                                          |
      | and (code)       | "かつ"                                           |
      | but (code)       | "しかし", "但し", "ただし"                             |

一括実行

$ rake
/Users/k2works/.rvm/rubies/ruby-2.0.0-p247/bin/ruby -S rspec ./spec/greeter_ja_spec.rb ./spec/greeter_spec.rb
..

Finished in 0.00121 seconds
2 examples, 0 failures
/Users/k2works/.rvm/rubies/ruby-2.0.0-p247/bin/ruby -S bundle exec cucumber  --profile default
Using the default profile...
Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello          # features/greeter_says_hello.feature:7
    Given a greeter                     # features/step_definitions/greeter_steps.rb:7
    When I send it the greet message    # features/step_definitions/greeter_steps.rb:11
    Then I should see "Hello Cucumber!" # features/step_definitions/greeter_steps.rb:15

# language: ja
機能: こんにちはとあいさつする

  RSpec Book読者として
  こんにちはとあいさつしたい
  なぜならRSpecとCucumberの学習を始めたいからだ

  シナリオ: こんにちはとあいさつする          # features/greeter_says_hello_ja.feature:8
    前提あいさつする人がいる              # features/step_definitions/greeter_steps_ja.rb:7
    もしあいさつのメッセージを送った          # features/step_definitions/greeter_steps_ja.rb:11
    ならば"こんにちはCucumber!"と表示される # features/step_definitions/greeter_steps_ja.rb:15

2 scenarios (2 passed)
6 steps (6 passed)
0m0.391s

ログインフィーチャの追加

１つのシナリオに焦点を合わせる

features/login.feature

フィーチャのナラティブ

# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

受け入れ条件

# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオ: 管理ユーザーとしてログインする
    前提 管理ユーザーの登録が完了している
    もし 管理ユーザーがログインしたら
    ならば 管理画面に移動して"Signed in successfully."と表示される

失敗するステップ定義を書く(Cucumber)

$ cucumber features/login.feature
Using the default profile...
# language: ja
機能: ログイン
  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオ: 管理ユーザーとしてログインする                         # features/login.feature:8
    前提管理ユーザーの登録が完了している                          # features/login.feature:9
      Undefined step: "管理ユーザーの登録が完了している" (Cucumber::Undefined)
      features/login.feature:9:in `前提管理ユーザーの登録が完了している'
    もし管理ユーザーがログインしたら                            # features/login.feature:10
      Undefined step: "管理ユーザーがログインしたら" (Cucumber::Undefined)
      features/login.feature:10:in `もし管理ユーザーがログインしたら'
    ならば管理画面に移動して"Signed in successfully."と表示される # features/login.feature:11
      Undefined step: "管理画面に移動して"Signed in successfully."と表示される" (Cucumber::Undefined)
      features/login.feature:11:in `ならば管理画面に移動して"Signed in successfully."と表示される'

1 scenario (1 undefined)
3 steps (3 undefined)
0m0.402s

You can implement step definitions for undefined steps with these snippets:

前提(/^管理ユーザーの登録が完了している$/) do
  pending # express the regexp above with the code you wish you had
end

もし(/^管理ユーザーがログインしたら$/) do
  pending # express the regexp above with the code you wish you had
end

ならば(/^管理画面に移動して"(.*?)"と表示される$/) do |arg1|
  pending # express the regexp above with the code you wish you had
end

失敗するサンプルを書く

features/step_definitions
ブロックからpendingの呼び出しを削除する

前提(/^管理ユーザーの登録が完了している$/) do
end

もし(/^管理ユーザーがログインしたら$/) do
end

ならば(/^管理画面に移動して"(.*?)"と表示される$/) do |message|
end

cucumberを実行して正常に動作するか確認する

$ cucumber features/login.feature
Using the default profile...
# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオ: 管理ユーザーとしてログインする                         # features/login.feature:8
    前提管理ユーザーの登録が完了している                          # features/step_definitions/login_steps.rb:1
    もし管理ユーザーがログインしたら                            # features/step_definitions/login_steps.rb:4
    ならば管理画面に移動して"Signed in successfully."と表示される # features/step_definitions/login_steps.rb:7

1 scenario (1 passed)
3 steps (3 passed)
0m0.404s

テストを失敗させるためステップファイルを編集する
ステップファルのデバッグにはsave_and_open_pageを使う

前提(/^管理ユーザーの登録が完了している$/) do
end

もし(/^管理ユーザーがログインしたら$/) do
  visit '/'
  click_link 'Sign in'
  fill_in 'Username', with: 'admin'
  fill_in 'Password', with: '1234'
  click_button('Sign in')
end

ならば(/^管理画面に移動して"(.*?)"と表示される$/) do |message|
  expect(page).to have_content message
end

cucumberを実行してテストが失敗するか確認する

$ cucumber features/login.feature
Using the default profile...
# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオ: 管理ユーザーとしてログインする                         # features/login.feature:8
    前提管理ユーザーの登録が完了している                          # features/step_definitions/login_steps.rb:1
    もし管理ユーザーがログインしたら                            # features/step_definitions/login_steps.rb:4
    ならば管理画面に移動して"Signed in successfully."と表示される # features/step_definitions/login_steps.rb:12
      expected to find text "Signed in successfully." in "Toggle navigation Home Sign in × Wrong username/password. Sign in Username Password © 2014 - Yourself! Assembled with RailsBricks" (RSpec::Expectations::ExpectationNotMetError)
      ./features/step_definitions/login_steps.rb:13:in `/^管理画面に移動して"(.*?)"と表示される$/'
      features/login.feature:11:in `ならば管理画面に移動して"Signed in successfully."と表示される'

Failing Scenarios:
cucumber features/login.feature:8 # Scenario: 管理ユーザーとしてログインする

1 scenario (1 failed)
3 steps (1 failed, 2 passed)
0m0.758s

サンプルを失敗させる(Rspec)

失敗する正常系のテスケースを作成する
spec/login_spec.rb
正常系

require 'spec_helper'

  describe User do
    context "正常系" do

      it "管理ユーザーが正しいパスワードでログインする" do

        params = Hash.new
        params[:username] = 'admin'
        params[:password] = '1234'

        user = User.where(username: params[:username].strip).first
        ret = user.authenticate(params[:password])
        expect(ret).not_to eq(nil)
      end

    end

    context "例外系" do
    end
  end
end

RSpecを実行してテストが失敗することを確認する

$ rspec spec/login_spec.rb
F

Failures:

  1) User 正常系 管理ユーザーが正しいパスワードでログインする
     Failure/Error: ret = user.authenticate(params[:password])
     NoMethodError:
       undefined method `authenticate' for nil:NilClass
     # ./spec/login_spec.rb:13:in `block (3 levels) in <top (required)>'

Finished in 0.00671 seconds
1 example, 1 failure

Failed examples:

rspec ./spec/login_spec.rb:6 # User 正常系 管理ユーザーでログインする

Randomized with seed 9916

テストを成功させるためのダミーデータをFactoryGirlで作成する
spec/factories.rb

FactoryGirl.define do
  factory :user do
    username 'admin'
    email 'admin@example.com'
    password '1234'
    password_confirmation '1234'
    admin true
  end
end

ダミーデータを登録するようにテストを修正する

require 'spec_helper'

describe User do
  context "正常系" do

    it "管理ユーザーが正しいパスワードでログインする" do
      FactoryGirl.create(:user)
      params = Hash.new
      params[:username] = 'admin'
      params[:password] = '1234'

      user = User.where(username: params[:username].strip).first
      ret = user.authenticate(params[:password])
      expect(ret).not_to eq(nil)
    end

  end

  context "例外系" do
  end
end

テストが成功することを確認する

$ rspec spec/login_spec.rb
.

Finished in 0.22209 seconds
1 example, 0 failures

Randomized with seed 53624

続いて例外系のテストケースを作成する
例外系

require 'spec_helper'

describe User do
  context "正常系" do

    it "管理ユーザーが正しいパスワードでログインする" do
      FactoryGirl.create(:user)
      params = Hash.new
      params[:username] = 'admin'
      params[:password] = '1234'

      user = User.where(username: params[:username].strip).first
      ret = user.authenticate(params[:password])
      expect(ret).not_to eq(nil)
    end

  end

  context "例外系" do

    it "管理ユーザーで間違ったパスワードでログインする" do
      FactoryGirl.create(:user)
      params = Hash.new
      params[:username] = 'admin'
      params[:password] = '1234'

      user = User.where(username: params[:username].strip).first
      ret = user.authenticate(params[:password])
      expect(ret).to eq(false)
    end

  end
end

まず、テストを失敗させる

 rspec spec/login_spec.rb
.F

Failures:

  1) User 例外系 管理ユーザーで間違ったパスワードでログインする
     Failure/Error: expect(ret).to eq(false)

       expected: false
            got: #<User id: 1, username: "admin", email: "admin@example.com", password_digest: "$2a$04$noieAqxsU70p0AiKYqJRR.gKYnYq3ZfAX1Tz0JYBYRHf...", admin: true, slug: "user-admin", created_at: "2014-04-08 09:16:34", updated_at: "2014-04-08 09:16:34">

       (compared using ==)
     # ./spec/login_spec.rb:29:in `block (3 levels) in <top (required)>'

Finished in 0.27748 seconds
2 examples, 1 failure

Failed examples:

rspec ./spec/login_spec.rb:21 # User 例外系 管理ユーザーで間違ったパスワードでログインする

Randomized with seed 35870

続いてテストを成功させるためテストコード編集する

require 'spec_helper'

describe User do
  context "正常系" do

    it "管理ユーザーが正しいパスワードでログインする" do
      FactoryGirl.create(:user)
      params = Hash.new
      params[:username] = 'admin'
      params[:password] = '1234'

      user = User.where(username: params[:username].strip).first
      ret = user.authenticate(params[:password])
      expect(ret).not_to eq(nil)
    end

  end

  context "例外系" do

    it "管理ユーザーが間違ったパスワードでログインする" do
      FactoryGirl.create(:user)
      params = Hash.new
      params[:username] = 'admin'
      params[:password] = '0000'

      user = User.where(username: params[:username].strip).first
      ret = user.authenticate(params[:password])
      expect(ret).to eq(false)
    end

  end
end

テストが成功することを確認する

$ rspec spec/login_spec.rb
..

Finished in 0.23543 seconds
2 examples, 0 failures

Randomized with seed 45369

リファクタリング(Rspec)

コードの中で重複している部分が存在するので重複をなくしパラメータ変数をオブジェクト変数に変更する

require 'spec_helper'

describe User do
  before(:each) do
    FactoryGirl.create(:user)
    @params = Hash.new
  end

  context "正常系" do

    it "管理ユーザーが正しいパスワードでログインする" do
      @params[:username] = 'admin'
      @params[:password] = '1234'

      user = User.where(username: @params[:username].strip).first
      ret = user.authenticate(@params[:password])
      expect(ret).not_to eq(nil)
    end

  end

  context "例外系" do

    it "管理ユーザーが間違ったパスワードでログインする" do
      @params[:username] = 'admin'
      @params[:password] = '0000'

      user = User.where(username: @params[:username].strip).first
      ret = user.authenticate(@params[:password])
      expect(ret).to eq(false)
    end

  end
end

テストを再実行して壊れていないか確認する

$ rspec spec/login_spec.rb
..

Finished in 0.30719 seconds
2 examples, 0 failures

Randomized with seed 64622

リファクタリング(Cucumber)

テストを成功させるためダミーデータを作成する

前提(/^管理ユーザーの登録が完了している$/) do
  FactoryGirl.create(:user)
end

もし(/^管理ユーザーがログインしたら$/) do
  visit '/'
  click_link 'Sign in'
  fill_in 'Username', with: 'admin'
  fill_in 'Password', with: '1234'
  click_button('Sign in')
end

ならば(/^管理画面に移動して"(.*?)"と表示される$/) do |message|
  expect(page).to have_content message
end

テストが成功することを確認する

$ cucumber features/login.feature
Using the default profile...
# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオ: 管理ユーザーとしてログインする                         # features/login.feature:8
    前提管理ユーザーの登録が完了している                          # features/step_definitions/login_steps.rb:1
    もし管理ユーザーがログインしたら                            # features/step_definitions/login_steps.rb:5
    ならば管理画面に移動して"Signed in successfully."と表示される # features/step_definitions/login_steps.rb:13

1 scenario (1 passed)
3 steps (3 passed)
0m0.959s

成功することを確認したら複数のテストケースに対応できるように変更する

# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオアウトライン: 管理ユーザーとしてログインする
    前提 "<管理ユーザー>"の登録が完了している
    もし "<管理ユーザー>"が"<パスワード>"を使ってログインしたら
    ならば 管理画面に移動して"<画面メッセージ>"と表示される

    例: 管理ユーザーがログインする
      | 管理ユーザー | パスワード | 画面メッセージ |
      | admin      | 1234    | Signed in successfully. |
      | admin      | 0000    | Wrong username/password. |

    例: 管理ユーザー以外がログインする
      | 管理ユーザー | パスワード | 画面メッセージ |
      | not_admin      | 1234    | Wrong username/password.|
      | not_admin      | 0000    | Wrong username/password. |

Cucumberを実行して必要なテストコードを追加する

$ cucumber features/login.feature
Using the default profile...
# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオアウトライン: 管理ユーザーとしてログインする         # features/login.feature:8
    前提"<管理ユーザー>"の登録が完了している            # features/login.feature:9
    もし"<管理ユーザー>"が"<パスワード>"を使ってログインしたら # features/login.feature:10
    ならば管理画面に移動して"<画面メッセージ>"と表示される     # features/step_definitions/login_steps.rb:13

    例: 管理ユーザーがログインする
      | 管理ユーザー | パスワード | 画面メッセージ                  |
      | admin  | 1234  | Signed in successfully.  |
      Undefined step: ""admin"の登録が完了している" (Cucumber::Undefined)
      features/login.feature:9:in `前提"<管理ユーザー>"の登録が完了している'
      | admin  | 0000  | Wrong username/password. |
      Undefined step: ""admin"の登録が完了している" (Cucumber::Undefined)
      features/login.feature:9:in `前提"<管理ユーザー>"の登録が完了している'

    例: 管理ユーザー以外がログインする
      | 管理ユーザー    | パスワード | 画面メッセージ                  |
      | not_admin | 1234  | Wrong username/password. |
      Undefined step: ""not_admin"の登録が完了している" (Cucumber::Undefined)
      features/login.feature:9:in `前提"<管理ユーザー>"の登録が完了している'
      | not_admin | 0000  | Wrong username/password. |
      Undefined step: ""not_admin"の登録が完了している" (Cucumber::Undefined)
      features/login.feature:9:in `前提"<管理ユーザー>"の登録が完了している'

4 scenarios (4 undefined)
12 steps (4 skipped, 8 undefined)
0m0.459s

You can implement step definitions for undefined steps with these snippets:

前提(/^"(.*?)"の登録が完了している$/) do |arg1|
  pending # express the regexp above with the code you wish you had
end

もし(/^"(.*?)"が"(.*?)"を使ってログインしたら$/) do |arg1, arg2|
  pending # express the regexp above with the code you wish you had
end

外部からのパラメータでログイン操作を制御できるようにする

前提(/^"(.*?)"の登録が完了している$/) do |user|
  if user == "admin"
    FactoryGirl.create(:user)
  end
end

もし(/^"(.*?)"が"(.*?)"を使ってログインしたら$/) do |user, pass|
  visit '/'
  click_link 'Sign in'
  fill_in 'Username', with: user
  fill_in 'Password', with: pass
  click_button('Sign in')
end

ならば(/^管理画面に移動して"(.*?)"と表示される$/) do |message|
  expect(page).to have_content message
end

変更後テストが成功することを確認する

$ cucumber features/login.feature
Using the default profile...
# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオアウトライン: 管理ユーザーとしてログインする         # features/login.feature:8
    前提"<管理ユーザー>"の登録が完了している            # features/step_definitions/login_steps.rb:1
    もし"<管理ユーザー>"が"<パスワード>"を使ってログインしたら # features/step_definitions/login_steps.rb:7
    ならば管理画面に移動して"<画面メッセージ>"と表示される     # features/step_definitions/login_steps.rb:15

    例: 管理ユーザーがログインする
      | 管理ユーザー | パスワード | 画面メッセージ                  |
      | admin  | 1234  | Signed in successfully.  |
      | admin  | 0000  | Wrong username/password. |

    例: 管理ユーザー以外がログインする
      | 管理ユーザー    | パスワード | 画面メッセージ                  |
      | not_admin | 1234  | Wrong username/password. |
      | not_admin | 0000  | Wrong username/password. |

4 scenarios (4 passed)
12 steps (12 passed)
0m1.164s

最後にこれまで作成したテストケースを一括実行して失敗がないか確認する

$ rake
/Users/k2works/.rvm/rubies/ruby-2.0.0-p247/bin/ruby -S rspec ./spec/greeter_ja_spec.rb ./spec/greeter_spec.rb ./spec/login_spec.rb
....

Finished in 0.20415 seconds
4 examples, 0 failures

Randomized with seed 33900

/Users/k2works/.rvm/rubies/ruby-2.0.0-p247/bin/ruby -S bundle exec cucumber  --profile default
Using the default profile...
Feature: greeter says hello

  In order to start learning RSpec and Cucumber
  As a reader of The RSpec Book
  I want a greeter to say Hello

  Scenario: greeter says hello          # features/greeter_says_hello.feature:7
    Given a greeter                     # features/step_definitions/greeter_steps.rb:7
    When I send it the greet message    # features/step_definitions/greeter_steps.rb:11
    Then I should see "Hello Cucumber!" # features/step_definitions/greeter_steps.rb:15

# language: ja
機能: こんにちはとあいさつする

  RSpec Book読者として
  こんにちはとあいさつしたい
  なぜならRSpecとCucumberの学習を始めたいからだ

  シナリオ: こんにちはとあいさつする          # features/greeter_says_hello_ja.feature:8
    前提あいさつする人がいる              # features/step_definitions/greeter_steps_ja.rb:7
    もしあいさつのメッセージを送った          # features/step_definitions/greeter_steps_ja.rb:11
    ならば"こんにちはCucumber!"と表示される # features/step_definitions/greeter_steps_ja.rb:15

# language: ja
機能: ログイン

  管理ユーザーとして
  ログインしたい
  なぜなら管理ユーザーだけに許可された作業をするためだ

  シナリオアウトライン: 管理ユーザーとしてログインする         # features/login.feature:8
    前提"<管理ユーザー>"の登録が完了している            # features/step_definitions/login_steps.rb:1
    もし"<管理ユーザー>"が"<パスワード>"を使ってログインしたら # features/step_definitions/login_steps.rb:7
    ならば管理画面に移動して"<画面メッセージ>"と表示される     # features/step_definitions/login_steps.rb:15

    例: 管理ユーザーがログインする
      | 管理ユーザー | パスワード | 画面メッセージ                  |
      | admin  | 1234  | Signed in successfully.  |
      | admin  | 0000  | Wrong username/password. |

    例: 管理ユーザー以外がログインする
      | 管理ユーザー    | パスワード | 画面メッセージ                  |
      | not_admin | 1234  | Wrong username/password. |
      | not_admin | 0000  | Wrong username/password. |

6 scenarios (6 passed)
18 steps (18 passed)
0m1.351s

CI環境構築

Travis対応

_.travis.yml_追加

language: ruby
rvm:
  - "2.0.0"
script:
  - bundle exec rake db:migrate
  - bundle exec rake db:test:prepare
  - bundle exec rspec
  - bundle exec cucumber

参照

RSpec
Cucumber
thoughtbot / factory_girl

参考文献

NITROUS.IO

Introducing the Nitrous.IO Hack Button: Bring Your Code to Life

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
.bundle		.bundle
.rbricks		.rbricks
.yardoc		.yardoc
app		app
bin		bin
config		config
db		db
features		features
lib		lib
o-rdoc		o-rdoc
public		public
script		script
spec		spec
vendor/assets		vendor/assets
.env		.env
.gitignore		.gitignore
.rspec		.rspec
.travis.yml		.travis.yml
.yardopts		.yardopts
Gemfile		Gemfile
Gemfile.lock		Gemfile.lock
Guardfile		Guardfile
Procfile		Procfile
README.md		README.md
Rakefile		Rakefile
config.ru		config.ru
nitrous.txt		nitrous.txt

k2works/bdd_introduction

Folders and files

Latest commit

History

Repository files navigation

ビヘイビア駆動開発入門

目的

前提

構成

詳細

テスト駆動開発(TDD)からビヘイビア駆動開発(BDD)へ

BDDの概要

BDDサイクル

BDDの原則

プロジェクトのインセプション

リリースサイクル

ストーリーの構造

まとめ

Hello RSpec

Hello Cucumber

１つのシナリオに焦点を合わせる

フィーチャのナラティブ

受け入れ条件

失敗するステップ定義を書く(Cucumber)

失敗するサンプルを書く

サンプルを失敗させる(Rspec)

リファクタリング(Rspec)

リファクタリング(Cucumber)

Travis対応

参照

参考文献

About

Resources

Stars

Watchers

Forks

Languages