RSpec Best Friends @ TDC Florianópolis 2014

122
RSpec Best Friends

description

Nesta palestra veremos: - Boas práticas ao escrever testes utilizando o RSpec - Como escrever testes que acessam rede utilizando o VCR e o WebMock - Apresentando o factory_girl, comparando com as fixtures. E diversas dicas do factory_girl - Testes que dependem de data utilizando o timecop - Coverage de testes com o Simplecov e se devemos ou não atingir os 100% de cobertura de testes - Evitando repetições durante os testes utilizando de matchers

Transcript of RSpec Best Friends @ TDC Florianópolis 2014

Page 1: RSpec Best Friends @ TDC Florianópolis 2014

RSpec Best Friends

Page 2: RSpec Best Friends @ TDC Florianópolis 2014

Mauro quem...

Page 3: RSpec Best Friends @ TDC Florianópolis 2014
Page 4: RSpec Best Friends @ TDC Florianópolis 2014
Page 5: RSpec Best Friends @ TDC Florianópolis 2014
Page 6: RSpec Best Friends @ TDC Florianópolis 2014

RSpec Best Friends

Page 7: RSpec Best Friends @ TDC Florianópolis 2014

RSpec Best Friends

Page 8: RSpec Best Friends @ TDC Florianópolis 2014

maurogeorge.com.br

Page 9: RSpec Best Friends @ TDC Florianópolis 2014

RSpec

Page 10: RSpec Best Friends @ TDC Florianópolis 2014

sintaxe de expectativaRSpec

Page 11: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'exibe o nome e o id nacional' do pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) pokemon.nome_completo.should eq('Charizard - 6')end

Page 12: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'exibe o nome e o id nacional' do pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) expect(pokemon.nome_completo).to eq('Charizard - 6')end

Page 13: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it { expect(subject).to be_a(ActiveRecord::Base) }

Page 14: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it { should be_a(ActiveRecord::Base) }

Page 15: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it { is_expected.to be_a(ActiveRecord::Base) }

Somente RSpec 3

Page 16: RSpec Best Friends @ TDC Florianópolis 2014

spec/spec_helper.rb

RSpec.configure do |config| # ... config.expect_with :rspec do |c| c.syntax = :expect endend

Page 17: RSpec Best Friends @ TDC Florianópolis 2014

descrevendo melhor os testesRSpec

Page 18: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'exibe o nome e o id nacional' do pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) expect(pokemon.nome_completo).to eq('Charizard - 6')end

Page 19: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe '#nome_completo' do it 'exibe o nome e o id nacional' do pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) expect(pokemon.nome_completo).to eq('Charizard - 6') endend

Page 20: RSpec Best Friends @ TDC Florianópolis 2014

não teste apenas o happy pathRSpec

Page 21: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe '#nome_completo' do it 'exibe o nome e o id nacional' do pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) expect(pokemon.nome_completo).to eq('Charizard - 6') endend

Page 22: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe '#nome_completo' do it 'exibe o nome e o id nacional quando possui os valores' do pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) expect(pokemon.nome_completo).to eq('Charizard - 6') end

it 'é nil quando não possui o nome e o id nacional' do pokemon = Pokemon.new expect(pokemon.nome_completo).to be_nil endend

Page 23: RSpec Best Friends @ TDC Florianópolis 2014

contextos para a melhor descriçãoRSpec

Page 24: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe '#nome_completo' do context 'quando possui nome e o id nacional' do it 'exibe o nome e o id nacional' do # ... end end

context 'quando não possui o nome e o id nacional' do it 'é nil' do # ... end endend

Page 25: RSpec Best Friends @ TDC Florianópolis 2014

de!nindo o sujeitoRSpec

Page 26: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

context 'quando possui nome e o id nacional' do before do @pokemon = Pokemon.new(nome: 'Charizard', id_nacional: 6) end

it 'exibe o nome e o id nacional' do expect(@pokemon.nome_completo).to eq('Charizard - 6') endend

Page 27: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

context 'quando possui nome e o id nacional' do let(:pokemon) do Pokemon.new(nome: 'Charizard', id_nacional: 6) end

it 'exibe o nome e o id nacional' do expect(pokemon.nome_completo).to eq('Charizard - 6') endend

Page 28: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

context 'quando possui nome e o id nacional' do subject do Pokemon.new(nome: 'Charizard', id_nacional: 6) end

it 'exibe o nome e o id nacional' do expect(subject.nome_completo).to eq('Charizard - 6') endend

Page 29: RSpec Best Friends @ TDC Florianópolis 2014

utilize sempre os matchersRSpec

Page 30: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'é nil' do expect(subject.nome_completo).to eq(nil)end

Page 31: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'é nil' do expect(subject.nome_completo).to be_nilend

Page 32: RSpec Best Friends @ TDC Florianópolis 2014

não use shouldRSpec

Page 33: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'should have the name and the national_id' do expect(pokemon.full_name).to eq('Charizard - 6')end

Page 34: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

it 'does have the name and the national_id' do expect(pokemon.full_name).to eq('Charizard - 6')end

Page 35: RSpec Best Friends @ TDC Florianópolis 2014

ordem aleatória nos testesRSpec

Page 36: RSpec Best Friends @ TDC Florianópolis 2014

spec/spec_helper.rb

RSpec.configure do |config| # ... config.order = "random"end

Page 37: RSpec Best Friends @ TDC Florianópolis 2014

coding styleRSpec

Page 38: RSpec Best Friends @ TDC Florianópolis 2014

https://github.com/mongoid/mongoid

coding styleRSpec

Page 39: RSpec Best Friends @ TDC Florianópolis 2014

https://github.com/mongoid/mongoidhttps://github.com/bbatsov/ruby-style-guide

coding styleRSpec

Page 41: RSpec Best Friends @ TDC Florianópolis 2014

Testes que acessam rede

Page 42: RSpec Best Friends @ TDC Florianópolis 2014

introduçãoTestes que acessam rede

Page 43: RSpec Best Friends @ TDC Florianópolis 2014

Testes lentos

introduçãoTestes que acessam rede

Page 44: RSpec Best Friends @ TDC Florianópolis 2014

Testes lentosTestes quebradiços

introduçãoTestes que acessam rede

Page 45: RSpec Best Friends @ TDC Florianópolis 2014

Testes lentosTestes quebradiços

Não poder testar sem rede

introduçãoTestes que acessam rede

Page 46: RSpec Best Friends @ TDC Florianópolis 2014

app/services/criador_pokemon.rb

class CriadorPokemon# ...def criar Pokemon.create(nome: nome)end

private # ... def cria_info resposta = Net::HTTP.get(endpoint) @info = JSON.parse(resposta) endend

Page 47: RSpec Best Friends @ TDC Florianópolis 2014

spec/services/criador_pokemon_spec.rb

describe 'pokemon criado' do before do criador_pokemon.criar end

subject do Pokemon.last end

it 'possui o nome correto' do expect(subject.nome).to eq('Charizard') endend

Page 48: RSpec Best Friends @ TDC Florianópolis 2014

webmockTestes que acessam rede

Page 49: RSpec Best Friends @ TDC Florianópolis 2014

webmock: feedback rápidoTestes que acessam rede

Page 50: RSpec Best Friends @ TDC Florianópolis 2014

bash

Failure/Error: CriadorPokemon.new(6) WebMock::NetConnectNotAllowedError: Real HTTP connections are disabled. Unregistered request: GET http://pokeapi.co/api/v1/pokemon/6/ with headers {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'Host'=>'pokeapi.co', 'User-Agent'=>'Ruby'}

You can stub this request with the following snippet:

stub_request(:get, "http://pokeapi.co/api/v1/pokemon/6/"). with(:headers => {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'Host'=>'pokeapi.co', 'User-Agent'=>'Ruby'}).to_return(:status => 200, :body => "", :headers => {})

Page 51: RSpec Best Friends @ TDC Florianópolis 2014

webmock: forjando a respostaTestes que acessam rede

Page 52: RSpec Best Friends @ TDC Florianópolis 2014

spec/services/criador_pokemon_spec.rb

describe 'pokemon criado' do

before do body = '{' \ ' "name": "Charizard"' \ '}' stub_request(:get, 'http://pokeapi.co/api/v1/pokemon/6/') .to_return(status: 200, body: body, headers: {}) criador_pokemon.criar endend

Page 53: RSpec Best Friends @ TDC Florianópolis 2014

webmock: forjando com cURLTestes que acessam rede

Page 54: RSpec Best Friends @ TDC Florianópolis 2014

bash

$ curl -is http://pokeapi.co/api/v1/pokemon/6/ > \spec/fixtures/services/criador_pokemon/resposta.txt

Page 55: RSpec Best Friends @ TDC Florianópolis 2014

spec/services/criador_pokemon_spec.rb

describe 'pokemon criado' do

before do caminho_arquivo = 'spec/fixtures/services/criador_pokemon/resposta.txt' arquivo_resposta = File.new(caminho_arquivo) stub_request(:get, 'http://pokeapi.co/api/v1/pokemon/6/') .to_return(arquivo_resposta) criador_pokemon.criar endend

Page 56: RSpec Best Friends @ TDC Florianópolis 2014

vcrTestes que acessam rede

Page 57: RSpec Best Friends @ TDC Florianópolis 2014

vcr: con!guraçãoTestes que acessam rede

Page 58: RSpec Best Friends @ TDC Florianópolis 2014

spec/support/vcr.rb

VCR.configure do |c| c.cassette_library_dir = 'spec/fixtures/vcr_cassettes' c.hook_into :webmockend

Page 59: RSpec Best Friends @ TDC Florianópolis 2014

vcr: feedback rápidoTestes que acessam rede

Page 60: RSpec Best Friends @ TDC Florianópolis 2014

bash

Failure/Error: CriadorPokemon.new(6)VCR::Errors::UnhandledHTTPRequestError:

===================================================================== An HTTP request has been made that VCR does not know how to handle: GET http://pokeapi.co/api/v1/pokemon/6/

There is currently no cassette in use. There are a few ways you can configure VCR to handle this request:

...

Page 61: RSpec Best Friends @ TDC Florianópolis 2014

vcr: forjando a respostaTestes que acessam rede

Page 62: RSpec Best Friends @ TDC Florianópolis 2014

spec/services/criador_pokemon_spec.rb

describe 'pokemon criado' do before do VCR.use_cassette('CriadorPokemon/criar') do criador_pokemon.criar end end

#...

it 'possui o nome correto' do expect(subject.nome).to eq('Charizard') endend

Page 63: RSpec Best Friends @ TDC Florianópolis 2014

vcr: RSpec metadataTestes que acessam rede

Page 64: RSpec Best Friends @ TDC Florianópolis 2014

spec/support/vcr.rb

VCR.configure do |c|

# ... c.configure_rspec_metadata!end

spec/spec_helper.rb

RSpec.configure do |config|

# ... config.treat_symbols_as_metadata_keys_with_true_values = trueend

Page 65: RSpec Best Friends @ TDC Florianópolis 2014

spec/services/criador_pokemon_spec.rb

describe 'pokemon criado', :vcr do before do criador_pokemon.criar end

#...

it 'possui o nome correto' do expect(subject.nome).to eq('Charizard') endend

Page 66: RSpec Best Friends @ TDC Florianópolis 2014

factory_girl

Page 67: RSpec Best Friends @ TDC Florianópolis 2014

!xtures X factoriesfactory_girl

Page 68: RSpec Best Friends @ TDC Florianópolis 2014

criando uma factoryfactory_girl

Page 69: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/usuarios.rb

FactoryGirl.define do factory :usuario do nome 'Mauro' email '[email protected]' endend

Page 70: RSpec Best Friends @ TDC Florianópolis 2014

console rails

FactoryGirl.create(:usuario)FactoryGirl.create(:usuario, email: '[email protected]')

Page 71: RSpec Best Friends @ TDC Florianópolis 2014

con!gurandofactory_girl

Page 72: RSpec Best Friends @ TDC Florianópolis 2014

spec/spec_helper.rb

RSpec.configure do |config| # ... config.include FactoryGirl::Syntax::Methodsend

Em um teste qualquer

let!(:artigo) do create(:artigo)end

Page 73: RSpec Best Friends @ TDC Florianópolis 2014

attributes_forfactory_girl

Page 74: RSpec Best Friends @ TDC Florianópolis 2014

spec/controllers/posts_controller_spec.rb

describe "POST 'create'" do let(:params) do { artigo: { titulo: 'Meu titulo', conteudo: 'Conteudo do artigo' } } endend

Page 75: RSpec Best Friends @ TDC Florianópolis 2014

spec/controllers/posts_controller_spec.rb

describe "POST 'create'" do let(:params) do { artigo: attributes_for(:artigo) } endend

Page 76: RSpec Best Friends @ TDC Florianópolis 2014

herançafactory_girl

Page 77: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/artigos.rb

factory :artigo do titulo 'Diversas dicas do RSpec' conteudo 'Conteúdo de Diversas dicas do RSpec'

factory :artigo_aprovado do aprovado true end

factory :artigo_nao_aprovado do aprovado false endend

Page 78: RSpec Best Friends @ TDC Florianópolis 2014

console rails

FactoryGirl.create(:artigo_aprovado)FactoryGirl.create(:artigo_nao_aprovado)

Page 79: RSpec Best Friends @ TDC Florianópolis 2014

traitsfactory_girl

Page 80: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/artigos.rb

factory :artigo do titulo 'Diversas dicas do RSpec' conteudo 'Conteúdo de Diversas dicas do RSpec'

trait :aprovado do aprovado true end

trait :nao_aprovado do aprovado false endend

Page 81: RSpec Best Friends @ TDC Florianópolis 2014

console rails

FactoryGirl.create(:artigo, :aprovado)FactoryGirl.create(:artigo, :nao_aprovado)

Page 82: RSpec Best Friends @ TDC Florianópolis 2014

dependent attributesfactory_girl

Page 83: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/artigos.rb

factory :artigo do titulo 'Diversas dicas do RSpec' conteudo { "Conteúdo do artigo #{titulo}. Aprovado: #{aprovado}" }end

Page 84: RSpec Best Friends @ TDC Florianópolis 2014

sequencefactory_girl

Page 85: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/artigos.rb

factory :artigo do sequence(:titulo) { |n| "Diversas dicas do RSpec #{n}" } conteudo { "Conteúdo do artigo #{titulo}. Aprovado: #{aprovado}" }end

Page 86: RSpec Best Friends @ TDC Florianópolis 2014

associaçõesfactory_girl

Page 87: RSpec Best Friends @ TDC Florianópolis 2014

console rails

usuario = FactoryGirl.create(:usuario)FactoryGirl.create(:artigo, usuario: usuario)

Page 88: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/artigos.rb

factory :artigo do titulo 'Diversas dicas do RSpec' conteudo { "Conteúdo do artigo #{titulo}. Aprovado: #{aprovado}" } usuarioend

Page 89: RSpec Best Friends @ TDC Florianópolis 2014

aliasesfactory_girl

Page 90: RSpec Best Friends @ TDC Florianópolis 2014

spec/factories/artigos.rb

factory :usuario, aliases: [:autor] do nome 'Mauro' email { "#{nome}@helabs.com.br" }end

Page 91: RSpec Best Friends @ TDC Florianópolis 2014

strategiesfactory_girl

Page 92: RSpec Best Friends @ TDC Florianópolis 2014

console rails

pokemon = FactoryGirl.build(:pokemon)

Page 93: RSpec Best Friends @ TDC Florianópolis 2014

console rails

pokemon = FactoryGirl.build_stubbed(:pokemon)

Page 94: RSpec Best Friends @ TDC Florianópolis 2014

lintfactory_girl

Page 95: RSpec Best Friends @ TDC Florianópolis 2014

spec/support/factory_girl.rb

RSpec.configure do |config|

config.before(:suite) do begin DatabaseCleaner.start FactoryGirl.lint ensure DatabaseCleaner.clean end endend

Page 96: RSpec Best Friends @ TDC Florianópolis 2014

timecop

Page 97: RSpec Best Friends @ TDC Florianópolis 2014

app/models/pokemon.rb

class Pokemon < ActiveRecord::Base

scope :escolhidos_ontem, -> do where(escolhido_em: 1.day.ago.midnight..Time.zone.now.midnight) endend

Page 98: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe '.escolhidos_ontem' do let!(:pokemon_escolhido_ontem) do create(:pokemon, escolhido_em: Time.zone.local(2014, 5, 16, 10, 45)) end

subject do Pokemon.escolhidos_ontem end

it 'tem o pokemon escolhido ontem' do expect(subject).to include(pokemon_escolhido_ontem) endend

Page 99: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe '.escolhidos_ontem' do

# ...

it 'tem o pokemon escolhido ontem' do Timecop.freeze(Time.zone.local((2014, 5, 17, 10, 45)) do expect(subject).to include(pokemon_escolhido_ontem) end endend

Page 100: RSpec Best Friends @ TDC Florianópolis 2014

simplecov

Page 101: RSpec Best Friends @ TDC Florianópolis 2014

veri!cando a coberturasimplecov

Page 102: RSpec Best Friends @ TDC Florianópolis 2014

spec/spec_helper.rb

require 'simplecov'SimpleCov.start 'rails'

Primeira linha do spec_helper.rb

Page 103: RSpec Best Friends @ TDC Florianópolis 2014
Page 104: RSpec Best Friends @ TDC Florianópolis 2014
Page 105: RSpec Best Friends @ TDC Florianópolis 2014

O falso 100%simplecov

Page 106: RSpec Best Friends @ TDC Florianópolis 2014

app/models/pokemon.rb

class Pokemon < ActiveRecord::Base

validates :nome, :id_nacional, presence: true scope :escolhidos_ontem, -> do where(escolhido_em: 1.day.ago.midnight..Time.zone.now.midnight) endend

Page 107: RSpec Best Friends @ TDC Florianópolis 2014

Não teste associações, validações ou escopos do Active Record

simplecov

Page 108: RSpec Best Friends @ TDC Florianópolis 2014

teste associações, validações e escopos do Active Record

simplecov

Page 109: RSpec Best Friends @ TDC Florianópolis 2014

devo ter 100% de cobertura de testes?simplecov

Page 110: RSpec Best Friends @ TDC Florianópolis 2014

shoulda-matchers

Page 111: RSpec Best Friends @ TDC Florianópolis 2014

app/models/pokemon.rb

class Pokemon < ActiveRecord::Base

validates :nome, :id_nacional, presence: true validates :id_nacional, numericality: { only_integer: true, greater_than: 0 }end

Page 112: RSpec Best Friends @ TDC Florianópolis 2014

spec/models/pokemon_spec.rb

describe 'validações' do

it { should validate_presence_of(:nome) } it { should validate_presence_of(:id_nacional) } it { should validate_numericality_of(:id_nacional).only_integer .is_greater_than(0) }end

Page 113: RSpec Best Friends @ TDC Florianópolis 2014

os matchersshoulda-matchers

Page 114: RSpec Best Friends @ TDC Florianópolis 2014

ActiveModel

os matchersshoulda-matchers

Page 115: RSpec Best Friends @ TDC Florianópolis 2014

ActiveModelActiveRecord

os matchersshoulda-matchers

Page 116: RSpec Best Friends @ TDC Florianópolis 2014

ActiveModelActiveRecord

ActionController

os matchersshoulda-matchers

Page 117: RSpec Best Friends @ TDC Florianópolis 2014

além do shoulda-matchersshoulda-matchers

Page 118: RSpec Best Friends @ TDC Florianópolis 2014

https://github.com/bmabey/email-spec

além do shoulda-matchersshoulda-matchers

Page 119: RSpec Best Friends @ TDC Florianópolis 2014

https://github.com/bmabey/email-spechttps://github.com/philostler/rspec-sidekiq

além do shoulda-matchersshoulda-matchers

Page 120: RSpec Best Friends @ TDC Florianópolis 2014

https://github.com/bmabey/email-spechttps://github.com/philostler/rspec-sidekiq

https://github.com/evansagge/mongoid-rspec

além do shoulda-matchersshoulda-matchers

Page 121: RSpec Best Friends @ TDC Florianópolis 2014

Obrigado!

Page 122: RSpec Best Friends @ TDC Florianópolis 2014

maurogeorge.com.br