海外記事翻訳シリーズ 【第 1 回】 RSpec ベストプラクティス

“Rubyist Magazine - 海外記事翻訳シリーズ 【第 1 回】 RSpec ベストプラクティス”

RSpec ベストプラクティス RSpec は、振舞駆動の設計プロセス (behaviour driven design process) において、人間にとって読みやすい仕様を書くための優れたツールです。RSpec で書かれた仕様が、アプリケーション開発における方向と検証を行います。本記事では私たちが気づいた、エレガントで保守しやすい仕様を書くためのプラクティスを紹介します。 まず、何をしてるのかを #describe で説明しましょう 定義するつもりのメソッドごとに、#describe を使うことから始めましょう。このとき引数にはメソッド名を指定します。クラスメソッドには名前の頭に「.」をつけ、インスタンスメソッドには頭に「#」をつけましょう。これは Ruby の標準的なドキュメントプラクティスに則っており、spec ランナーによる出力が読みやすくなります。 describe User do describe '.authenticate' do end describe '.admins' do end describe '#admin?' do end describe '#name' do end end 次に、#context (コンテキスト) をはっきりさせましょう メソッドの実行パスごとに、#context を書きましょう。与えられたコンテキストのもとでの〔訳注: つまり実行パスごとの〕メソッドの挙動を逐語的に指定します。 たとえば、次のメソッドには 2 つの実行パスがあります。 class SessionsController < ApplicationController def create user = User.authenticate :email => params[:email], :password => params[:password] if user.present? session[:user_id] = user.id redirect_to root_path else flash.now[:n...

Full article: http://jp.rubyist.net/magazine/?0032-TranslationArticle=