※間違いなどございましたらご指摘いただけると幸いです
※随時更新予定
概要
以下、https://semaphoreci.com/community/tutorials/getting-started-with-rspec より引用
RSpec is a testing tool for Ruby, created for behavior-driven development (BDD). It is the most frequently used testing library for Ruby in production applications.
「RSpec は、ビヘイビア駆動開発 (BDD) 用に作成された Ruby のテスト ツールです。本番アプリケーションで最も頻繁に使用される Ruby のテスト ライブラリです。」(Google翻訳)
-
RSpec
はRailsアプリケーションの開発で利用するテストツール- Railsに最初から搭載されている"minitest"というテストツールも存在するが、RSpecが実質デファクトスタンダードとされている
- それだけ"minitest"よりも使用されているのが分かる
- Railsに最初から搭載されている"minitest"というテストツールも存在するが、RSpecが実質デファクトスタンダードとされている
"minitest" v.s. "RSpec"
Q.どっちも同じテストツールなら何が違うの?
A.minitestはシンプルで学習しやすい。
RSpecは高度な機能が提供されており豊富な表現が可能。
色々と参考にしましたが以下の通りにまとめられます
"minitest"
-
メリット
- 構文がシンプル → 故に学習もしやすい
- Railsチュートリアル、Railsガイドではこちらが使用されている → 故に学習もしやすい
- 公式がサポートしてくれている安心感
- 軽量で小規模なプロジェクトには最適
-
デメリット
- 高度な機能が不十分
- 複雑な構文は書けない(拡張性が不十分と感じるかも)
"RSpec"
-
メリット
- テストの説明を「会話のような概念を表現できる」ため
- デファクトスタンダードと呼ばれるぐらいにシェアが高い
- ドキュメントも豊富と言われている
- 機能の拡張性もあり柔軟 → 大規模なプロジェクトに使える
-
デメリット
- minitestよりは学習コストが高い
- 単純なテストに対しても「会話のような概念を表現」するため冗長に感じる場合もある
RSpecによるテスト
ドキュメントを参考にすると以下のように「~specs」というのが幾つか確認できます。
- これらは様々の処理についてテストをする際に利用します
- 例えば"Model Specs"はアプリケーションの Model が正しい振る舞いを行っているかテストする際に用いる
基本構文
RSpecではテストコードを組織化して書くためにdescribe
、context
、it
というブロックを使用
- このキーワードを使用して「何のどこの処理のテストなのか」を明記してテストケースを作っていく
- 以下のサンプルコードのようにテストケースをグループ分けしていく
-
describe
、context
、it
を用いてネストで(親子関係を持たせて)何のテストなのかを明示していく
-
- 以下のサンプルコードのようにテストケースをグループ分けしていく
(サンプル1)
RSpec.describe Order do context "with no items" do it "behaves one way" do # ... end end context "with one item" do it "behaves another way" do # ... end end end
(サンプル2)
RSpec.describe 'Post' do # context 'before publication' do # (almost) plain English it 'cannot have comments' do # expect { Post.create.comments.create! }.to raise_error(ActiveRecord::RecordInvalid) # test code end end end
ブロック
以下のキーワードを用いて「コードがどのように動作するかをまとめるため」にテストケースをグループ化していく。
-
describe
- テストケースのグループの説明
- この
describe
が最上位のグループ親になる - 「何のシステム・機能をテスト対象としているグループなのか」が載っている
- この
- テストケースのグループの説明
-
context
- この
context
がdescribe
の子に相当する
⇒このキーワードを用いて親のdescribe
直下にネストを作る -
describe
は漠然と「機能」についてのグループ分けとしたら、context
は「その機能の何の条件・状況かのテストなのか」を明記する
- この
-
it
- 最も最下位の子に相当する
-
it
は上2つとは異なり詳細にテストケースの説明を載せる
(サンプル2)のドキュメントより、
RSpecでは、アプリケーションの振る舞いをほぼプレーンな英語で記述し、その後にテストコードで再度記述します。例えば、次のようになります。
とありますが、 describe
、context
、it
に日本語で記述しているケースが散見されるため英語である必要は無さそう
検証メソッド
先述のブロックでテストケースを検証メソッドで具体的にどういった結果が期待されているかをテストする
-
expect().to
の構文で具体的な値を検証する -
expect().to
に続いて'マッチャー'というキーワードを付属させてテスト結果を判定する- キーワードは複数存在する → Built-in matchers
サンプルコードexpect(account.balance).to eq(Money.new(37.42, :USD))
引用 : RSpec Expectations
参考書籍・サイト・記事
[記事全体]
[概要]
[RSpecによるテスト]