!["goals":[
{
"per":"1",
"ta":"CGY",
"et":"14:11",
"st":"Wrist Shot"
},
{
"per":"2",
"ta":"ANA",
"et":"11:12",
"st":"Backhand"
}
]
"goals": {
"per":"1",
"ta":"CGY",
"et":"14:11",
"st":"Wrist Shot"
}](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-19-320.jpg)
![ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../../config/environment', __FILE__)
require 'rspec/autorun'
require 'rspec/rails’
Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration)
RSpec.configure do |config|
config.infer_base_class_for_anonymous_controllers = false
config.order = 'random’
end
WebMock.disable_net_connect!
spec/spec_helper.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-35-320.jpg)
![module FacebookWrapper
def self.user_id(username)
user_data(username)['id']
end
def self.user_data(username)
JSON.parse(
open("https://graph.facebook.com/#{username}").read
)
end
end
lib/facebook_wrapper.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-37-320.jpg)
![ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../../config/environment', __FILE__)
require 'rspec/autorun'
require 'rspec/rails’
require 'fb_graph/mock'
Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration)
RSpec.configure do |config|
config.infer_base_class_for_anonymous_controllers = false
config.order = 'random'
config.include FbGraph::Mock
end
WebMock.disable_net_connect!
spec/spec_helper.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-46-320.jpg)
![ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../../config/environment', __FILE__)
require 'rspec/autorun'
require 'rspec/rails’
Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration)
RSpec.configure do |config|
config.infer_base_class_for_anonymous_controllers = false
config.order = 'random’
end
WebMock.disable_net_connect!
spec/spec_helper.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-52-320.jpg)
![ShamRack.at('graph.facebook.com', 443).sinatra do
get '/:username' do
%Q|{
"id": "7901103",
"name": "Arjun Banker",
"first_name": "Arjun",
"last_name": "Banker",
"link": "http://www.facebook.com/#{params[:username]}",
"location": {
"id": 114952118516947,
"name": "San Francisco, California"
},
"gender": "male"
}|
end
end
spec/support/fake_facebook.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-53-320.jpg)
![ShamRack.at('graph.facebook.com', 443).sinatra do
get '/:username' do
%Q|{
"id": "7901103",
"name": "Arjun Banker",
"first_name": "Arjun",
"last_name": "Banker",
"link": "http://www.facebook.com/#{params[:username]}",
"location": {
"id": 114952118516947,
"name": "San Francisco, California"
},
"gender": "male"
}|
end
end
spec/support/fake_facebook.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-54-320.jpg)
![ShamRack.at('graph.facebook.com', 443).sinatra do
get '/:username' do
%Q|{
"id": "7901103",
"name": "Arjun Banker",
"first_name": "Arjun",
"last_name": "Banker",
"link": "http://www.facebook.com/#{params[:username]}",
"location": {
"id": 114952118516947,
"name": "San Francisco, California"
},
"gender": "male"
}|
end
end
spec/support/fake_facebook.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-55-320.jpg)
![ShamRack.at('graph.facebook.com', 443).sinatra do
get '/:username' do
%Q|{
"id": "7901103",
"name": "Arjun Banker",
"first_name": "Arjun",
"last_name": "Banker",
"link": "http://www.facebook.com/#{params[:username]}",
"location": {
"id": 114952118516947,
"name": "San Francisco, California"
},
"gender": "male"
}|
end
end
spec/support/fake_facebook.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-56-320.jpg)
![ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../../config/environment', __FILE__)
require 'rspec/autorun'
require 'rspec/rails’
Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration)
RSpec.configure do |config|
config.infer_base_class_for_anonymous_controllers = false
config.order = 'random’
end
WebMock.disable_net_connect!
VCR.configure do |c|
c.cassette_library_dir = 'spec/fixtures/vcr_cassettes'
c.hook_into :webmock
end
spec/spec_helper.rb](https://image.slidesharecdn.com/railsconfgoodversion-140424182118-phpapp02/85/Effectively-Testing-Services-on-Rails-Railsconf-2014-60-320.jpg)
Effectively Testing Services on Rails - Railsconf 2014
- 2. $ whoami Iowa native Now: Californian Software Developer Independent Consultant
- 3. What I Do Ruby / Rails Javascript / Angular HTML, CSS, etc
- 7. … and because I don’t want @dhh to rage
- 8. what
- 9. What is a service? Internal “SOA”
- 10. Any time you make an HTTP request to an endpoint in another repository
- 11. why
- 12. Why are services important? Build faster Makes scaling easier Use them on virtually every application Increasingly prevalent
- 13. Services are critical to modern Rails development
- 14. Why is testing services important? You (should) test everything else Services compose crucial features You may encounter problems…
- 15. Internal API Sometimes null responses Inconsistencies Catastrophe
- 16. Okay? But what about external APIs?
- 20. No versioning!
- 22. Snapchat Client Haphazard documentation What are the requests? Bizarre obfuscation github.com/nneal/snapcat
- 23. how
- 24. What is different about services? External network requests You don’t own the code
- 26. On an airplane… Failure is bad! No network requests
- 27. Don’t interact with services from test environment* **
- 28. * Includes “dummy” APIs
- 29. ** Using pre-recorded responses is okay
- 31. Timetostub!
- 33. Simplify.
- 34. gem 'webmock'
- 35. ENV['RAILS_ENV'] ||= 'test' require File.expand_path('../../config/environment', __FILE__) require 'rspec/autorun' require 'rspec/rails’ Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f } ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration) RSpec.configure do |config| config.infer_base_class_for_anonymous_controllers = false config.order = 'random’ end WebMock.disable_net_connect! spec/spec_helper.rb
- 37. module FacebookWrapper def self.user_id(username) user_data(username)['id'] end def self.user_data(username) JSON.parse( open("https://graph.facebook.com/#{username}").read ) end end lib/facebook_wrapper.rb
- 39. require 'spec_helper' describe FacebookWrapper, '.user_link' do it 'retrieves user link' do stub_request(:get, 'https://graph.facebook.com/arjun'). to_return( status: 200, headers: {}, body: '{ "id": "7901103","first_name": "Arjun", "locale": "en_US","username": "Arjun" }' ) user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end spec/lib/facebook_wrapper_spec.rb
- 40. require 'spec_helper' describe FacebookWrapper, '.user_link' do it 'retrieves user link' do stub_request(:get, 'https://graph.facebook.com/arjun'). to_return( status: 200, headers: {}, body: '{ "id": "7901103","first_name": "Arjun", "locale": "en_US","username": "Arjun" }' ) user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end spec/lib/facebook_wrapper_spec.rb
- 41. require 'spec_helper' describe FacebookWrapper, '.user_link' do it 'retrieves user link' do stub_request(:get, 'https://graph.facebook.com/arjun'). to_return( status: 200, headers: {}, body: '{ "id": "7901103","first_name": "Arjun", "locale": "en_US","username": "Arjun" }' ) user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end spec/lib/facebook_wrapper_spec.rb
- 42. require 'spec_helper' describe FacebookWrapper, '.user_link' do it 'retrieves user link' do stub_request(:get, 'https://graph.facebook.com/arjun'). to_return( status: 200, headers: {}, body: '{ "id": "7901103","first_name": "Arjun", "locale": "en_US","username": "Arjun" }' ) user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end spec/lib/facebook_wrapper_spec.rb
- 43. Even Better No network requests Fast! No intermittent failure
- 46. ENV['RAILS_ENV'] ||= 'test' require File.expand_path('../../config/environment', __FILE__) require 'rspec/autorun' require 'rspec/rails’ require 'fb_graph/mock' Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f } ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration) RSpec.configure do |config| config.infer_base_class_for_anonymous_controllers = false config.order = 'random' config.include FbGraph::Mock end WebMock.disable_net_connect! spec/spec_helper.rb
- 47. describe FacebookWrapper, '.user_link' do it 'retrieves user link' do mock_graph :get, 'arjun', 'users/arjun_public' do user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end end spec/lib/facebook_wrapper_spec.rb
- 48. describe FacebookWrapper, '.user_link' do it 'retrieves user link' do mock_graph :get, 'arjun', 'users/arjun_public' do user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end end spec/lib/facebook_wrapper_spec.rb
- 49. Even Better Already stubbed for you Pre-recorded responses (sometimes) Don’t need to know API endpoints
- 50. gem 'sham_rack'
- 51. gem 'sinatra'
- 52. ENV['RAILS_ENV'] ||= 'test' require File.expand_path('../../config/environment', __FILE__) require 'rspec/autorun' require 'rspec/rails’ Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f } ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration) RSpec.configure do |config| config.infer_base_class_for_anonymous_controllers = false config.order = 'random’ end WebMock.disable_net_connect! spec/spec_helper.rb
- 53. ShamRack.at('graph.facebook.com', 443).sinatra do get '/:username' do %Q|{ "id": "7901103", "name": "Arjun Banker", "first_name": "Arjun", "last_name": "Banker", "link": "http://www.facebook.com/#{params[:username]}", "location": { "id": 114952118516947, "name": "San Francisco, California" }, "gender": "male" }| end end spec/support/fake_facebook.rb
- 54. ShamRack.at('graph.facebook.com', 443).sinatra do get '/:username' do %Q|{ "id": "7901103", "name": "Arjun Banker", "first_name": "Arjun", "last_name": "Banker", "link": "http://www.facebook.com/#{params[:username]}", "location": { "id": 114952118516947, "name": "San Francisco, California" }, "gender": "male" }| end end spec/support/fake_facebook.rb
- 55. ShamRack.at('graph.facebook.com', 443).sinatra do get '/:username' do %Q|{ "id": "7901103", "name": "Arjun Banker", "first_name": "Arjun", "last_name": "Banker", "link": "http://www.facebook.com/#{params[:username]}", "location": { "id": 114952118516947, "name": "San Francisco, California" }, "gender": "male" }| end end spec/support/fake_facebook.rb
- 56. ShamRack.at('graph.facebook.com', 443).sinatra do get '/:username' do %Q|{ "id": "7901103", "name": "Arjun Banker", "first_name": "Arjun", "last_name": "Banker", "link": "http://www.facebook.com/#{params[:username]}", "location": { "id": 114952118516947, "name": "San Francisco, California" }, "gender": "male" }| end end spec/support/fake_facebook.rb
- 57. describe FacebookWrapper, '.user_link' do it 'retrieves user link' do user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103’ end end spec/lib/facebook_wrapper_spec.rb
- 59. gem 'vcr'
- 60. ENV['RAILS_ENV'] ||= 'test' require File.expand_path('../../config/environment', __FILE__) require 'rspec/autorun' require 'rspec/rails’ Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f } ActiveRecord::Migration.check_pending! if defined?(ActiveRecord::Migration) RSpec.configure do |config| config.infer_base_class_for_anonymous_controllers = false config.order = 'random’ end WebMock.disable_net_connect! VCR.configure do |c| c.cassette_library_dir = 'spec/fixtures/vcr_cassettes' c.hook_into :webmock end spec/spec_helper.rb
- 61. describe FacebookWrapper, '.user_link' do it 'retrieves user link' do VCR.use_cassette('fb_user_arjun') do user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end end spec/lib/facebook_wrapper_spec.rb
- 62. describe FacebookWrapper, '.user_link' do it 'retrieves user link' do VCR.use_cassette('fb_user_arjun') do user_id = FacebookWrapper.user_id('arjun') expect(user_id).to eq '7901103' end end end spec/lib/facebook_wrapper_spec.rb
- 63. Even Better Record API automatically Replay responses without network Verify responses
- 64. Additional Build Process Runs outside normal test mode Rechecks cassettes for diffs Avoids versioning issues
- 66. Puffing-Billy Built for in-browser requests Allowed to record and reuse (like VCR)
- 67. Be brave, venture out of ruby
- 68. I also like…
- 69. Chrome Dev Tools
- 70. Postman
- 71. HTTPie
- 72. Charles
- 74. Bringing it all together Testing services is crucial If in doubt, stub it out Determine the flexibility you want Record responses to save time
- 75. Next Up Eliminating Inconsistent Test Failures with Austin Putman
- 76. Thank you! [email protected] (I like emails) @neal_kemp (I tweet)
Editor's Notes
- #11: Includes: things like Stripe, or an internal API, or an iPhone app calling into an API exposed by your rails app
- #22: LA kings checkingchicagoblackhawks
- #44: Can back with yaml
- #50: Can back with yaml
- #59: Can back with yaml
- #64: Can back with yaml
- #66: Re-writing web proxyAllowed to record and reuse (like VCR)
- #67: Can back with yaml
- #70: Ubiquitous PowerfulIn-browser (so easy!)
- #71: Easily send requestsEasy-to-use GUI
- #72: Postman without the GUICould run small scripts around it
- #73: re-writing web proxyTest mobile as well as desktopGood for collecting a lot of responsesGood for testing things that aren’t specific page loads in ChromeGood when you don’t know what’s even being requested!