Download as PDF, PPTX
![More Matchers
• expect(target).to eq(XXX)
• expect{ Post.find(9999) }.to
raise_error(ActiveRecord::RecordNotFound)
• expect(target).to be_xxx # target.xxx?
• expect(target).to be_a_xxx
• expect(target).to be_an_xxx
• expect(collection).to be_empty
• expect([1,2,3]).to be_include(3)
• expect({ foo: "foo" }).to have_key(:foo)
• expect(3).to be_a_kind_of(Fixnum)
• Custom matcher](https://image.slidesharecdn.com/ihower-rspec-rails-150604030641-lva1-app6892/75/RSpec-on-Rails-Tutorial-7-2048.jpg)
![Controller spec syntax
get :show
post :create, :params => { :user => { :name => "a" } }
patch :update
delete :destroy
# more arguments
request.cookies[:foo] = "foo"
request.session[:bar] = “bar"
post :create, :params => { :name => "a" },
:session => { :zoo => "zoo" },
:flash => { :notice => "c"},
:format => :html
: params Rails 5.0](https://image.slidesharecdn.com/ihower-rspec-rails-150604030641-lva1-app6892/75/RSpec-on-Rails-Tutorial-16-2048.jpg)
![Tip: support
Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
# support/factory_helpers.rb
module FactoryHelpers
# ...
end
Rspec.configure do |config|
config.include FactoryHelpers
end](https://image.slidesharecdn.com/ihower-rspec-rails-150604030641-lva1-app6892/75/RSpec-on-Rails-Tutorial-32-2048.jpg)
![describe User do
describe '.search' do
it 'searches Google for the given query' do
HTTParty.should_receive(:get).with('http://www.google.com',
:query => { :q => 'foo' } ).and_return([])
User.search query
end
end
end
HTTP](https://image.slidesharecdn.com/ihower-rspec-rails-150604030641-lva1-app6892/75/RSpec-on-Rails-Tutorial-78-2048.jpg)
![describe User do
describe '.search' do
it 'searches for the given query' do
User.searcher = Searcher
Searcher.should_receive(:search).with('foo').and_return([])
User.search query
end
end
end](https://image.slidesharecdn.com/ihower-rspec-rails-150604030641-lva1-app6892/75/RSpec-on-Rails-Tutorial-79-2048.jpg)
Uploaded byWen-Tien Chang
RSpec on Rails Tutorial
This document provides an overview of RSpec testing for Rails applications. It discusses installing and generating RSpec files, different types of RSpec specs including model, controller, view, helper and routing specs. It covers spec syntax for expectations, matchers, factories and stubs. It also mentions features specs using Capybara, debugging techniques, JavaScript testing, and tools like DatabaseCleaner. The document is intended as a tutorial for setting up and writing different kinds of RSpec tests for a Rails application.
More Related Content
![[DSC 2016] 系列活動：李宏毅 / 一天搞懂深度學習](https://cdn.slidesharecdn.com/ss_thumbnails/1-160521014039-thumbnail.jpg?width=640&height=640&fit=bounds)
![[Srijan Wednesday Webinar] Rails 5: What's in It for Me?](https://cdn.slidesharecdn.com/ss_thumbnails/rails5webinar-160408072508-thumbnail.jpg?width=640&height=640&fit=bounds)
![Coded Agents – with UiPath SDK + LangGraph [Virtual Hands-on Workshop]](https://cdn.slidesharecdn.com/ss_thumbnails/codedagentsdeck-251215155422-5497c599-thumbnail.jpg?width=640&height=640&fit=bounds)
RSpec on Rails Tutorial
- 1.
- 2. Agenda • Rails RSpec •Model Spec, Routing Spec, Controller Spec, View Spec, Helper Spec • Request Spec Feature Spec • • CI (Continuous Integration) • Web
- 3. Install rspec-rails • gem“rspec-rails” • bundle • rails g rspec:install • git rm -r test
- 4. rake -T spec •rake spec • bundle exec rspec spec/xxx/xxx
- 5. Generators • rails gmodel A • rails g controller B • rails g scaffold C
- 6. spec/rails_helper.rb spec/spec_helper.rb config.fail_fast = true config.profile_examples= 3 config.order = :random
- 7. More Matchers • expect(target).toeq(XXX) • expect{ Post.find(9999) }.to raise_error(ActiveRecord::RecordNotFound) • expect(target).to be_xxx # target.xxx? • expect(target).to be_a_xxx • expect(target).to be_an_xxx • expect(collection).to be_empty • expect([1,2,3]).to be_include(3) • expect({ foo: "foo" }).to have_key(:foo) • expect(3).to be_a_kind_of(Fixnum) • Custom matcher
- 8. rspec-rails • • model • controller( stub/mock) • view • helper • routing • • controller ( stub/mock model ) • ( controllers ) • request • feature ( capybara)
- 9.
- 10. Model spec syntax let(:valid_attributes){{ :name => "Train#123"} } expect(Event.new).to_not be_valid expect(Event.new(valid_attributes)).to_not be_valid
- 11. Exercise 0 • Rails(ticket_office) • rspec-rails gem • scaffold
- 12. Exercise 1: Train ModelSpec • Train model • valid
- 13. Kata • Ticket Office •GET /trains/{train_id} • POST /trains/{train_id}/reservations
- 14. Routing spec syntax expect(:get=> "/events").to route_to("events#index") expect(:get => "/widgets/1/edit").not_to be_routable
- 15. But… • ( Rails ) •resources routing spec model validations associations • custom route
- 16. Controller spec syntax get:show post :create, :params => { :user => { :name => "a" } } patch :update delete :destroy # more arguments request.cookies[:foo] = "foo" request.session[:bar] = “bar" post :create, :params => { :name => "a" }, :session => { :zoo => "zoo" }, :flash => { :notice => "c"}, :format => :html : params Rails 5.0
- 17. Matcher syntax expect(response).to render_template(:new) expect(response).toredirect_to(events_url) expect(response).to have_http_status(200) expect(assigns(:event)).to be_a_new(Event)
- 18. Isolation Mode • controllerspec render view RSpec • render_views
- 19. Exercise 2: Train Controllershow spec (stub version) • trains/show • Train#find stub DB
- 20. View isolated from controllertoo assign(:widget, double(“Widget”, :name => "slicer")) render expect(rendered).to match /slicer/
- 21.
- 22. Exercise 3: Train showview • train show json view • rails4 jbuilder • Train stub
- 23. Exercise 4: • Train,Seat, SeatReservation, Reservation models • Train#available_seats • controller view stub ( or Partial Stub )
- 24. What have welearned? • stub&mock • stub&mocks • ActiveRecord
- 25. Exercise 5: • ReservationsController •Train#reserve mock • Train#reserve spec • ReservationsController mock
- 26. Exercise 5`: • Train#reservespec • ReservationsController ( mock)
- 27. Exercise 6: • GET/trains/{id} • POST /trains/{id}/reservations • POST /trains/{id}/reservations
- 28. Factory v.s. Fixtures •rails fixtures YAML DB • model validation • factory ActiveRecord • factory_girl gem fabrication gem • • ActiveReocrd • factory_girl trait unit test • model object DB build create build_stubbed
- 29. factory_girl FactoryGirl.define do factory :userdo firstname "John" lastname "Doe" sequence(:email) { |n| "test#{n}@example.com"} association :profile, :factory => :profile end factory :profile do bio "ooxx" end end
- 30. factory_girl before do @user =build(:user) # DB @event = create(:event) # DB end it "should post user data" post :create, :params => { :user => attributes_for(:user) } # ... end
- 31.
- 32. Tip: support Dir[Rails.root.join("spec/support/**/*.rb")].each {|f| require f } # support/factory_helpers.rb module FactoryHelpers # ... end Rspec.configure do |config| config.include FactoryHelpers end
- 33. Exercise 7: Extractto factory method • Train Extract support/ factory.rb
- 34. Tip: stub before(:each) { allow(controller).toreceive(:current_user) { ... } }
- 35. Tip: focus • :focus=> true describe it • rspec --tag focus • config.filter_run :focus => true config.run_all_when_everything_filtered = true
- 36. Request • full-stack • stub •Web APIs JSON, XML • Request controllers • sessions ( ) • Matchers controller spec
- 37. Request spec syntax describe"GET /events" do it "works! (now write some real specs)" do get “/events” expect(response).to have_http_status(200) end end
- 38. Example: controller it "createsa Widget and redirects to the Widget's page" do get "/widgets/new" expect(response).to render_template(:new) post "/widgets", :widget => {:name => "My Widget"} expect(response).to redirect_to(assigns(:widget)) follow_redirect! expect(response).to render_template(:show) expect(response.body).to include("Widget was successfully created.") end
- 39. Exercise 8: • 1.2. 3.
- 40. Feature spec • capybaragem request spec • http://rubydoc.info/github/jnicklas/capybara/ master • Capybara HTML
- 41. Capybara example feature "signingup" do background do User.create(:email => 'user@example.com', :password => 'caplin') end scenario "signing in with correct credentials" do visit "/" # or root_path click_link 'Log In' within("#session") do fill_in 'Login', :with => 'user@example.com' fill_in 'Password', :with => 'caplin' choose('some_select_option_yes') check('some_checkbox') end click_button 'Sign in' expect(User.count).to eq(1) # you can test model expect(page).to have_content 'Login successfuuly' # and/or test page end end find css selector xpath
- 42.
- 43. JavaScript Driver • Capybarajavascript • javascript_driver Ruby README • https://github.com/teampoltergeist/poltergeist PhantomJS • https://github.com/thoughtbot/capybara-webkit QtWebKit • https://rubygems.org/gems/selenium-webdriver Firefox • test js: true
- 44. JavaScript Driver • Browsertools Rails Ruby thread • DB transaction database cleaner • https://github.com/DatabaseCleaner/database_cleaner • https://github.com/amatsuda/database_rewinder • javascript ( Ajax) • Capybara 5 • Capybara.default_wait_time • using_wait_time(2) { …. } https://robots.thoughtbot.com/write-reliable-asynchronous-integration-tests-with-capybara
- 45. • Extract behaviorto helper methods • Page Object https://robots.thoughtbot.com/acceptance-tests-at-a-single-level-of- abstraction
- 46.
- 47.
- 48. (1) • Debugging ? •puts • https://tenderlovemaking.com/2016/02/05/i-am- a-puts-debuggerer.html • byebug • --only-failures option • https://relishapp.com/rspec/rspec-core/docs/ command-line/only-failures
- 49. (2) • Time.now ? •http://api.rubyonrails.org/classes/ ActiveSupport/Testing/TimeHelpers.html travel_to • config.include ActiveSupport::Testing::TimeHelpers • Timecop gem
- 50. (3) • email ? •mail = ActionMailer::Base.deliveries.last • config.before(:each) { ActionMailer::Base.deliveries.clear } • https://github.com/email-spec/email- spec/
- 51. (4) • ? • spec/fixtures/ •File.new(Rails.root + ‘spec/fixtures/ foobar.png') paperclip Photo.create(:description => "Test", :attachment => File.new(Rails.root + ‘spec/fixtures/ac_logo.png')) • feature spec capybara attach_file http://www.rubydoc.info/github/jnicklas/capybara/ master/Capybara%2FNode%2FActions%3Aattach_file
- 52. (5) • devise https://github.com/plataformatec/ deviseTest helpers config.include Devise::Test::ControllerHelpers, type: :controller config.include Devise::Test::ControllerHelpers, type: :view config.include Devise::Test::IntegrationHelpers, type: :feature
- 53. (6) • sidekiq ? •http://api.rubyonrails.org/classes/ ActiveJob/TestHelper.html#method-i- perform_enqueued_jobs • config.include ActiveJob::TestHelper • enqueue job perform_enqueued_jobs { … }
- 54. (7) • after_commit ? •unit test transaction after_commit • https://github.com/grosser/test_after_commit • database_cleanner truncation transaction • trigger • http://mytrile.github.io/blog/2013/03/28/testing-after- commit-in-rspec/ • Rails 5.0 workaround
- 55. (8) • rake ? •model class method • model spec
- 56. (9) • legacy ? •happy path feature spec C/P • Unit test • • Unit Test
- 57. (10) • ? • Testdouble (?) • CPU • https://github.com/grosser/parallel_tests • CI concurrent build
- 58. Tools • shoulda railsmatcher • database_cleaner DB • vcr HTTP response 3-party service • simplecov • cucumber • CI (continuous integration (CI)
- 59.
- 60.
- 61.
- 62.
- 63. CI • 3-party service •https://www.codeship.io • https://circleci.com/ • https://travis-ci.org/ • build your own • Jenkins
- 64.
- 65. Spec • Rspec spec • •Custom Matcher
- 66.
- 68. https://www.quora.com/What-is-the-best-way-to-test-the-web-application What is thebest way to test the web application?
- 69. Why? • low-level debug • high-level debug •view • developer QA
- 70. • bug failures trace • • (Mocks ) https://thoughtbot.com/upcase/videos/testing-antipatterns
- 71. Isolation • it Expectation • • onefailure one problem trace
- 72. describe "#amount" do it"should discount" do user.vip = true order.amount.should == 900 user.vip = false order.amount.should == 1000 end end
- 73. context describe "#amount" do context"when user is vip" do it "should discount ten percent" do user.vip = true order.amount.should == 900 end end context "when user is not vip" do it "should discount five percent" do user.vip = false order.amount.should == 1000 end end end
- 74.
- 75. Private methods class Order defamount if @user.vip? self.caculate_amount_for_vip else self.caculate_amount_for_non_vip end end private def caculate_amount_for_vip # ... end def caculate_amount_for_non_vip # ... end end
- 76. it "should discountfor vip" do @order.send(:caculate_amount_for_vip).should == 900 end it "should discount for non vip" do @order.send(:caculate_amount_for_vip).should == 1000 end
- 77. Private methods • public private/protectmethods • private • public • Public methods Private/Protected
- 78. describe User do describe'.search' do it 'searches Google for the given query' do HTTParty.should_receive(:get).with('http://www.google.com', :query => { :q => 'foo' } ).and_return([]) User.search query end end end HTTP
- 79. describe User do describe'.search' do it 'searches for the given query' do User.searcher = Searcher Searcher.should_receive(:search).with('foo').and_return([]) User.search query end end end
- 80. class User <ActiveRecord::Base class_attribute :searcher def self.search(query) searcher.search query end end class Searcher def self.search(keyword, options={}) HTTParty.get(keyword, options) end end
- 81.
- 83. TATFT test all thef**king time
- 85.
- 86.
- 87. DHH Way • 100%test coverage • Code-to-test 1:2 1:3 • 1/3 • Active Record associations, validations, or scopes. • ( Unit Test ) • Cucumber • Specification by Example • TDD (DHH 20% TDD) • Model DB Fixtures • Controller • Views system/browser testing https://signalvnoise.com/posts/3159-testing-like-the-tsa http://david.heinemeierhansson.com/2014/test-induced-design-damage.html
- 88.
- 89.
- 90.
- 91.
- 93.
- 94. Reference: • http://guides.rubyonrails.org/testing.html • https://github.com/eliotsykes/rspec-rails-examples#api-request-specs-docs-- helpers •The RSpec Book • The Rails 3 Way • Foundation Rails 2 • xUnit Test Patterns • everyday Rails Testing with RSpec • http://betterspecs.org/ • http://pure-rspec-rubynation.heroku.com/ • http://jamesmead.org/talks/2007-07-09-introduction-to-mock-objects-in-ruby-at-lrug/ • http://martinfowler.com/articles/mocksArentStubs.html • http://blog.rubybestpractices.com/posts/gregory/034-issue-5-testing-antipatterns.html • http://blog.carbonfive.com/2011/02/11/better-mocking-in-ruby/
- 95.